|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.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 nullpublic 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 © 1993, 2010, Oracle and/or its affiliates. All rights reserved.