java.net
Class ProxySelector

java.lang.Object
  java.net.ProxySelector

Direct Known Subclasses:

ProxySelectorImpl

public abstract class ProxySelector
extends Object

Selects applicable proxies when connecting to network resouce represented by a URI. An implementation of ProxySelector should be a concrete subclass of ProxySelector. Method select returns a list of proxies according to the uri. If a connection can't be established, the caller should notify proxy selector by invoking connectFailed method.

A proxy selector can be registered/unregistered by calling setDefault method and retrieved by calling getDefault method.

Constructor Summary

ProxySelector()
Constructor method.

Method Summary

abstract void	connectFailed(URI uri, SocketAddress sa, IOException ioe) If the connection can not be established to the proxy server, this method will be called.
static ProxySelector	getDefault() Gets system default ProxySelector.
abstract List<Proxy>	select(URI uri) Gets applicable proxies based on the accessing protocol of uri.
static void	setDefault(ProxySelector selector) Sets system default ProxySelector.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ProxySelector

public ProxySelector()

Constructor method.

Method Detail

getDefault

public static ProxySelector getDefault()

Gets system default ProxySelector.

Returns:

system default ProxySelector.

Throws:

SecurtiyException - If a security manager is installed and it doesn't have NetPermission("getProxySelector").

setDefault

public static void setDefault(ProxySelector selector)

Sets system default ProxySelector. Unsets system default ProxySelector if selector is null.

Throws:

SecurtiyException - If a security manager is installed and it doesn't have NetPermission("setProxySelector").

select

public abstract List<Proxy> select(URI uri)

Gets applicable proxies based on the accessing protocol of uri. The format of URI is defined as below:

http URI stands for http connection.

https URI stands for https connection.

ftp URI stands for ftp connection.

socket:://ip:port URI stands for tcp client sockets connection.

Parameters:

uri - the destination URI object.

Returns:

a list contains all applicable proxies. If no proxy is available, returns a list only contains one element Proxy.NO_PROXY.

Throws:

IllegalArgumentException - If any argument is null.

connectFailed

public abstract void connectFailed(URI uri,
                                   SocketAddress sa,
                                   IOException ioe)

If the connection can not be established to the proxy server, this method will be called. An implementation may adjust proxy the sequence of proxies returned by select(String, String).

Parameters:

uri - the URI that the connection fails to connect to.

sa - SocketAddress of the proxy.

ioe - The IOException which is thrown during connection establishment.

Throws:

IllegalArgumentException - If any argument is null.