|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.net.ProxySelector
public abstract class ProxySelector
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.
| Constructor Summary | |
|---|---|
ProxySelector()
|
|
| Method Summary | |
|---|---|
abstract void |
connectFailed(URI uri,
SocketAddress sa,
IOException ioe)
Called to indicate that a connection could not be established to a proxy/socks server. |
static ProxySelector |
getDefault()
Gets the system-wide proxy selector. |
abstract List<Proxy> |
select(URI uri)
Selects all the applicable proxies based on the protocol to access the resource with and a destination address to access the resource at. |
static void |
setDefault(ProxySelector ps)
Sets (or unsets) the system-wide proxy selector. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public ProxySelector()
| Method Detail |
|---|
public static ProxySelector getDefault()
ProxySelector
SecurityException - If a security manager has been installed and it denies
NetPermission("getProxySelector")setDefault(ProxySelector)public static void setDefault(ProxySelector ps)
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")getDefault()public abstract List<Proxy> select(URI uri)
socket://host:port
uri - The URI that a connection is required to
Proxy;
when no proxy is available, the list will
contain one element of type
Proxy
that represents a direct connection.
IllegalArgumentException - if either argument is null
public abstract void connectFailed(URI uri,
SocketAddress sa,
IOException ioe)
uri - The URI that the proxy at sa failed to serve.sa - The socket address of the proxy/SOCKS serverioe - The I/O exception thrown when the connect failed.
IllegalArgumentException - if either argument is null
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.