Struct FastCgiHttpService 

pub struct FastCgiHttpService<S> { /* private fields */ }

Available on crate feature fastcgi only.

A FastCGI application service that wraps an inner HTTP service.

Converts each incoming FastCgiRequest into an HTTP Request by reconstructing the method, URI, version, and headers from CGI environment variables, calls the inner service, and serialises the returned HTTP Response back to CGI stdout format for FastCgiServer.

This lets you deploy any existing HTTP handler as a FastCGI application (e.g. behind nginx or Apache) without modifying the handler.

Role handling

• Responder: full HTTP request/response conversion.
• Authorizer: the request body is empty; the HTTP response status code is what the web server uses for allow/deny (200 = allowed). Response headers prefixed with Variable- are forwarded to the downstream application by the web server.
• Filter: the FCGI_DATA stream is not exposed through the HTTP adapter; only the params and stdin are converted. Services that need the raw data stream should implement Service<FastCgiRequest> directly.

Implementations

impl<S> FastCgiHttpService<S>

pub fn new(inner: S) -> FastCgiHttpService<S>

Available on crate feature http only.

Create a new FastCgiHttpService wrapping the given HTTP service.

pub fn get_ref(&self) -> &S

Available on crate feature http only.

Gets a reference to the underlying service.

pub fn into_inner(self) -> S

Available on crate feature http only.

Consumes self, returning the underlying service.

Trait Implementations

impl<S> Clone for FastCgiHttpService<S>

where S: Clone,

fn clone(&self) -> FastCgiHttpService<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S> Debug for FastCgiHttpService<S>

where S: Debug,

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

Formats the value using the given formatter.

impl<S> Service<FastCgiRequest> for FastCgiHttpService<S>

where S: Service<Request, Output = Response>, <S as Service<Request>>::Error: Into<Box<dyn Error + Send + Sync>>,

type Output = FastCgiResponse

The type of the output returned by the service.

type Error = Box<dyn Error + Send + Sync>

The type of error returned by the service.

async fn serve( &self, req: FastCgiRequest, ) -> Result<<FastCgiHttpService<S> as Service<FastCgiRequest>>::Output, <FastCgiHttpService<S> as Service<FastCgiRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.