Class Address

  • Direct Known Subclasses:
    ResolvedInetAddress

    public class Address
    extends java.lang.Object
    A representation of network addresses, i.e. host/port pairs, with some utility functions for parsing address strings.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.lang.String _host
      host name
      private int _port
      port number
      private static org.slf4j.Logger LOGGER  
    • Constructor Summary

      Constructors 
      Constructor Description
      Address​(java.lang.String host)
      Construct an address from a host.
      Address​(java.lang.String host, int port)
      Construct an address from a host name and port number.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object obj)  
      java.lang.String getHost()
      Get the host name
      int getPort()
      Get the port number
      int hashCode()  
      static boolean isHostWithPort​(java.lang.String addressString)  
      static Address parseAddress​(java.lang.String addressString)
      Factory method: takes a formatted addressString string as construction parameter
      static Address[] parseAddresses​(java.lang.String addresses)
      Array-based factory method: takes an array of formatted address strings as construction parameter
      static java.lang.String parseHost​(java.lang.String addressString)
      Extracts hostname or IP address from a string containing a hostname, IP address, hostname:port pair or IP address:port pair.
      static int parsePort​(java.lang.String addressString)  
      java.net.InetSocketAddress toInetSocketAddress​(int port)
      Construct an InetSocketAddress for this address with a specific port
      java.lang.String toString()  
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    • Field Detail

      • LOGGER

        private static final org.slf4j.Logger LOGGER
      • _host

        private final java.lang.String _host
        host name
      • _port

        private final int _port
        port number
    • Constructor Detail

      • Address

        public Address​(java.lang.String host,
                       int port)
        Construct an address from a host name and port number.
        Parameters:
        host - the host name
        port - the port number
      • Address

        public Address​(java.lang.String host)
        Construct an address from a host.
        Parameters:
        host - the host name
    • Method Detail

      • getHost

        public java.lang.String getHost()
        Get the host name
        Returns:
        the host name
      • getPort

        public int getPort()
        Get the port number
        Returns:
        the port number
      • parseHost

        public static java.lang.String parseHost​(java.lang.String addressString)
        Extracts hostname or IP address from a string containing a hostname, IP address, hostname:port pair or IP address:port pair. Note that IPv6 addresses must be quoted with square brackets, e.g. [2001:db8:85a3:8d3:1319:8a2e:370:7348].
        Parameters:
        addressString - the string to extract hostname from
        Returns:
        the hostname or IP address
      • parsePort

        public static int parsePort​(java.lang.String addressString)
      • isHostWithPort

        public static boolean isHostWithPort​(java.lang.String addressString)
      • parseAddress

        public static Address parseAddress​(java.lang.String addressString)
        Factory method: takes a formatted addressString string as construction parameter
        Parameters:
        addressString - an addressString of the form "host[:port]".
        Returns:
        an Address from the given data
      • toInetSocketAddress

        public java.net.InetSocketAddress toInetSocketAddress​(int port)
        Construct an InetSocketAddress for this address with a specific port
      • parseAddresses

        public static Address[] parseAddresses​(java.lang.String addresses)
        Array-based factory method: takes an array of formatted address strings as construction parameter
        Parameters:
        addresses - array of strings of form "host[:port],..."
        Returns:
        a list of Address values
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object