Struct salvo_proxy::Proxy

#[non_exhaustive]
pub struct Proxy<U, C>
where
    U: Upstreams,
    C: Client,
{
    pub upstreams: U,
    pub client: C,
    pub url_path_getter: UrlPartGetter,
    pub url_query_getter: UrlPartGetter,
}

Handler that can proxy request to other server.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

upstreams: U

Upstreams list.

client: C

Client for proxy.

url_path_getter: UrlPartGetter

Url path getter.

url_query_getter: UrlPartGetter

Url query getter.

Implementations

impl<U> Proxy<U, HyperClient>

where U: Upstreams, U::Error: Into<BoxedError>,

pub fn use_hyper_client(upstreams: U) -> Self

Available on crate feature hyper-client only.

Create new Proxy which use default hyper util client.

impl<U> Proxy<U, ReqwestClient>

where U: Upstreams, U::Error: Into<BoxedError>,

pub fn use_reqwest_client(upstreams: U) -> Self

Available on crate feature reqwest-client only.

Create new Proxy which use default reqwest util client.

impl<U, C> Proxy<U, C>

where U: Upstreams, U::Error: Into<BoxedError>, C: Client,

pub fn new(upstreams: U, client: C) -> Self

Create new Proxy with upstreams list.

pub fn url_path_getter<G>(self, url_path_getter: G) -> Self

where G: Fn(&Request, &Depot) -> Option<String> + Send + Sync + 'static,

Set url path getter.

pub fn url_query_getter<G>(self, url_query_getter: G) -> Self

where G: Fn(&Request, &Depot) -> Option<String> + Send + Sync + 'static,

Set url query getter.

pub fn upstreams(&self) -> &U

Get upstreams list.

pub fn upstreams_mut(&mut self) -> &mut U

Get upstreams mutable list.

pub fn client(&self) -> &C

Get client reference.

pub fn client_mut(&mut self) -> &mut C

Get client mutable reference.

Trait Implementations

impl<U, C> Handler for Proxy<U, C>

where U: Upstreams, U::Error: Into<BoxedError>, C: Client,

fn handle<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, req: &'life1 mut Request, depot: &'life2 mut Depot, res: &'life3 mut Response, _ctrl: &'life4 mut FlowCtrl ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait,

Handle http request.