javax.net

クラス SocketFactory

java.lang.Object

javax.net.SocketFactory

直系の既知のサブクラス:

SSLSocketFactory

public abstract class SocketFactory
extends Object

このクラスは、ソケットを作成します。このクラスを別のファクトリのサブクラスに入れると、特定の種類のソケットが作成され、ソケットレベルの public 機能を追加するための汎用的なフレームワークが提供されます。

ソケットファクトリを使うと、構築するソケットに関する一連のポリシーを簡単に取得し、ソケットを要求する特別なコード構成を必要としない方法でソケットを作成できます。

• ファクトリとソケットに多相性があるため、同一アプリケーションコードに種類の異なるファクトリを渡すだけで、そのコードでそれらのソケットを使用できる。
• ソケット構築時に使用するパラメータを使って、ファクトリ自身をカスタマイズできます。たとえば、ファクトリをカスタマイズして、異なるネットワークタイムアウトのソケットや、構成済みのセキュリティーパラメータを返すことができます。
• アプリケーションに返されるソケットを java.net.Socket のサブクラスにすると、圧縮、セキュリティー、レコードのマーク付け、統計の収集、およびファイアウォールのトンネルなどの機能を、新しい API から直接使用できる。

ファクトリクラスは、環境固有の構成メカニズムによって指定されます。たとえば、getDefault メソッドは、特定のユーザーまたはアプレットに適したファクトリを返すことができます。また、フレームワークは、特定の目的に合わせてカスタマイズされたファクトリを使用できます。

導入されたバージョン:

1.4

関連項目:

ServerSocketFactory

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	SocketFactory() SocketFactory を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Socket	createSocket() 接続されていないソケットを作成します。
abstract Socket	createSocket(InetAddress host, int port) ソケットを作成し、指定されたアドレスの指定されたポート番号に接続します。
abstract Socket	createSocket(InetAddress address, int port, InetAddress localAddress, int localPort) ソケットを作成し、指定されたリモートポート上の指定されたリモートアドレスに接続します。
abstract Socket	createSocket(String host, int port) ソケットを作成し、指定されたリモートポート上の指定されたリモートホストに接続します。
abstract Socket	createSocket(String host, int port, InetAddress localHost, int localPort) ソケットを作成し、指定されたリモートポート上の指定されたリモートホストに接続します。
static SocketFactory	getDefault() 環境にデフォルトで提供されるソケットファクトリのコピーを返します。

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

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

コンストラクタの詳細

SocketFactory

protected SocketFactory()

SocketFactory を作成します。

メソッドの詳細

getDefault

public static SocketFactory getDefault()

環境にデフォルトで提供されるソケットファクトリのコピーを返します。

戻り値:

デフォルトの SocketFactory

createSocket

public Socket createSocket()
                    throws IOException

接続されていないソケットを作成します。

戻り値:

接続されていないソケット

例外:

IOException - ソケットを作成できない場合

関連項目:

Socket.connect(java.net.SocketAddress), Socket.connect(java.net.SocketAddress, int), Socket.Socket()

createSocket

public abstract Socket createSocket(String host,
                  int port)
                             throws IOException,
                                    UnknownHostException

ソケットを作成し、指定されたリモートポート上の指定されたリモートホストに接続します。ソケットは、このファクトリに設定されているソケットオプションを使用して構成されます。

セキュリティーマネージャーが存在する場合、その checkConnectメソッドが、ホストアドレスと port を引数に指定して呼び出されます。この結果、SecurityException がスローされることがあります。

パラメータ:

host - 接続先のサーバーホスト名、またはループバックアドレスの場合は null。

port - サーバーポート

戻り値:

Socket

例外:

IOException - ソケットの作成時に入出力エラーが発生した場合。

SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドでこの操作が許可されていない場合。

UnknownHostException - ホストが不明である場合

IllegalArgumentException - port パラメータが指定された有効なポート値の範囲 (0 から 65535) 外である場合。

関連項目:

SecurityManager.checkConnect(java.lang.String, int), Socket.Socket(String, int)

createSocket

public abstract Socket createSocket(String host,
                  int port,
                  InetAddress localHost,
                  int localPort)
                             throws IOException,
                                    UnknownHostException

ソケットを作成し、指定されたリモートポート上の指定されたリモートホストに接続します。このソケットは、指定されたローカルアドレスとポートにバインドされます。ソケットは、このファクトリに設定されているソケットオプションを使用して構成されます。

セキュリティーマネージャーが存在する場合、その checkConnectメソッドが、ホストアドレスと port を引数に指定して呼び出されます。この結果、SecurityException がスローされることがあります。

パラメータ:

host - 接続先のサーバーホスト名、またはループバックアドレスの場合は null。

port - サーバーポート

localHost - ソケットのバインド先のローカルアドレス

localPort - ソケットのバインド先のローカルポート

戻り値:

Socket

例外:

IOException - ソケットの作成時に入出力エラーが発生した場合。

SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドでこの操作が許可されていない場合。

UnknownHostException - ホストが不明である場合

IllegalArgumentException - port パラメータまたは localPort パラメータが指定された有効なポート値の範囲 (0 から 65535) 外である場合。

関連項目:

SecurityManager.checkConnect(java.lang.String, int), Socket.Socket(String, int, java.net.InetAddress, int)

createSocket

public abstract Socket createSocket(InetAddress host,
                  int port)
                             throws IOException

ソケットを作成し、指定されたアドレスの指定されたポート番号に接続します。ソケットは、このファクトリに設定されているソケットオプションを使用して構成されます。

セキュリティーマネージャーが存在する場合、その checkConnectメソッドが、ホストアドレスと port を引数に指定して呼び出されます。この結果、SecurityException がスローされることがあります。

パラメータ:

host - サーバーホスト

port - サーバーポート

戻り値:

Socket

例外:

IOException - ソケットの作成時に入出力エラーが発生した場合。

SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドでこの操作が許可されていない場合。

IllegalArgumentException - port パラメータが指定された有効なポート値の範囲 (0 から 65535) 外である場合。

NullPointerException - host が null である場合。

関連項目:

SecurityManager.checkConnect(java.lang.String, int), Socket.Socket(java.net.InetAddress, int)

createSocket

public abstract Socket createSocket(InetAddress address,
                  int port,
                  InetAddress localAddress,
                  int localPort)
                             throws IOException

ソケットを作成し、指定されたリモートポート上の指定されたリモートアドレスに接続します。このソケットは、指定されたローカルアドレスとポートにバインドされます。ソケットは、このファクトリに設定されているソケットオプションを使用して構成されます。

セキュリティーマネージャーが存在する場合、その checkConnectメソッドが、ホストアドレスと port を引数に指定して呼び出されます。この結果、SecurityException がスローされることがあります。

パラメータ:

address - サーバーのネットワークアドレス

port - サーバーポート

localAddress - クライアントのネットワークアドレス

localPort - クライアントポート

戻り値:

Socket

例外:

IOException - ソケットの作成時に入出力エラーが発生した場合。

SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドでこの操作が許可されていない場合。

IllegalArgumentException - port パラメータまたは localPort パラメータが指定された有効なポート値の範囲 (0 から 65535) 外である場合。

NullPointerException - address が null である場合。

関連項目:

SecurityManager.checkConnect(java.lang.String, int), Socket.Socket(java.net.InetAddress, int, java.net.InetAddress, int)