javax.net

クラス ServerSocketFactory

java.lang.Object

javax.net.ServerSocketFactory

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

SSLServerSocketFactory

public abstract class ServerSocketFactory
extends Object

このクラスは、サーバーソケットを作成します。このクラスを別のファクトリのサブクラスに入れると、特定の種類のサーバーソケットが作成されます。これにより、ソケットレベルの public 機能を追加するための汎用的なフレームワークが提供されます。このクラスは、サーバー側のソケットファクトリとして機能し、作成されるソケットに関連するポリシーを取り込むことができます。

ソケットファクトリと同様に、サーバーソケットファクトリのインスタンスにも、ソケットを作成するためのメソッドが組み込まれています。また、環境固有のサーバーソケットファクトリもデフォルトで提供されます。このフレームワークでは、多くの場合、カスタマイズした独自のファクトリが使用されます。

導入されたバージョン:

1.4

関連項目:

SocketFactory

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

コンストラクタ

修飾子	コンストラクタと説明
protected	ServerSocketFactory() サーバーソケットファクトリを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
ServerSocket	createServerSocket() バインドされていないサーバーソケットを返します。
abstract ServerSocket	createServerSocket(int port) 指定されたポートにバインドされているサーバーソケットを返します。
abstract ServerSocket	createServerSocket(int port, int backlog) 指定されたポートにバインドされ、指定された接続バックログを使用するサーバーソケットを返します。
abstract ServerSocket	createServerSocket(int port, int backlog, InetAddress ifAddress) 指定されたポートにバインドされ、指定された待機バックログとローカル IP を使用するサーバーソケットを返します。
static ServerSocketFactory	getDefault() 環境にデフォルトで提供されるソケットファクトリのコピーを返します。

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

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

コンストラクタの詳細

ServerSocketFactory

protected ServerSocketFactory()

サーバーソケットファクトリを作成します。

メソッドの詳細

getDefault

public static ServerSocketFactory getDefault()

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

戻り値:

ServerSocketFactory

createServerSocket

public ServerSocket createServerSocket()
                                throws IOException

バインドされていないサーバーソケットを返します。返されるソケットは、このファクトリに指定されたソケットオプション (受信タイムアウトなど) を使用して構成されています。

戻り値:

バインドされていないソケット

例外:

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

関連項目:

ServerSocket.bind(java.net.SocketAddress), ServerSocket.bind(java.net.SocketAddress, int), ServerSocket.ServerSocket()

createServerSocket

public abstract ServerSocket createServerSocket(int port)
                                         throws IOException

指定されたポートにバインドされているサーバーソケットを返します。返されるソケットは、このファクトリに指定されたソケットオプション (受信タイムアウトなど) を使用して構成されています。

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

パラメータ:

port - 待機するポート

戻り値:

ServerSocket

例外:

IOException - ネットワークエラーの場合。

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

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

関連項目:

SecurityManager.checkListen(int), ServerSocket.ServerSocket(int)

createServerSocket

public abstract ServerSocket createServerSocket(int port,
                              int backlog)
                                         throws IOException

指定されたポートにバインドされ、指定された接続バックログを使用するサーバーソケットを返します。返されるソケットは、このファクトリに指定されたソケットオプション (受信タイムアウトなど) を使用して構成されています。

backlog 引数は、0 より大きい正の値である必要があります。渡された値が 0 以下の場合は、デフォルトの値が使用されます。

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

パラメータ:

port - 待機するポート

backlog - キュー内の接続の数

戻り値:

ServerSocket

例外:

IOException - ネットワークエラーの場合。

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

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

関連項目:

SecurityManager.checkListen(int), ServerSocket.ServerSocket(int, int)

createServerSocket

public abstract ServerSocket createServerSocket(int port,
                              int backlog,
                              InetAddress ifAddress)
                                         throws IOException

指定されたポートにバインドされ、指定された待機バックログとローカル IP を使用するサーバーソケットを返します。

複数ホームのホストの場合は、ifAddress 引数を使用すれば、特定のアドレスに対する接続要求だけを受信する ServerSocket を作成できます。ifAddress が null の場合は、すべてのローカルアドレスに対する接続を受け取ります。返されるソケットは、このファクトリに指定されたソケットオプション (受信タイムアウトなど) を使用して構成されています。

backlog 引数は、0 より大きい正の値である必要があります。渡された値が 0 以下の場合は、デフォルトの値が使用されます。

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

パラメータ:

port - 待機するポート

backlog - キュー内の接続の数

ifAddress - 使用するネットワークインタフェースのアドレス

戻り値:

ServerSocket

例外:

IOException - ネットワークエラーの場合。

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

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

関連項目:

SecurityManager.checkListen(int), ServerSocket.ServerSocket(int, int, java.net.InetAddress)