Trait actix_web::Route

pub trait Route: Actor {
    type State;
    fn request(
        req: &mut HttpRequest, 
        payload: Payload, 
        ctx: &mut Self::Context
    ) -> RouteResult<Self>;

    fn expect(
        req: &HttpRequest, 
        ctx: &mut Self::Context
    ) -> Result<(), HttpResponse>
    where
        Self: Actor<Context = HttpContext<Self>>,
    { ... }
    fn factory() -> RouteFactory<Self, Self::State> { ... }
}

Actors with ability to handle http requests.

Associated Types

type State

Shared state. State is shared with all routes within same application and could be accessed with HttpContext::state() method.

Required Methods

fn request(
    req: &mut HttpRequest,
    payload: Payload,
    ctx: &mut Self::Context
) -> RouteResult<Self>

Handle incoming request. Route actor can return result immediately with Reply::reply. Actor itself can be returned with Reply::stream for handling streaming request/response or websocket connection. In that case HttpContext::start and HttpContext::write has to be used for writing response.

Provided Methods

fn expect(
    req: &HttpRequest,
    ctx: &mut Self::Context
) -> Result<(), HttpResponse> where
    Self: Actor<Context = HttpContext<Self>>, 

Handle EXPECT header. By default respones with HTTP/1.1 100 Continue

fn factory() -> RouteFactory<Self, Self::State>

This method creates RouteFactory for this actor.

Implementors