Proxy (Java Platform SE 6) (original) (raw)

java.net

Class Proxy

java.lang.Object extended by java.net.Proxy

public class Proxy

This class represents a proxy setting, typically a type (http, socks) and a socket address. A Proxy is an immutable object.

Since:

1.5

See Also:

ProxySelector

Nested Class Summary
static class	Proxy.Type Represents the proxy type.

Field Summary
static Proxy	NO_PROXY A proxy setting that represents a DIRECT connection, basically telling the protocol handler not to use any proxying.

Constructor Summary
[Proxy](../../java/net/Proxy.html#Proxy%28java.net.Proxy.Type, java.net.SocketAddress%29)(Proxy.Type type,SocketAddress sa) Creates an entry representing a PROXY connection.

Method Summary
SocketAddress	address() Returns the socket address of the proxy, or null if its a direct connection.
boolean	equals(Object obj) Compares this object against the specified object.
int	hashCode() Returns a hashcode for this Proxy.
String	toString() Constructs a string representation of this Proxy.
Proxy.Type	type() Returns the proxy type.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Field Detail

NO_PROXY

public static final Proxy NO_PROXY

A proxy setting that represents a DIRECT connection, basically telling the protocol handler not to use any proxying. Used, for instance, to create sockets bypassing any other global proxy settings (like SOCKS):

Socket s = new Socket(Proxy.NO_PROXY);

Constructor Detail

Proxy

public Proxy(Proxy.Type type, SocketAddress sa)

Creates an entry representing a PROXY connection. Certain combinations are illegal. For instance, for types Http, and Socks, a SocketAddress must be provided.

Use the Proxy.NO_PROXY constant for representing a direct connection.

Parameters:

type - the Type of the proxy

sa - the SocketAddress for that proxy

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - when the type and the address are incompatible

Method Detail

type

public Proxy.Type type()

Returns the proxy type.

Returns:

a Type representing the proxy type

address

public SocketAddress address()

Returns the socket address of the proxy, or null if its a direct connection.

Returns:

a SocketAddress representing the socket end point of the proxy

toString

public String toString()

Constructs a string representation of this Proxy. This String is constructed by calling toString() on its type and concatenating " @ " and the toString() result from its address if its type is not DIRECT.

Overrides:

[toString](../../java/lang/Object.html#toString%28%29) in class [Object](../../java/lang/Object.html "class in java.lang")

Returns:

a string representation of this object.

equals

public final boolean equals(Object obj)

Compares this object against the specified object. The result is true if and only if the argument is not null and it represents the same proxy as this object.

Two instances of Proxy represent the same address if both the SocketAddresses and type are equal.

Overrides:

[equals](../../java/lang/Object.html#equals%28java.lang.Object%29) in class [Object](../../java/lang/Object.html "class in java.lang")

Parameters:

obj - the object to compare against.

Returns:

true if the objects are the same;false otherwise.

hashCode

public final int hashCode()

Returns a hashcode for this Proxy.

Overrides:

[hashCode](../../java/lang/Object.html#hashCode%28%29) in class [Object](../../java/lang/Object.html "class in java.lang")

Returns:

a hash code value for this Proxy.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Scripting on this page tracks web page traffic, but does not change the content in any way.