compact1, compact2, compact3

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)