Class HttpHost

java.lang.Object
org.apache.http.HttpHost
All Implemented Interfaces:
Serializable, Cloneable
@Contract(threading=IMMUTABLE) public final class HttpHost extends Object implements Cloneable, Serializable
Holds all of the variables needed to describe an HTTP connection to a host. This includes remote host name, port and scheme.
Since:
4.0
See Also:

  • Field Details

    • DEFAULT_SCHEME_NAME

      public static final String DEFAULT_SCHEME_NAME
      The default scheme is "http".
      See Also:

    • hostname

      protected final String hostname
      The host to use.

    • lcHostname

      protected final String lcHostname
      The lowercase host, for equals(Object) and hashCode().

    • port

      protected final int port
      The port to use, defaults to -1 if not set.

    • schemeName

      protected final String schemeName
      The scheme (lowercased)

    • address

      protected final InetAddress address

  • Constructor Details

    • HttpHost

      public HttpHost(String hostname, int port, String scheme)
      Creates HttpHost instance with the given scheme, hostname and port.
      Parameters:
      hostname - the hostname (IP or DNS name)
      port - the port number. -1 indicates the scheme default port.
      scheme - the name of the scheme. null indicates the default scheme

    • HttpHost

      public HttpHost(String hostname, int port)
      Creates HttpHost instance with the default scheme and the given hostname and port.
      Parameters:
      hostname - the hostname (IP or DNS name)
      port - the port number. -1 indicates the scheme default port.

    • HttpHost

      public HttpHost(String hostname)
      Creates HttpHost instance with the default scheme and port and the given hostname.
      Parameters:
      hostname - the hostname (IP or DNS name)

    • HttpHost

      public HttpHost(InetAddress address, int port, String scheme)
      Creates HttpHost instance with the given scheme, inet address and port.
      Parameters:
      address - the inet address.
      port - the port number. -1 indicates the scheme default port.
      scheme - the name of the scheme. null indicates the default scheme
      Since:
      4.3

    • HttpHost

      public HttpHost(InetAddress address, String hostname, int port, String scheme)
      Creates a new HttpHost, specifying all values. Constructor for HttpHost.
      Parameters:
      address - the inet address.
      hostname - the hostname (IP or DNS name)
      port - the port number. -1 indicates the scheme default port.
      scheme - the name of the scheme. null indicates the default scheme
      Since:
      4.4

    • HttpHost

      public HttpHost(InetAddress address, int port)
      Creates HttpHost instance with the default scheme and the given inet address and port.
      Parameters:
      address - the inet address.
      port - the port number. -1 indicates the scheme default port.
      Since:
      4.3

    • HttpHost

      public HttpHost(InetAddress address)
      Creates HttpHost instance with the default scheme and port and the given inet address.
      Parameters:
      address - the inet address.
      Since:
      4.3

    • HttpHost

      public HttpHost(HttpHost httphost)
      Copy constructor for HttpHost.
      Parameters:
      httphost - the HTTP host to copy details from

  • Method Details

    • create

      public static HttpHost create(String s)
      Creates HttpHost instance from string. Text may not contain any blanks.
      Since:
      4.4

    • getHostName

      public String getHostName()
      Returns the host name.
      Returns:
      the host name (IP or DNS name)

    • getPort

      public int getPort()
      Returns the port.
      Returns:
      the host port, or -1 if not set

    • getSchemeName

      public String getSchemeName()
      Returns the scheme name.
      Returns:
      the scheme name

    • getAddress

      public InetAddress getAddress()
      Returns the inet address if explicitly set by a constructor, null otherwise.
      Returns:
      the inet address
      Since:
      4.3

    • toURI

      public String toURI()
      Return the host URI, as a string.
      Returns:
      the host URI

    • toHostString

      public String toHostString()
      Obtains the host string, without scheme prefix.
      Returns:
      the host string, for example localhost:8080

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • hashCode

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

    • clone

      public Object clone() throws CloneNotSupportedException
      Overrides:
      clone in class Object
      Throws:
      CloneNotSupportedException