- java.lang.Object
-
- java.net.ProxySelector
-
public abstract class ProxySelector extends Object
URLで参照されるネットワーク・リソースへの接続時に使用するプロキシ・サーバーが存在する場合に、それらを選択します。 プロキシ・セレクタはこのクラスの具象サブクラスであり、setDefault
メソッドを呼び出すことで登録されます。 現在登録されているプロキシ・セレクタを取得するには、getDefault
メソッドを呼び出します。プロキシ・セレクタが登録されている場合、たとえば、URLConnectionクラスのサブクラスは、URL要求ごとにその
select
メソッドを呼び出せば、そのプロキシ・セレクタが、直接接続、プロキシ接続のいずれを使用すべきかを決定できます。select
メソッドは、推奨の接続方法でコレクションのイテレータを返します。プロキシ(PROXYまたはSOCKS)サーバーへの接続が確立できない場合、呼出し元は、プロキシ・セレクタの
connectFailed
メソッドを呼び出すことで、そのプロキシ・サーバーが使用不可能であることをプロキシ・セレクタに通知します。デフォルトのプロキシ・セレクタは、プロキシ設定に関係があるシステム・プロパティのセットを適用します。
- 導入されたバージョン:
- 1.5
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 ProxySelector()
-
メソッドのサマリー
修飾子と型 メソッド 説明 abstract void
connectFailed(URI uri, SocketAddress sa, IOException ioe)
あるPROXYまたはSOCKSサーバーへの接続を確立できなかったことを示すために呼び出されます。static ProxySelector
getDefault()
システム全体のプロキシ・セレクタを取得します。static ProxySelector
of(InetSocketAddress proxyAddress)
指定されたプロキシ・アドレスをすべてのHTTPおよびHTTPSリクエストに使用するProxySelectorを返します。abstract List<Proxy>
select(URI uri)
リソースへのアクセスに使用するプロトコルと、リソースへのアクセス先となるアドレスに基づいて、適用可能なすべてのプロキシを選択します。static void
setDefault(ProxySelector ps)
システム全体のプロキシ・セレクタを設定(または設定解除)します。
-
-
-
メソッドの詳細
-
getDefault
public static ProxySelector getDefault()
システム全体のプロキシ・セレクタを取得します。- 戻り値:
- システム全体の
ProxySelector
- 例外:
SecurityException
- セキュリティ・マネージャがインストールされていて、それがNetPermission
(getProxySelector)
を拒否した場合- 導入されたバージョン:
- 1.5
- 関連項目:
setDefault(ProxySelector)
-
setDefault
public static void setDefault(ProxySelector ps)
システム全体のプロキシ・セレクタを設定(または設定解除)します。 注: 標準でないプロトコル・ハンドラは、この設定を無視する可能性があります。- パラメータ:
ps
−HTTPプロキシ・セレクタ。プロキシセレクタを設定解除する場合はnull
。- 例外:
SecurityException
- セキュリティ・マネージャがインストールされていて、それがNetPermission
(setProxySelector)
を拒否した場合- 導入されたバージョン:
- 1.5
- 関連項目:
getDefault()
-
select
public abstract List<Proxy> select(URI uri)
リソースへのアクセスに使用するプロトコルと、リソースへのアクセス先となるアドレスに基づいて、適用可能なすべてのプロキシを選択します。 URIの形式は次のように定義されています。- HTTP接続の場合はhttp URI
- HTTPS接続の場合はhttps URI
- TCPクライアント・ソケット接続の場合は
socket://host:port
- パラメータ:
uri
−接続が必要なURI- 戻り値:
- プロキシのリスト。 リストの各要素のタイプは
Proxy
です。使用できるプロキシがない場合、リストには直接接続を表すタイプProxy
の要素が1つ含まれます。 - 例外:
IllegalArgumentException
- 引数がnullの場合
-
connectFailed
public abstract void connectFailed(URI uri, SocketAddress sa, IOException ioe)
あるPROXYまたはSOCKSサーバーへの接続を確立できなかったことを示すために呼び出されます。 このメソッドの実装は、アドレスと、接続を試みたときにキャッチされたIOExceptionに基づいて、プロキシを一時的に削除したり、select(URI)
から返されるプロキシの順番を並べ替えたりすることができます。- パラメータ:
uri
−saのプロキシが提供できなかったURI。sa
−PROXYまたはSOCKSサーバーのソケット・アドレスioe
−接続の失敗時に入出力例外がスローされた場合。- 例外:
IllegalArgumentException
- どちらかの引数がnullの場合
-
of
public static ProxySelector of(InetSocketAddress proxyAddress)
指定されたプロキシ・アドレスをすべてのHTTPおよびHTTPSリクエストに使用するProxySelectorを返します。 プロキシがnull
の場合、プロキシは無効になります。- パラメータ:
proxyAddress
- プロキシのアドレス- 戻り値:
- ProxySelector
- 導入されたバージョン:
- 9
-
-