Android
java.net
public abstract class

java.net.ProxySelector

java.lang.Object
java.net.ProxySelector

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.

Summary

Public Constructors

            ProxySelector()
Constructor method.

Public Methods

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

Details

Public Constructors

public ProxySelector()

Constructor method.

Public Methods

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.

public static ProxySelector getDefault()

Gets system default ProxySelector.

Returns

  • system default ProxySelector.

Throws

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

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.

    public static void setDefault(ProxySelector selector)

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

    Throws

    If a security manager is installed and it doesn't have NetPermission("setProxySelector").
    Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48