Struct ServiceBinding 

pub struct ServiceBinding { /* private fields */ }

Represents a network service binding, encapsulating protocol and socket address.

This struct is used to define how a service binds to a network interface and port.

It’s an URL without path and some restrictions:

• Only some schemes are accepted: udp, http, https.
• The port number must be greater than zero. The service should be already listening on that port.
• The authority part of the URL must be a valid socket address (wildcard is accepted).

Besides it accepts some non well-formed URLs, like:http://127.0.0.1:7070 or https://127.0.0.1:7070. Those URLs are not valid because they use non standard ports (80 and 443).

NOTICE: It does not represent a public valid URL clients can connect to. It represents the service’s internal URL configuration after assigning a port. If the port in the configuration is not zero, it’s basically the same information you get from the configuration (binding address + protocol).

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};
use torrust_net_primitives::service_binding::{ServiceBinding, Protocol};

let service_binding = ServiceBinding::new(Protocol::HTTP, SocketAddr::new(IpAddr::V4(Ipv4Addr::LOCALHOST), 7070)).unwrap();

assert_eq!(service_binding.url().to_string(), "http://127.0.0.1:7070/".to_string());

Implementations

impl ServiceBinding

pub fn new(protocol: Protocol, bind_address: SocketAddr) -> Result<Self, Error>

Errors

This function will return an error if the port number is zero.

pub fn protocol(&self) -> Protocol

Returns the protocol used by the service.

pub fn bind_address(&self) -> SocketAddr

pub fn bind_address_ip_type(&self) -> IpType

pub fn bind_address_ip_family(&self) -> IpFamily

pub fn url(&self) -> Url

Panics

It never panics because the URL is always valid.

Trait Implementations

impl Clone for ServiceBinding

fn clone(&self) -> ServiceBinding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceBinding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServiceBinding

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ServiceBinding

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

Formats the value using the given formatter.

impl Eq for ServiceBinding

impl From<ServiceBinding> for Url

fn from(service_binding: ServiceBinding) -> Self

Converts to this type from the input type.

impl Hash for ServiceBinding

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ServiceBinding

fn eq(&self, other: &ServiceBinding) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServiceBinding

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ServiceBinding