Struct viceroy_lib::ViceroyService

pub struct ViceroyService { /* private fields */ }

A Viceroy service uses a Wasm module and a handler function to respond to HTTP requests.

This service type is used to compile a Wasm Module, and perform the actions necessary to initialize a Server and bind the service to a local port.

Each time a connection is received, a RequestService will be created, to instantiate the module and return a Response.

Implementations

impl ViceroyService

pub fn new(ctx: ExecuteCtx) -> Self

Create a new Viceroy service, using the given handler function and module path.

Example

let ctx = ExecuteCtx::new("path/to/a/file.wasm")?;
let svc = ViceroyService::new(ctx);

pub async fn serve(self, addr: SocketAddr) -> Result<(), Error>

Bind this service to the given address and start serving responses.

This will consume the service, using it to start a server that will execute the given module each time a new request is sent. This function will only return if an error occurs.

Trait Implementations

impl<'addr> Service<&'addr AddrStream> for ViceroyService

type Response = RequestService

Responses given by the service.

type Error = Infallible

Errors produced by the service.

type Future = Ready<Result<<ViceroyService as Service<&'addr AddrStream>>::Response, <ViceroyService as Service<&'addr AddrStream>>::Error>>

The future response value.

fn poll_ready(&mut self, _cx: &mut Context<'_>) -> Poll<Result<(), Self::Error>>

Returns Poll::Ready(Ok(())) when the service is able to process requests.

fn call(&mut self, addr: &'addr AddrStream) -> Self::Future

Process the request and return the response asynchronously.