Struct Http3ProductionProfile 

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.

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

impl Http3ProductionProfile

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.

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.

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.

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.

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.

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.

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"));

Panics

This function does not panic.

Trait Implementations

impl Clone for Http3ProductionProfile

fn clone(&self) -> Http3ProductionProfile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Http3ProductionProfile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Http3ProductionProfile

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Http3ProductionProfile

impl PartialEq for Http3ProductionProfile

fn eq(&self, other: &Http3ProductionProfile) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Http3ProductionProfile