Struct Server

Source

pub struct Server { /* private fields */ }

Expand description

Represents the internal, mutable state of the web server.

This struct consolidates all the core components required for the server to operate, including configuration, routing, middleware, and various hooks for extending functionality.

Implementations§

Source §

impl Server

Represents the server, providing methods to configure and run it.

This struct wraps the Server configuration and routing logic, offering a high-level API for setting up the HTTP and WebSocket server.

Source

pub fn handle_hook(&mut self, hook: HookType)

Registers a hook into the server’s processing pipeline.

This function dispatches the provided HookType to the appropriate internal hook collection based on its variant. The hook will be executed at the corresponding stage of request processing according to its type:

Panic: Added to panic handlers for error recovery
RequestError: Added to request error handlers
RequestMiddleware: Added to pre-route middleware chain
Route: Registered as a route handler for the specified path
ResponseMiddleware: Added to post-route middleware chain

§Arguments

HookType - The HookType instance containing the hook configuration and factory.

Source

pub fn config_from_json<C>(&mut self, json: C) -> &mut Self
where C: AsRef<str>,

Sets the server configuration from a JSON string.

§Arguments

AsRef<str> - The configuration.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn server_config(&mut self, config: ServerConfig) -> &mut Self

Sets the server configuration.

§Arguments

ServerConfig - The server configuration.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn request_config(&mut self, request_config: RequestConfig) -> &mut Self

Sets the HTTP request config.

§Arguments

RequestConfig- The HTTP request config to set.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn task_panic<S>(&mut self) -> &mut Self
where S: ServerHook,

Registers a task panic handler to the processing pipeline.

This method allows registering task panic handlers that implement the ServerHook trait, which will be executed when a panic occurs during request processing.

§Type Parameters

ServerHook - The task panic handler type that implements ServerHook.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn request_error<S>(&mut self) -> &mut Self
where S: ServerHook,

Registers a request error handler to the processing pipeline.

This method allows registering request error handlers that implement the ServerHook trait, which will be executed when a request error occurs during HTTP request processing.

§Type Parameters

ServerHook - The request error handler type that implements ServerHook.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn route<S>(&mut self, path: impl AsRef<str>) -> &mut Self
where S: ServerHook,

Registers a route hook for a specific path.

This method allows registering route handlers that implement the ServerHook trait, providing type safety and better code organization.

§Type Parameters

ServerHook - The route hook type that implements ServerHook.

§Arguments

AsRef<str> - The route path pattern.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn request_middleware<S>(&mut self) -> &mut Self
where S: ServerHook,

Registers request middleware to the processing pipeline.

This method allows registering middleware that implements the ServerHook trait, which will be executed before route handlers for every incoming request.

§Type Parameters

ServerHook - The middleware type that implements ServerHook.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn response_middleware<S>(&mut self) -> &mut Self
where S: ServerHook,

Registers response middleware to the processing pipeline.

This method allows registering middleware that implements the ServerHook trait, which will be executed after route handlers for every outgoing response.

§Type Parameters

ServerHook - The middleware type that implements ServerHook.

§Returns

&mut Self - Reference to self for method chaining.

Source

pub fn format_bind_address<H>(host: H, port: u16) -> String
where H: AsRef<str>,

Format the host and port into a bindable address string.

§Arguments

H: AsRef<str> - The host address.
u16 - The port number.

§Returns

String - The formatted address string in the form “host:port”.

Source

pub fn try_flush_stdout() -> Result<()>

Flushes the standard output stream.

§Returns

io::Result<()> - The result of the flush operation.

Source

pub fn flush_stdout()

Flushes the standard error stream.

§Panics

This function will panic if the flush operation fails.

Source

pub fn try_flush_stderr() -> Result<()>

Flushes the standard error stream.

§Returns

io::Result<()> - The result of the flush operation.

Source

pub fn flush_stderr()

Flushes the standard error stream.

§Panics

This function will panic if the flush operation fails.

Source

pub fn try_flush_stdout_and_stderr() -> Result<()>

Flushes both the standard output and error streams.

§Returns

io::Result<()> - The result of the flush operation.

Source

pub fn flush_stdout_and_stderr()

Flushes both the standard output and error streams.

§Panics

This function will panic if either flush operation fails.

Source

pub async fn handle_request_error( &self, ctx: &mut Context, error: &RequestError, )

Handles errors that occur while processing HTTP requests.

§Arguments

&mut Context - The request context.
&RequestError - The error that occurred.

Source

pub async fn run(&self) -> Result<ServerControlHook, ServerError>

Starts the server, binds to the configured address, and begins listening for connections.

This is the main entry point to launch the server. It will initialize the panic hook, create a TCP listener, and then enter the connection acceptance loop in a background task.

§Returns

Returns a Result containing a shutdown function on success. Calling this function will shut down the server by aborting its main task. Returns an error if the server fails to start.

Source §