Struct HttpOptions 

pub struct HttpOptions {
    pub request_timeout: Duration,
    pub body_size_limit: usize,
    pub concurrency_limit: usize,
    pub allow_credentials: bool,
    /* private fields */
}

Configuration for the shared HTTP layer stack.

CORS denies cross-origin access until explicit origins are supplied through HttpOptions::with_allowed_origins. Wildcard origins are rejected, which also prevents the invalid wildcard-with-credentials combination.

Fields

request_timeout: Duration

Maximum time allowed for one request, including concurrency queueing.

body_size_limit: usize

Maximum accepted request body size in bytes.

concurrency_limit: usize

Maximum number of requests processed concurrently.

allow_credentials: bool

Whether browsers may send credentials to explicitly allowed origins.

Implementations

impl HttpOptions

pub fn with_allowed_origins<I, S>( self, origins: I, ) -> Result<Self, HttpOptionsError>

where I: IntoIterator<Item = S>, S: AsRef<str>,

Replaces the CORS origin allowlist.

Each origin must be a valid HTTP header value and must not be *.

pub fn allowed_origins(&self) -> &[HeaderValue]

Returns the explicit CORS origin allowlist.

pub fn with_additional_allowed_headers<I, S>( self, headers: I, ) -> Result<Self, HttpOptionsError>

where I: IntoIterator<Item = S>, S: AsRef<str>,

Adds request headers to the standard CORS allowlist.

The built-in Authorization, Content-Type, x-request-id, traceparent, and tracestate headers remain allowed. Duplicate header names are ignored.

pub fn additional_allowed_headers(&self) -> &[HeaderName]

Returns the request headers added to the standard CORS allowlist.

pub fn with_json_rejection_code( self, code: impl Into<String>, ) -> Result<Self, HttpOptionsError>

Overrides the error code returned when crate::ApiJson rejects a body.

The default is validation_failed. The replacement must be a non-empty snake_case identifier.

pub fn json_rejection_code(&self) -> &str

Returns the error code used for JSON extractor rejections.

pub fn from_config(config: &HttpConfig) -> Result<Self, HttpOptionsError>

Builds options from Baukit’s standard public-listener configuration.

Listener address and port are intentionally ignored because they belong to runtime composition rather than an Axum layer.

Trait Implementations

impl Clone for HttpOptions

fn clone(&self) -> HttpOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpOptions

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

Formats the value using the given formatter.

impl Default for HttpOptions

fn default() -> Self

Returns the “default value” for a type.