Class HostConfiguration

  • All Implemented Interfaces:
    java.lang.Cloneable

    public class HostConfiguration
    extends java.lang.Object
    implements java.lang.Cloneable
    Holds all of the variables needed to describe an HTTP connection to a host. This includes remote host, port and protocol, proxy host and port, local address, and virtual host.
    Since:
    2.0
    • Field Detail

      • ANY_HOST_CONFIGURATION

        public static final HostConfiguration ANY_HOST_CONFIGURATION
        A value to represent any host configuration, instead of using something like null. This value should be treated as immutable and only used in lookups and other such places to represent "any" host config.
    • Constructor Detail

      • HostConfiguration

        public HostConfiguration()
        Constructor for HostConfiguration.
      • HostConfiguration

        public HostConfiguration​(HostConfiguration hostConfiguration)
        Copy constructor for HostConfiguration
        Parameters:
        hostConfiguration - the hostConfiguration to copy
    • Method Detail

      • clone

        public java.lang.Object clone()
        See Also:
        Object.clone()
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
        See Also:
        Object.toString()
      • hostEquals

        public boolean hostEquals​(HttpConnection connection)
        Tests if the host configuration equals the configuration set on the connection. True only if the host, port, protocol, local address and virtual address are equal. If no host configuration has been set false will be returned.
        Parameters:
        connection - the connection to test against
        Returns:
        true if the connection's host information equals that of this configuration
        See Also:
        proxyEquals(HttpConnection)
      • proxyEquals

        public boolean proxyEquals​(HttpConnection connection)
        Tests if the proxy configuration equals the configuration set on the connection. True only if the proxyHost and proxyPort are equal.
        Parameters:
        connection - the connection to test against
        Returns:
        true if the connection's proxy information equals that of this configuration
        See Also:
        hostEquals(HttpConnection)
      • isHostSet

        public boolean isHostSet()
        Deprecated.
        no longer used
        Returns true if the host is set.
        Returns:
        true if the host is set.
      • setHost

        public void setHost​(HttpHost host)
        Sets the given host
        Parameters:
        host - the host
      • setHost

        public void setHost​(java.lang.String host,
                            int port,
                            java.lang.String protocol)
        Sets the given host, port and protocol
        Parameters:
        host - the host(IP or DNS name)
        port - The port
        protocol - The protocol.
      • setHost

        public void setHost​(java.lang.String host,
                            java.lang.String virtualHost,
                            int port,
                            Protocol protocol)
        Deprecated.
        #setHost(String, int, Protocol)
        Sets the given host, virtual host, port and protocol.
        Parameters:
        host - the host(IP or DNS name)
        virtualHost - the virtual host name or null
        port - the host port or -1 to use protocol default
        protocol - the protocol
      • setHost

        public void setHost​(java.lang.String host,
                            int port,
                            Protocol protocol)
        Sets the given host, port and protocol.
        Parameters:
        host - the host(IP or DNS name)
        port - The port
        protocol - the protocol
      • setHost

        public void setHost​(java.lang.String host,
                            int port)
        Sets the given host and port. Uses the default protocol "http".
        Parameters:
        host - the host(IP or DNS name)
        port - The port
      • setHost

        public void setHost​(java.lang.String host)
        Set the given host. Uses the default protocol("http") and its port.
        Parameters:
        host - The host(IP or DNS name).
      • setHost

        public void setHost​(URI uri)
        Sets the protocol, host and port from the given URI.
        Parameters:
        uri - the URI.
      • getHostURL

        public java.lang.String getHostURL()
        Return the host url.
        Returns:
        The host url.
      • getHost

        public java.lang.String getHost()
        Returns the host.
        Returns:
        the host(IP or DNS name), or null if not set
        See Also:
        isHostSet()
      • getVirtualHost

        public java.lang.String getVirtualHost()
        Deprecated.
        use HostParams
        Returns the virtual host.
        Returns:
        the virtual host name, or null if not set
      • getPort

        public int getPort()
        Returns the port.
        Returns:
        the host port, or -1 if not set
        See Also:
        isHostSet()
      • getProtocol

        public Protocol getProtocol()
        Returns the protocol.
        Returns:
        The protocol.
      • isProxySet

        public boolean isProxySet()
        Deprecated.
        no longer used
        Tests if the proxy host/port have been set.
        Returns:
        true if a proxy server has been set.
        See Also:
        setProxy(String, int)
      • setProxyHost

        public void setProxyHost​(ProxyHost proxyHost)
        Sets the given proxy host
        Parameters:
        proxyHost - the proxy host
      • setProxy

        public void setProxy​(java.lang.String proxyHost,
                             int proxyPort)
        Set the proxy settings.
        Parameters:
        proxyHost - The proxy host
        proxyPort - The proxy port
      • getProxyHost

        public java.lang.String getProxyHost()
        Returns the proxyHost.
        Returns:
        the proxy host, or null if not set
        See Also:
        isProxySet()
      • getProxyPort

        public int getProxyPort()
        Returns the proxyPort.
        Returns:
        the proxy port, or -1 if not set
        See Also:
        isProxySet()
      • setLocalAddress

        public void setLocalAddress​(java.net.InetAddress localAddress)
        Set the local address to be used when creating connections. If this is unset, the default address will be used. This is useful for specifying the interface to use on multi-homed or clustered systems.
        Parameters:
        localAddress - the local address to use
      • getLocalAddress

        public java.net.InetAddress getLocalAddress()
        Return the local address to be used when creating connections. If this is unset, the default address should be used.
        Returns:
        the local address to be used when creating Sockets, or null
      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object
        See Also:
        Object.equals(java.lang.Object)
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
        See Also:
        Object.hashCode()