Struct HttpServer 

pub struct HttpServer { /* private fields */ }

HTTP server plugin that handles incoming HTTP requests for WebAssembly components.

This plugin implements the wasi:http/incoming-handler interface and routes HTTP requests to appropriate WebAssembly components based on virtual hosting. It supports both HTTP and HTTPS connections with optional mutual TLS.

Implementations

impl HttpServer

pub fn new(addr: SocketAddr) -> Self

Creates a new HTTP server listening on the specified address.

Arguments

• addr - The socket address to bind to

Returns

A new HttpServer instance configured for HTTP connections.

pub async fn new_with_tls( addr: SocketAddr, cert_path: &Path, key_path: &Path, ca_path: Option<&Path>, ) -> Result<Self>

Creates a new HTTPS server with TLS support.

Arguments

• addr - The socket address to bind to
• cert_path - Path to the TLS certificate file
• key_path - Path to the private key file
• ca_path - Optional path to CA certificate for mutual TLS

Returns

A new HttpServer instance configured for HTTPS connections.

Errors

Returns an error if the TLS configuration cannot be loaded.

Trait Implementations

impl HostPlugin for HttpServer

fn id(&self) -> &'static str

Returns the unique identifier for this plugin.

fn world(&self) -> WitWorld

Returns the WIT interfaces that this plugin provides.

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called when the plugin is started during host initialization.

fn on_component_bind<'life0, 'life1, 'async_trait>( &'life0 self, component: &'life1 mut WorkloadComponent, interfaces: HashSet<WitInterface>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called when a WorkloadComponent is being bound to this plugin.

fn on_workload_resolved<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, resolved_handle: &'life1 ResolvedWorkload, component_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called when a workload has been fully resolved and is ready for use.

fn on_workload_unbind<'life0, 'life1, 'async_trait>( &'life0 self, workload: &'life1 ResolvedWorkload, _interfaces: HashSet<WitInterface>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called when a workload is being stopped or unbound from this plugin.

fn stop<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called when the plugin is being stopped during host shutdown.

fn on_workload_bind<'life0, 'life1, 'async_trait>( &'life0 self, _workload: &'life1 UnresolvedWorkload, _interfaces: HashSet<WitInterface>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called when a workload is binding to this plugin.