java.net

クラス ProxySelector

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() システム全体のプロキシセレクタを取得します。
abstract List<Proxy>	select(URI uri) リソースへのアクセスに使用するプロトコルと、リソースへのアクセス先となるアドレスに基づいて、適用可能なすべてのプロキシを選択します。
static void	setDefault(ProxySelector ps) システム全体のプロキシセレクタを設定 (または設定解除) します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

ProxySelector

public ProxySelector()

メソッドの詳細

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
• FTP 接続の場合は ftp 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 の場合