Struct actix_http::HttpService[−][src]

pub struct HttpService<T, S, B, X = ExpectHandler, U = UpgradeHandler> { /* fields omitted */ }

Expand description

A ServiceFactory for HTTP/1.1 or HTTP/2 protocol.

Implementations

[src]

impl<S, B, X, U> HttpService<TlsStream<TcpStream>, S, B, X, U> where
    S: ServiceFactory<Request, Config = ()>,
    S::Future: 'static,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,
    B::Error: Into<Box<dyn StdError>>,
    X: ServiceFactory<Request, Config = (), Response = Request>,
    X::Future: 'static,
    X::Error: Into<Response<AnyBody>>,
    X::InitError: Debug,
    U: ServiceFactory<(Request, Framed<TlsStream<TcpStream>, Codec>), Config = (), Response = ()>,
    U::Future: 'static,
    U::Error: Display + Into<Response<AnyBody>>,
    U::InitError: Debug,

[src]

pub fn openssl(
    self, 
    acceptor: SslAcceptor
) -> impl ServiceFactory<TcpStream, Config = (), Response = (), Error = TlsError<SslError, DispatchError>, InitError = ()>

Create openssl based service

[src]

impl<S, B, X, U> HttpService<TlsStream<TcpStream>, S, B, X, U> where
    S: ServiceFactory<Request, Config = ()>,
    S::Future: 'static,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,
    B::Error: Into<Box<dyn StdError>>,
    X: ServiceFactory<Request, Config = (), Response = Request>,
    X::Future: 'static,
    X::Error: Into<Response<AnyBody>>,
    X::InitError: Debug,
    U: ServiceFactory<(Request, Framed<TlsStream<TcpStream>, Codec>), Config = (), Response = ()>,
    U::Future: 'static,
    U::Error: Display + Into<Response<AnyBody>>,
    U::InitError: Debug,

[src]

pub fn rustls(
    self, 
    config: ServerConfig
) -> impl ServiceFactory<TcpStream, Config = (), Response = (), Error = TlsError<Error, DispatchError>, InitError = ()>

Create rustls based service

[src]

impl<T, S, B> HttpService<T, S, B> where
    S: ServiceFactory<Request, Config = ()>,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,

[src]

pub fn build() -> HttpServiceBuilder<T, S>

Create builder for HttpService instance.

[src]

impl<T, S, B> HttpService<T, S, B> where
    S: ServiceFactory<Request, Config = ()>,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,
    B::Error: Into<Box<dyn StdError>>,

[src]

pub fn new<F: IntoServiceFactory<S, Request>>(service: F) -> Self

Create new HttpService instance.

[src]

impl<T, S, B, X, U> HttpService<T, S, B, X, U> where
    S: ServiceFactory<Request, Config = ()>,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody,

[src]

pub fn expect<X1>(self, expect: X1) -> HttpService<T, S, B, X1, U> where
    X1: ServiceFactory<Request, Config = (), Response = Request>,
    X1::Error: Into<Response<AnyBody>>,
    X1::InitError: Debug,

Provide service for EXPECT: 100-Continue support.

Service get called with request that contains EXPECT header. Service must return request in case of success, in that case request will be forwarded to main service.

[src]

pub fn upgrade<U1>(self, upgrade: Option<U1>) -> HttpService<T, S, B, X, U1> where
    U1: ServiceFactory<(Request, Framed<T, Codec>), Config = (), Response = ()>,
    U1::Error: Display,
    U1::InitError: Debug,

Provide service for custom Connection: UPGRADE support.

If service is provided then normal requests handling get halted and this service get called with original request and framed object.

[src]

impl<S, B, X, U> HttpService<TcpStream, S, B, X, U> where
    S: ServiceFactory<Request, Config = ()>,
    S::Future: 'static,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,
    B::Error: Into<Box<dyn StdError>>,
    X: ServiceFactory<Request, Config = (), Response = Request>,
    X::Future: 'static,
    X::Error: Into<Response<AnyBody>>,
    X::InitError: Debug,
    U: ServiceFactory<(Request, Framed<TcpStream, Codec>), Config = (), Response = ()>,
    U::Future: 'static,
    U::Error: Display + Into<Response<AnyBody>>,
    U::InitError: Debug,

[src]

pub fn tcp(
    self
) -> impl ServiceFactory<TcpStream, Config = (), Response = (), Error = DispatchError, InitError = ()>

Create simple tcp stream service

Trait Implementations

[src]

impl<T, S, B, X, U> ServiceFactory<(T, Protocol, Option<SocketAddr>)> for HttpService<T, S, B, X, U> where
    T: AsyncRead + AsyncWrite + Unpin + 'static,
    S: ServiceFactory<Request, Config = ()>,
    S::Future: 'static,
    S::Error: Into<Response<AnyBody>> + 'static,
    S::InitError: Debug,
    S::Response: Into<Response<B>> + 'static,
    <S::Service as Service<Request>>::Future: 'static,
    B: MessageBody + 'static,
    B::Error: Into<Box<dyn StdError>>,
    X: ServiceFactory<Request, Config = (), Response = Request>,
    X::Future: 'static,
    X::Error: Into<Response<AnyBody>>,
    X::InitError: Debug,
    U: ServiceFactory<(Request, Framed<T, Codec>), Config = (), Response = ()>,
    U::Future: 'static,
    U::Error: Display + Into<Response<AnyBody>>,
    U::InitError: Debug,

type Response = ()

Responses given by the created services.

type Error = DispatchError

Errors produced by the created services.

type Config = ()

Service factory configuration.

type Service = HttpServiceHandler<T, S::Service, B, X::Service, U::Service>

The kind of Service created by this factory.

type InitError = ()

Errors potentially raised while building a service.

type Future = LocalBoxFuture<'static, Result<Self::Service, Self::InitError>>

The future of the Service instance.g

[src]

fn new_service(&self, _: ()) -> Self::Future

Create and return a new service asynchronously.

Auto Trait Implementations

impl<T, S, B, X = ExpectHandler, U = UpgradeHandler> !RefUnwindSafe for HttpService<T, S, B, X, U>

impl<T, S, B, X = ExpectHandler, U = UpgradeHandler> !Send for HttpService<T, S, B, X, U>

impl<T, S, B, X = ExpectHandler, U = UpgradeHandler> !Sync for HttpService<T, S, B, X, U>

impl<T, S, B, X, U> Unpin for HttpService<T, S, B, X, U> where
    B: Unpin,
    S: Unpin,
    U: Unpin,
    X: Unpin,

impl<T, S, B, X = ExpectHandler, U = UpgradeHandler> !UnwindSafe for HttpService<T, S, B, X, U>

Blanket Implementations

[src]

impl<T> Any for T where
    T: 'static + ?Sized,

[src]

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

[src]

impl<T> Borrow<T> for T where
    T: ?Sized,

[src]

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized,

[src]

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

[src]

impl<T> From<T> for T

[src]

pub fn from(t: T) -> T

Performs the conversion.

[src]

impl<T> Instrument for T

[src]

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

[src]

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

[src]

impl<T, U> Into<U> for T where
    U: From<T>,

[src]

pub fn into(self) -> U

Performs the conversion.

[src]

impl<SF, Req> IntoServiceFactory<SF, Req> for SF where
    SF: ServiceFactory<Req>,

[src]

pub fn into_factory(self) -> SF

Convert Self to a ServiceFactory

impl<T> Same<T> for T

type Output = T

Should always be Self

[src]

impl<SF, Req> ServiceFactoryExt<Req> for SF where
    SF: ServiceFactory<Req>,

[src]

fn map<F, R>(self, f: F) -> MapServiceFactory<Self, F, Req, R> where
    F: FnMut(Self::Response) -> R + Clone,

Map this service’s output to a different type, returning a new service of the resulting type. Read more

[src]

fn map_err<F, E>(self, f: F) -> MapErrServiceFactory<Self, Req, F, E> where
    F: Fn(Self::Error) -> E + Clone,

Map this service’s error to a different error, returning a new service.

[src]

fn map_init_err<F, E>(self, f: F) -> MapInitErr<Self, F, Req, E> where
    F: Fn(Self::InitError) -> E + Clone,

Map this factory’s init error to a different error, returning a new service.

[src]

fn and_then<I, SF1>(self, factory: I) -> AndThenServiceFactory<Self, SF1, Req> where
    I: IntoServiceFactory<SF1, Self::Response>,
    SF1: ServiceFactory<Self::Response, Config = Self::Config, Error = Self::Error, InitError = Self::InitError>,
    Self::Config: Clone,

Call another service after call to this one has resolved successfully.

[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

[src]

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

[src]

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,

pub fn vzip(self) -> V