Struct ServerBuilder 

pub struct ServerBuilder { /* private fields */ }

Builds a Server with optional policy and timeout configuration.

You use ServerBuilder when you want a fluent, explicit configuration surface for CORS, custom headers, timeouts, and rate limiting.

Examples

use http_handle::Server;

let server = Server::builder()
    .address("127.0.0.1:8080")
    .document_root(".")
    .enable_cors()
    .build()
    .expect("valid builder config");

assert_eq!(server.address(), "127.0.0.1:8080");

Errors

Builder finalization fails when required fields are missing.

Panics

This type does not panic under normal usage.

Implementations

impl ServerBuilder

pub fn new() -> Self

Creates a new builder with no required fields set.

Examples

use http_handle::server::ServerBuilder;

let builder = ServerBuilder::new();
let _ = builder;
assert_eq!(2 + 2, 4);

Panics

This function does not panic.

pub fn address(self, address: &str) -> Self

Sets the bind address (ip:port) for the server.

Examples

use http_handle::Server;

let server = Server::builder()
    .address("127.0.0.1:8080")
    .document_root(".")
    .build()
    .expect("builder should succeed");
assert_eq!(server.address(), "127.0.0.1:8080");

Panics

This function does not panic.

pub fn document_root(self, path: &str) -> Self

Sets the document root directory used for file resolution.

Examples

use http_handle::Server;

let server = Server::builder()
    .address("127.0.0.1:8080")
    .document_root(".")
    .build()
    .expect("builder should succeed");
assert_eq!(server.document_root().as_path(), std::path::Path::new("."));

Panics

This function does not panic.

pub fn enable_cors(self) -> Self

Enables CORS with default settings

pub fn disable_cors(self) -> Self

Disables CORS

pub fn cors_origins(self, origins: Vec<String>) -> Self

Sets allowed CORS origins

pub fn custom_header(self, name: &str, value: &str) -> Self

Adds a custom header that will be included in all responses

pub fn custom_headers(self, headers: HashMap<String, String>) -> Self

Sets multiple custom headers

pub fn request_timeout(self, timeout: Duration) -> Self

Sets the request timeout duration

pub fn connection_timeout(self, timeout: Duration) -> Self

Sets the connection timeout duration

pub fn rate_limit_per_minute(self, requests: usize) -> Self

Sets a simple per-IP request rate limit per minute.

pub fn static_cache_ttl_secs(self, ttl: u64) -> Self

Sets a default static cache max-age (in seconds).

pub fn build(self) -> Result<Server, &'static str>

Finalizes builder state into a Server.

Examples

use http_handle::Server;

let ok = Server::builder()
    .address("127.0.0.1:8080")
    .document_root(".")
    .build();
assert!(ok.is_ok());

Errors

Returns Err when:

• the address was not provided.
• the document root was not provided.

Panics

This function does not panic.

Trait Implementations

impl Clone for ServerBuilder

fn clone(&self) -> ServerBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerBuilder

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

Formats the value using the given formatter.

impl Default for ServerBuilder

fn default() -> ServerBuilder

Returns the “default value” for a type.