加载中...
The Wayback Machine - https://sup1a9wrlpyh5li9ro.vcoronado.top/web/20090228220135/http://developer.android.com:80/reference/java/net/ProxySelector.html
public abstract class

ProxySelector

extends Object
java.lang.Object
   ↳ java.net.ProxySelector

Class Overview

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.
[Expand]
Inherited Methods
From class java.lang.Object

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").