Struct HttpServerBuilder 

pub struct HttpServerBuilder { /* private fields */ }

Builder for HttpServer.

Implementations

impl HttpServerBuilder

pub fn new(config: HttpServerConfig, cancel: CancellationToken) -> Self

Create a new builder.

pub fn with_router(self, router: Router) -> Self

Merge an axum Router into the server.

pub fn with_middleware_stack(self, middleware: HttpMiddlewareStack) -> Self

Replace the ordered middleware stack.

pub fn with_logging_transform<F>(self, transform: F) -> Self

where F: Fn(Router) -> Router + Send + Sync + 'static,

Append a logging-phase transform.

pub fn with_auth_transform<F>(self, transform: F) -> Self

where F: Fn(Router) -> Router + Send + Sync + 'static,

Append an auth-phase transform.

pub fn with_validation_transform<F>(self, transform: F) -> Self

where F: Fn(Router) -> Router + Send + Sync + 'static,

Append a validation-phase transform.

pub fn with_metrics_transform<F>(self, transform: F) -> Self

where F: Fn(Router) -> Router + Send + Sync + 'static,

Append a metrics-phase transform.

pub fn with_cors(self) -> AppResult<Self>

Apply CORS from the server config (no-op if cors is None).

Errors

Returns an error when the configured CORS policy contains invalid origins, methods, headers, or max-age values.

pub fn with_request_id(self) -> Self

Add automatic X-Request-Id injection.

pub fn with_security_headers(self) -> AppResult<Self>

Add secure response headers using the default security policy.

Errors

Returns an error if the default security policy cannot be built (should never happen in practice — this is a programming error guard).

pub fn with_security_headers_config( self, config: SecurityHeadersConfig, ) -> AppResult<Self>

Add secure response headers using an explicit security policy.

Errors

Returns an error when the supplied policy is invalid.

pub fn with_tracing(self) -> Self

Add the canonical tracing phase.

Tracing is owned by build so this remains a compatibility no-op.

pub fn build(self) -> AppResult<HttpServer>

Consume the builder and produce an HttpServer.

Errors

Returns an error when baseline transport middleware configuration is invalid.

pub fn with_body_limit(self) -> Self

Add the configured request body limit.

pub fn with_timeout(self) -> Self

Add the configured request timeout.