Docs4dev
Docs
openjdk / 21 / java.base / java / net / proxy.html

Class Proxy

java.lang.Object
java.net.Proxy 
public class Proxy extends Object
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:

Nested Class Summary

Modifier and Type Class Description
static enum  Proxy.Type
Represents the proxy type.

Field Summary

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

Constructor Summary

Constructor Description
Proxy(Proxy.Type type, SocketAddress sa)
Creates an entry representing a PROXY connection.

Method Summary

Modifier and Type Method Description
SocketAddress address()
Returns the socket address of the proxy, or null if it's a direct connection.
final boolean equals(Object obj)
Compares this object against the specified object.
final 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 declared in class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

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 Details

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 - when the type and the address are incompatible

Method Details

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 it's 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 in class Object
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 in class Object
Parameters:
obj - the object to compare against.
Returns:
true if the objects are the same; false otherwise.
See Also:

hashCode

public final int hashCode()
Returns a hashcode for this Proxy.
Overrides:
hashCode in class Object
Returns:
a hash code value for this Proxy.
See Also:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/net/Proxy.html