java.lang.Object | |
↳ | java.net.ProxySelector |
Known Direct Subclasses |
Selects the proxy server to use, if any, when connecting to the
network resource referenced by a URL. A proxy selector is a
concrete sub-class of this class and is registered by invoking the
setDefault
method. The
currently registered proxy selector can be retrieved by calling
getDefault
method.
When a proxy selector is registered, for instance, a subclass
of URLConnection class should call the select
method for each URL request so that the proxy selector can decide
if a direct, or proxied connection should be used. The select
method returns an iterator over a collection with
the preferred connection approach.
If a connection cannot be established to a proxy (PROXY or
SOCKS) servers then the caller should call the proxy selector's
connectFailed
method to notify the proxy
selector that the proxy server is unavailable.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Called to indicate that a connection could not be established
to a proxy/socks server.
| |||||||||||
Gets the system-wide proxy selector.
| |||||||||||
Selects all the applicable proxies based on the protocol to
access the resource with and a destination address to access
the resource at.
| |||||||||||
Sets (or unsets) the system-wide proxy selector.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Called to indicate that a connection could not be established
to a proxy/socks server. An implementation of this method can
temporarily remove the proxies or reorder the sequence of
proxies returned by select(URI)
, using the address
and the IOException caught when trying to connect.
uri | The URI that the proxy at sa failed to serve. |
---|---|
sa | The socket address of the proxy/SOCKS server |
ioe | The I/O exception thrown when the connect failed. |
IllegalArgumentException | if either argument is null |
---|
Gets the system-wide proxy selector.
ProxySelector
SecurityException | If a security manager has been installed and it denies
NetPermission ("getProxySelector") |
---|
Selects all the applicable proxies based on the protocol to access the resource with and a destination address to access the resource at. The format of the URI is defined as follow:
socket://host:port
uri | The URI that a connection is required to |
---|
IllegalArgumentException | if the argument is null |
---|
Sets (or unsets) the system-wide proxy selector. Note: non-standard protocol handlers may ignore this setting.
ps | The HTTP proxy selector, or
null to unset the proxy selector. |
---|
SecurityException | If a security manager has been installed and it denies
NetPermission ("setProxySelector") |
---|