Struct Http3ProductionProfile

Source

pub struct Http3ProductionProfile {
    pub enabled: bool,
    pub alpn_order: Vec<String>,
    pub quic_idle_timeout_ms: u64,
    pub quic_preset: QuicTuningPreset,
    pub allow_h3_draft: bool,
    pub fallback_on_h3_error: bool,
}

Available on crate feature http3-profile only.

Expand description

Production-focused HTTP/3 configuration profile.

§Examples

use http_handle::http3_profile::Http3ProductionProfile;
let p = Http3ProductionProfile::default();
assert!(p.enabled);

§Panics

This type does not panic.

Fields§

§enabled: bool

Whether HTTP/3 is enabled.

§alpn_order: Vec<String>

Ordered ALPN preference, e.g. ["h3", "h2", "http/1.1"].

§quic_idle_timeout_ms: u64

QUIC idle timeout in milliseconds.

§quic_preset: QuicTuningPreset

QUIC tuning preset.

§allow_h3_draft: bool

Accept draft h3 tokens (for example h3-29) as h3 route.

§fallback_on_h3_error: bool

Whether failed HTTP/3 handshakes should fallback to H2/H1.

Implementations§

Source §

impl Http3ProductionProfile

Source

pub fn production_baseline() -> Self

Returns a strict production baseline with h3-first ALPN ordering.

§Examples

use http_handle::http3_profile::Http3ProductionProfile;
let p = Http3ProductionProfile::production_baseline();
assert!(p.enabled);

§Panics

This function does not panic.

Source

pub fn quic_tuning(&self) -> QuicTuning

Returns effective QUIC tuning values from preset and profile.

§Examples

use http_handle::http3_profile::Http3ProductionProfile;
let p = Http3ProductionProfile::default();
let t = p.quic_tuning();
assert!(t.idle_timeout_ms > 0);

§Panics

This function does not panic.

Source

pub fn route_for_alpn(&self, negotiated_alpn: Option<&[u8]>) -> ProtocolRoute

Derives the serving route from negotiated ALPN protocol bytes.

§Examples

use http_handle::http3_profile::{Http3ProductionProfile, ProtocolRoute};
let p = Http3ProductionProfile::default();
assert_eq!(p.route_for_alpn(Some(b"h3")), ProtocolRoute::Http3);

§Panics

This function does not panic.

Source

pub fn route_for_client_alpns( &self, client_offered_alpns: &[Vec<u8>], ) -> ProtocolRoute

Selects a route from offered client ALPN tokens and server preference.

§Examples

use http_handle::http3_profile::{Http3ProductionProfile, ProtocolRoute};
let p = Http3ProductionProfile::default();
let offered = vec![b"h2".to_vec()];
assert_eq!(p.route_for_client_alpns(&offered), ProtocolRoute::Http2);

§Panics

This function does not panic.

Source

pub fn fallback_chain(&self) -> Vec<ProtocolRoute>

Returns ordered protocol fallback chain.

§Examples

use http_handle::http3_profile::Http3ProductionProfile;
let p = Http3ProductionProfile::default();
assert!(!p.fallback_chain().is_empty());

§Panics

This function does not panic.

Source

pub fn resolve_route( &self, negotiated_alpn: Option<&[u8]>, h3_handshake_ok: bool, ) -> RouteDecision

Resolves final route with explicit fallback decision tree and reason.

§Examples

use http_handle::http3_profile::{Http3ProductionProfile, RouteReason};
let p = Http3ProductionProfile::default();
let d = p.resolve_route(Some(b"h3"), false);
assert!(matches!(d.reason, RouteReason::H3HandshakeFailedFallback));

§Panics

This function does not panic.

Source

pub fn telemetry_line(&self, decision: &RouteDecision) -> String

Serializes a compact fallback telemetry line for logs.

§Examples

use http_handle::http3_profile::{Http3ProductionProfile, RouteDecision, RouteReason, ProtocolRoute};
let p = Http3ProductionProfile::default();
let d = RouteDecision { selected: ProtocolRoute::Http2, reason: RouteReason::Negotiated, negotiated_alpn: Some("h2".into()), fallback_chain: vec![ProtocolRoute::Http3, ProtocolRoute::Http2] };
let line = p.telemetry_line(&d);
assert!(line.contains("http3.route"));