モジュール java.base
パッケージ 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()
      環境にデフォルトで提供されるソケット・ファクトリのコピーを返します。
    • コンストラクタの詳細

      • ServerSocketFactory

        protected ServerSocketFactory()
        サーバー・ソケット・ファクトリを作成します。
    • メソッドの詳細

      • getDefault

        public static ServerSocketFactory getDefault()
        環境にデフォルトで提供されるソケット・ファクトリのコピーを返します。
        戻り値:
        ServerSocketFactory
      • 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(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(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(int, int, java.net.InetAddress)