Struct EchoServiceBuilder 

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

Available on crate features cli and haproxy and http and net and std only.

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<TlsServerConfig>) -> Self

Available on crate features boring or rustls only.

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<TlsServerConfig>, ) -> &mut Self

Available on crate features boring or rustls only.

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

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

Available on crate features boring or rustls only.

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: TlsServerConfig) -> &mut Self

Available on crate features boring or rustls only.

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

pub fn without_tls_server_config(self) -> Self

Available on crate features boring or rustls only.

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

Available on crate features boring or rustls only.

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 maybe_with_geo_db(self, db: Option<Arc<IpGeoDb>>) -> Self

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

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

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

pub fn with_geo_db(self, db: Arc<IpGeoDb>) -> Self

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

pub fn set_geo_db(&mut self, db: Arc<IpGeoDb>) -> &mut Self

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

pub fn without_geo_db(self) -> Self

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

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

attach an IP geolocation database, enabling geo enrichment of the echoed JSON. Typically built from RAMA_IP_GEO_DB.

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, Output = Response, Error = BoxError>>,

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

build a tcp service ready to echo http traffic back

pub fn build_http( &self, exec: Executor, ) -> impl Service<Request, Output: 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.