org.apache.commons.httpclient

Class HostConfiguration

Implemented Interfaces:
Cloneable

public class HostConfiguration
extends java.lang.Object
implements 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.
Authors:
Michael Becke
Mike Bowler
Oleg Kalnichevski
Laura Werner
Since:
2.0

Field Summary

static HostConfiguration
ANY_HOST_CONFIGURATION
A value to represent any host configuration, instead of using something like null.

Constructor Summary

HostConfiguration()
Constructor for HostConfiguration.
HostConfiguration(HostConfiguration hostConfiguration)
Copy constructor for HostConfiguration

Method Summary

Object
clone()
boolean
equals(Object o)
String
getHost()
Returns the host.
String
getHostURL()
Return the host url.
InetAddress
getLocalAddress()
Return the local address to be used when creating connections.
HostParams
getParams()
Returns HTTP protocol parameters associated with this host.
int
getPort()
Returns the port.
Protocol
getProtocol()
Returns the protocol.
String
getProxyHost()
Returns the proxyHost.
int
getProxyPort()
Returns the proxyPort.
String
getVirtualHost()
Deprecated. use HostParams
int
hashCode()
boolean
hostEquals(HttpConnection connection)
Tests if the host configuration equals the configuration set on the connection.
boolean
isHostSet()
Deprecated. no longer used
boolean
isProxySet()
Deprecated. no longer used
boolean
proxyEquals(HttpConnection connection)
Tests if the proxy configuration equals the configuration set on the connection.
void
setHost(String host)
Set the given host.
void
setHost(String host, String virtualHost, int port, Protocol protocol)
Deprecated. #setHost(String, int, Protocol)
void
setHost(String host, int port)
Sets the given host and port.
void
setHost(String host, int port, String protocol)
Sets the given host, port and protocol
void
setHost(String host, int port, Protocol protocol)
Sets the given host, port and protocol.
void
setHost(HttpHost host)
Sets the given host
void
setHost(URI uri)
Sets the protocol, host and port from the given URI.
void
setLocalAddress(InetAddress localAddress)
Set the local address to be used when creating connections.
void
setParams(HostParams params)
Assigns HTTP protocol parameters specific to this host.
void
setProxy(String proxyHost, int proxyPort)
Set the proxy settings.
void
setProxyHost(ProxyHost proxyHost)
Sets the given proxy host
String
toString()

Field Details

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 Details

HostConfiguration

public HostConfiguration()
Constructor for HostConfiguration.

HostConfiguration

public HostConfiguration(HostConfiguration hostConfiguration)
Copy constructor for HostConfiguration
Parameters:
hostConfiguration - the hostConfiguration to copy

Method Details

clone

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

equals

public boolean equals(Object o)
See Also:
java.lang.Object.equals(java.lang.Object)

getHost

public String getHost()
Returns the host.
Returns:
the host(IP or DNS name), or null if not set

getHostURL

public String getHostURL()
Return the host url.
Returns:
The host url.

getLocalAddress

public 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

getParams

public HostParams getParams()
Returns HTTP protocol parameters associated with this host.
Returns:
HTTP parameters.
Since:
3.0

getPort

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

getProtocol

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

getProxyHost

public String getProxyHost()
Returns the proxyHost.
Returns:
the proxy host, or null if not set

getProxyPort

public int getProxyPort()
Returns the proxyPort.
Returns:
the proxy port, or -1 if not set

getVirtualHost

public String getVirtualHost()

Deprecated. use HostParams

Returns the virtual host.
Returns:
the virtual host name, or null if not set

hashCode

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

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

isHostSet

public boolean isHostSet()

Deprecated. no longer used

Returns true if the host is set.
Returns:
true if the host is set.

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.

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

setHost

public void setHost(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(String host,
                    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(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(String host,
                    int port,
                    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(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(HttpHost host)
Sets the given host
Parameters:
host - the host

setHost

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

setLocalAddress

public void setLocalAddress(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

setParams

public void setParams(HostParams params)
Assigns HTTP protocol parameters specific to this host.
Since:
3.0
See Also:
HostParams

setProxy

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

setProxyHost

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

toString

public String toString()
See Also:
java.lang.Object.toString()

Copyright (c) 1999-2005 - Apache Software Foundation