Enum Target 

pub enum Target {
    None,
    Remote(RemoteTarget),
    Local(SocketAddr),
}

Available on crate feature client only.

HTTP target server descriptor

Variants

None

No target specified

Remote(RemoteTarget)

Remote target, supports service name (domain name by default) or ip address

Local(SocketAddr)

Available on target_family=unix only.

Local target, usually using a unix domain socket.

Implementations

impl Target

pub const unsafe fn new_host_unchecked( scheme: Scheme, host: FastStr, port: u16, ) -> Self

Create a Target by a scheme, host and port without checking scheme

Safety

Users must ensure that the scheme is valid.

• HTTP is always valid
• HTTPS is valid if any feature of tls is enabled
• Other schemes are always invalid

pub const unsafe fn new_addr_unchecked( scheme: Scheme, ip: IpAddr, port: u16, ) -> Self

Create a Target by a scheme, ip address and port without checking scheme

Safety

Users must ensure that the scheme is valid.

• HTTP is always valid
• HTTPS is valid if any feature of tls is enabled
• Other schemes are always invalid

pub fn new_host<S>( scheme: Option<Scheme>, host: S, port: Option<u16>, ) -> Result<Self>

where S: Into<Cow<'static, str>>,

Create a Target through a scheme, host name and a port

pub fn new_addr( scheme: Option<Scheme>, ip: IpAddr, port: Option<u16>, ) -> Result<Self>

Create a Target through a scheme, ip address and a port

pub fn from_host<S>(host: S) -> Self

where S: Into<Cow<'static, str>>,

Create a Target through a host name

pub fn from_uri(uri: &Uri) -> Result<Self>

Create a Target from Uri

pub fn set_scheme(&mut self, scheme: Scheme) -> Result<()>

Set a new scheme to the Target

Note that if the previous is default port of the previous scheme, the port will be also updated to default port of the new scheme.

pub fn set_port(&mut self, port: u16) -> Result<()>

Set a new port to the Target

pub fn is_none(&self) -> bool

Return if the Target is Target::None

pub fn remote_ref(&self) -> Option<&RemoteTarget>

Get a reference of the RemoteTarget.

pub fn remote_mut(&mut self) -> Option<&mut RemoteTarget>

Get a mutable reference of the RemoteTarget.

pub fn remote_ip(&self) -> Option<&IpAddr>

Return the remote IpAddr if the Target is an IP address.

pub fn remote_host(&self) -> Option<&FastStr>

Return the remote host name if the Target is a host name.

pub fn unix_socket_addr(&self) -> Option<&SocketAddr>

Available on target_family=unix only.

Return the unix socket address if the Target is it.

pub fn scheme(&self) -> Option<&Scheme>

Return target scheme if the Target is a remote address

pub fn port(&self) -> Option<u16>

Return target port if the Target is a remote address

Trait Implementations

impl Apply<ClientContext> for Target

type Error = ClientError

fn apply(self, cx: &mut ClientContext) -> Result<(), Self::Error>

impl Clone for Target

fn clone(&self) -> Target

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Default for Target

fn default() -> Target

Returns the “default value” for a type.

impl Display for Target

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

Formats the value using the given formatter.

impl From<Address> for Target

fn from(value: Address) -> Self

Converts to this type from the input type.