EchoServiceBuilder

Struct EchoServiceBuilder 

Source
pub struct EchoServiceBuilder<H> { /* private fields */ }
Available on crate features http and net and haproxy and cli only.
Expand description

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§

Source§

impl EchoServiceBuilder<()>

Source

pub fn new() -> Self

Create a new EchoServiceBuilder.

Source§

impl<H> EchoServiceBuilder<H>

Source

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

set the number of concurrent connections to allow

(0 = no limit)

Source

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

set the number of concurrent connections to allow

(0 = no limit)

Source

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

set the body limit in bytes for each request

Source

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

set the body limit in bytes for each request

Source

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

set the timeout in seconds for each connection

(0 = no timeout)

Source

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

set the timeout in seconds for each connection

(0 = no timeout)

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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

Available on crate features rustls or boring only.

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

Source

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

Available on crate features rustls or boring only.

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

Source

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

Available on crate features rustls or boring only.

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

Source

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

Available on crate features rustls or boring only.

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

Source

pub fn without_tls_server_config(self) -> Self

Available on crate features rustls or boring only.

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

Source

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

Available on crate features rustls or boring only.

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

Source

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

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

Source

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)

Source

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

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

Source

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

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

Source

pub fn without_http_version(self) -> Self

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

Source

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

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

Source

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

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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

define whether or not WS support is enabled

Source

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

define whether or not WS support is enabled

Source§

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

Source

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

build a tcp service ready to echo http traffic back

Source

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§

Source§

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

Source§

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

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

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

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for EchoServiceBuilder<()>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl<H> Freeze for EchoServiceBuilder<H>
where H: Freeze,

§

impl<H> !RefUnwindSafe for EchoServiceBuilder<H>

§

impl<H> Send for EchoServiceBuilder<H>
where H: Send,

§

impl<H> Sync for EchoServiceBuilder<H>
where H: Sync,

§

impl<H> Unpin for EchoServiceBuilder<H>
where H: Unpin,

§

impl<H> !UnwindSafe for EchoServiceBuilder<H>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FromRef<T> for T
where T: Clone,

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

impl<T> Instrument for T

§

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

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

fn in_current_span(self) -> Instrumented<Self>

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

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

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

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

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
§

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

§

fn rama_from(value: T) -> U

§

impl<T, U, CrateMarker> RamaInto<U, CrateMarker> for T
where U: RamaFrom<T, CrateMarker>,

§

fn rama_into(self) -> U

§

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

§

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

§

fn rama_try_from(value: T) -> Result<U, <U as RamaTryFrom<T>>::Error>

§

impl<T, U, CrateMarker> RamaTryInto<U, CrateMarker> for T
where U: RamaTryFrom<T, CrateMarker>,

§

type Error = <U as RamaTryFrom<T, CrateMarker>>::Error

§

fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T, CrateMarker>>::Error>

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

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

Source§

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

The type returned in the event of a conversion error.
Source§

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>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more