compact1, compact2, compact3

java.net

Class ProxySelector

java.lang.Object

java.net.ProxySelector

public abstract class ProxySelector
extends Object

选择要使用的代理服务器，如果有的话，当连接到由一个网址引用的网络资源时。代理的选择是这个类的一个具体子类，通过调用 setDefault方法注册。目前注册代理选择器可以通过调用 getDefault方法检索。

当一个代理选择注册，例如，一个子类的URLConnection类应该号召每个URL请求select方法使代理选择器可以决定是否直接或代理的连接应使用。的select方法返回在一个首选的连接方法集合迭代器。

如果无法建立连接到代理（代理或袜子）服务器，然后调用程序应该调用代理选择的connectFailed方法通知代理选择代理服务器不可用。

默认的代理选择并执行代理设置的相关set of System Properties。

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
ProxySelector()

方法摘要

Modifier and Type	Method and Description
abstract void	connectFailed(URI uri, SocketAddress sa, IOException ioe) 调用来表示无法建立到代理服务器/袜子服务器的连接。
static ProxySelector	getDefault() 获取系统范围的代理选择器。
abstract List<Proxy>	select(URI uri) 选择基于该协议访问资源的所有适用的代理和一个目的地地址来访问资源。
static void	setDefault(ProxySelector ps) 集（或设定）系统范围的代理选择。

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxySelector

public ProxySelector()

方法详细信息

getDefault

public static ProxySelector getDefault()

获取系统范围的代理选择器。

结果

全系统 ProxySelector

异常

SecurityException如果安全管理器已经安装，它否认 NetPermission ("getProxySelector")

从以下版本开始：

一点五

另请参见：

setDefault(ProxySelector)

setDefault

public static void setDefault(ProxySelector ps)

集（或设定）系统范围的代理选择。注意：非标准协议处理程序可能会忽略此设置。

参数

ps的HTTP代理选择器，或 null未设置代理选择。

异常

SecurityException如果安全管理器已经安装，它否认 NetPermission ("setProxySelector")

从以下版本开始：

一点五

另请参见：

getDefault()

select

public abstract List<Proxy> select(URI uri)

选择基于该协议访问资源的所有适用的代理和一个目的地地址来访问资源。URI的格式定义如下：

• HTTP URI的HTTP连接
• HTTPS URI的HTTPS连接
• TCP客户端套接字的连接socket://host:port
  

参数

uri的URI，连接要求

结果

代理列表。在列表中的每个元素的类型是 Proxy；当没有代理可用，列表将包含类型 Proxy表示直接连接一个元素。

异常

IllegalArgumentException -如果参数为空

connectFailed

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

调用来表示无法建立到代理服务器/袜子服务器的连接。此方法的实现可以暂时解除代理或重新排序 select(URI)代理返回的序列，使用地址和异常捕获时尝试连接。

参数

uri的URI，SA代理失败的服务。

sa -代理/服务器套接字地址

ioe的I / O的异常被抛出时，连接失败。

异常

IllegalArgumentException -如果任一参数为null