Struct Proxy

#[non_exhaustive]
pub struct Proxy<U, C>
where
    U: Upstreams,
    C: Client,
{
    pub upstreams: U,
    pub client: C,
    pub url_path_getter: Box<dyn Fn(&Request, &Depot) -> Option<String> + Sync + Send>,
    pub url_query_getter: Box<dyn Fn(&Request, &Depot) -> Option<String> + Sync + Send>,
}

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: Box<dyn Fn(&Request, &Depot) -> Option<String> + Sync + Send>

Url path getter.

url_query_getter: Box<dyn Fn(&Request, &Depot) -> Option<String> + Sync + Send>

Url query getter.

Implementations

impl<U> Proxy<U, HyperClient>

where U: Upstreams, <U as Upstreams>::Error: Into<Box<dyn Error + Sync + Send>>,

pub fn use_hyper_client(upstreams: U) -> Proxy<U, HyperClient>

Create a new Proxy using the default Hyper client.

This is a convenient way to create a proxy with standard configuration.

impl<U> Proxy<U, ReqwestClient>

where U: Upstreams, <U as Upstreams>::Error: Into<Box<dyn Error + Sync + Send>>,

pub fn use_reqwest_client(upstreams: U) -> Proxy<U, ReqwestClient>

Create a new Proxy using the default Reqwest client.

This is a convenient way to create a proxy with standard configuration.

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

where U: Upstreams, <U as Upstreams>::Error: Into<Box<dyn Error + Sync + Send>>, C: Client,

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

Create new Proxy with upstreams list.

pub fn url_path_getter<G>(self, url_path_getter: G) -> Proxy<U, C>

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) -> Proxy<U, C>

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 as Upstreams>::Error: Into<Box<dyn Error + Sync + Send>>, 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 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, Proxy<U, C>: 'async_trait,

Handle http request.

fn arc(self) -> ArcHandler

where Self: Sized,

Wrap to ArcHandler.

fn hooped<H>(self) -> HoopedHandler

where H: Handler, Self: Sized,

Wrap to HoopedHandler.

fn hoop<H>(self, hoop: H) -> HoopedHandler

where H: Handler, Self: Sized,

Hoop this handler with middleware.

fn hoop_when<H, F>(self, hoop: H, filter: F) -> HoopedHandler

where Self: Sized, H: Handler, F: Fn(&Request, &Depot) -> bool + Send + Sync + 'static,

Hoop this handler with middleware.