Struct EchoServiceBuilder

pub struct EchoServiceBuilder<H> { /* private fields */ }

Builder that can be used to run your own echo Service, echo’ing back information about that request and its underlying transport / presentation layers.

Implementations

impl EchoServiceBuilder<()>

pub fn new() -> Self

Create a new EchoServiceBuilder.

impl<H> EchoServiceBuilder<H>

pub fn with_concurrent(self, limit: usize) -> Self

set the number of concurrent connections to allow

(0 = no limit)

pub fn set_concurrent(&mut self, limit: usize) -> &mut Self

set the number of concurrent connections to allow

(0 = no limit)

pub fn with_body_limit(self, limit: usize) -> Self

set the body limit in bytes for each request

pub fn set_body_limit(&mut self, limit: usize) -> &mut Self

set the body limit in bytes for each request

pub fn with_timeout(self, timeout: Duration) -> Self

set the timeout in seconds for each connection

(0 = no timeout)

pub fn set_timeout(&mut self, timeout: Duration) -> &mut Self

set the timeout in seconds for each connection

(0 = no timeout)

pub fn maybe_with_forward(self, kind: Option<ForwardKind>) -> Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn maybe_set_forward(&mut self, kind: Option<ForwardKind>) -> &mut Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn with_forward(self, kind: ForwardKind) -> Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn set_forward(&mut self, kind: ForwardKind) -> &mut Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn without_forward(self) -> Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn unset_forward(&mut self) -> &mut Self

enable support for one of the following “forward” headers or protocols

Supported headers:

Forwarded (“for=”), X-Forwarded-For

X-Client-IP Client-IP, X-Real-IP

CF-Connecting-IP, True-Client-IP

Or using HaProxy protocol.

pub fn maybe_with_tls_server_config(self, cfg: Option<ServerConfig>) -> Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn maybe_set_tls_server_config( &mut self, cfg: Option<ServerConfig>, ) -> &mut Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn with_tls_server_config(self, cfg: ServerConfig) -> Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn set_tls_server_config(&mut self, cfg: ServerConfig) -> &mut Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn without_tls_server_config(self) -> Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn unset_tls_server_config(&mut self) -> &mut Self

define a tls server cert config to be used for tls terminaton by the echo service.

pub fn maybe_with_http_version(self, version: Option<Version>) -> Self

set the http version to use for the http server (auto by default)

pub fn maybe_set_http_version(&mut self, version: Option<Version>) -> &mut Self

set the http version to use for the http server (auto by default)

pub fn with_http_version(self, version: Version) -> Self

set the http version to use for the http server (auto by default)

pub fn set_http_version(&mut self, version: Version) -> &mut Self

set the http version to use for the http server (auto by default)

pub fn without_http_version(self) -> Self

set the http version to use for the http server (auto by default)

pub fn unset_http_version(&mut self) -> &mut Self

set the http version to use for the http server (auto by default)

pub fn with_http_layer<H2>(self, layer: H2) -> EchoServiceBuilder<(H, H2)>

add a custom http layer which will be applied to the existing http layers

pub fn maybe_with_user_agent_database( self, db: Option<Arc<UserAgentDatabase>>, ) -> Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn maybe_set_user_agent_database( &mut self, db: Option<Arc<UserAgentDatabase>>, ) -> &mut Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn with_user_agent_database(self, db: Arc<UserAgentDatabase>) -> Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn set_user_agent_database( &mut self, db: Arc<UserAgentDatabase>, ) -> &mut Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn without_user_agent_database(self) -> Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn unset_user_agent_database(&mut self) -> &mut Self

maybe set the user agent datasbase that if set would be used to look up a user agent (by ua header string) to see if we have a ja3/ja4 hash.

pub fn with_ws_support(self, support: bool) -> Self

define whether or not WS support is enabled

pub fn set_ws_support(&mut self, support: bool) -> &mut Self

define whether or not WS support is enabled

impl<H> EchoServiceBuilder<H>

where H: Layer<EchoService, Service: Service<Request, Response = Response, Error = BoxError>>,

pub fn build( self, executor: Executor, ) -> Result<impl Service<TcpStream, Response = (), Error = Infallible>, BoxError>

build a tcp service ready to echo http traffic back

pub fn build_http( &self, ) -> impl Service<Request, Response: IntoResponse, Error = Infallible> + use<H>

build an http service ready to echo http traffic back

Trait Implementations

impl<H: Clone> Clone for EchoServiceBuilder<H>

fn clone(&self) -> EchoServiceBuilder<H>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<H: Debug> Debug for EchoServiceBuilder<H>

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

Formats the value using the given formatter.

impl Default for EchoServiceBuilder<()>

fn default() -> Self

Returns the “default value” for a type.