pub trait ProxyExt: 'static {
    fn connect(
        &self,
        connection: &impl IsA<IOStream>,
        proxy_address: &impl IsA<ProxyAddress>,
        cancellable: Option<&impl IsA<Cancellable>>
    ) -> Result<IOStream, Error>; fn connect_async<P: FnOnce(Result<IOStream, Error>) + 'static>(
        &self,
        connection: &impl IsA<IOStream>,
        proxy_address: &impl IsA<ProxyAddress>,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P
    ); fn connect_future(
        &self,
        connection: &impl IsA<IOStream> + Clone + 'static,
        proxy_address: &impl IsA<ProxyAddress> + Clone + 'static
    ) -> Pin<Box_<dyn Future<Output = Result<IOStream, Error>> + 'static>>; fn supports_hostname(&self) -> bool; }
Expand description

Trait containing all Proxy methods.

Implementors

Proxy

Required Methods

Given connection to communicate with a proxy (eg, a SocketConnection that is connected to the proxy server), this does the necessary handshake to connect to proxy_address, and if required, wraps the IOStream to handle proxy payload.

connection

a IOStream

proxy_address

a ProxyAddress

cancellable

a Cancellable

Returns

a IOStream that will replace connection. This might be the same as connection, in which case a reference will be added.

Asynchronous version of connect().

connection

a IOStream

proxy_address

a ProxyAddress

cancellable

a Cancellable

callback

a GAsyncReadyCallback

Some proxy protocols expect to be passed a hostname, which they will resolve to an IP address themselves. Others, like SOCKS4, do not allow this. This function will return false if self is implementing such a protocol. When false is returned, the caller should resolve the destination hostname first, and then pass a ProxyAddress containing the stringified IP address to connect() or connect_async().

Returns

true if hostname resolution is supported.

Implementors