クラスSocketFactory

java.lang.Object
javax.net.SocketFactory
直系の既知のサブクラス:
SSLSocketFactory

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

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

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

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

導入されたバージョン:
1.4
関連項目:
  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    SocketFactoryを作成します。
  • メソッドのサマリー

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

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    このオブジェクトのコピーを作成して、返します。
    boolean
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    このObjectの実行時クラスを返します。
    int
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    オブジェクトの文字列表現を返します。
    final void
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
  • コンストラクタの詳細

    • SocketFactory

      protected SocketFactory()
      SocketFactoryを作成します。
  • メソッドの詳細

    • getDefault

      public static SocketFactory getDefault()
      環境にデフォルトで提供されるソケット・ファクトリのコピーを返します。
      戻り値:
      デフォルトのSocketFactory
    • createSocket

      public Socket createSocket() throws IOException
      接続されていないソケットを作成します。
      戻り値:
      接続されていないソケット
      スロー:
      IOException - ソケットを作成できない場合
      関連項目:
    • createSocket

      public abstract Socket createSocket(String host, int port) throws IOException, UnknownHostException
      ソケットを作成し、指定されたリモート・ポート上の指定されたリモート・ホストに接続します。 ソケットは、このファクトリに設定されているソケット・オプションを使用して構成されます。
      パラメータ:
      host - 接続先のサーバー・ホスト名、またはループバック・アドレスの場合はnull
      port - サーバー・ポート
      戻り値:
      Socket
      スロー:
      IOException - ソケットの作成時に入出力エラーが発生した場合
      UnknownHostException - ホストが不明である場合
      IllegalArgumentException - portパラメータが指定された有効なポート値の範囲(0から65535)外である場合。
      関連項目:
    • createSocket

      public abstract Socket createSocket(String host, int port, InetAddress localHost, int localPort) throws IOException, UnknownHostException
      ソケットを作成し、指定されたリモート・ポート上の指定されたリモート・ホストに接続します。 このソケットは、指定されたローカル・アドレスとポートにバインドされます。 ソケットは、このファクトリに設定されているソケット・オプションを使用して構成されます。
      パラメータ:
      host - 接続先のサーバー・ホスト名、またはループバック・アドレスの場合はnull
      port - サーバー・ポート
      localHost - ソケットのバインド先のローカル・アドレス
      localPort - ソケットのバインド先のローカル・ポート
      戻り値:
      Socket
      スロー:
      IOException - ソケットの作成時に入出力エラーが発生した場合
      UnknownHostException - ホストが不明である場合
      IllegalArgumentException - portパラメータまたはlocalPortパラメータが指定された有効なポート値の範囲(0から65535)外である場合。
      関連項目:
    • createSocket

      public abstract Socket createSocket(InetAddress host, int port) throws IOException
      ソケットを作成し、指定されたアドレスの指定されたポート番号に接続します。 ソケットは、このファクトリに設定されているソケット・オプションを使用して構成されます。
      パラメータ:
      host - サーバー・ホスト
      port - サーバー・ポート
      戻り値:
      Socket
      スロー:
      IOException - ソケットの作成時に入出力エラーが発生した場合
      IllegalArgumentException - portパラメータが指定された有効なポート値の範囲(0から65535)外である場合。
      NullPointerException - hostがnullである場合。
      関連項目:
    • createSocket

      public abstract Socket createSocket(InetAddress address, int port, InetAddress localAddress, int localPort) throws IOException
      ソケットを作成し、指定されたリモート・ポート上の指定されたリモート・アドレスに接続します。 このソケットは、指定されたローカル・アドレスとポートにバインドされます。 ソケットは、このファクトリに設定されているソケット・オプションを使用して構成されます。
      パラメータ:
      address - サーバーのネットワーク・アドレス
      port - サーバー・ポート
      localAddress - クライアントのネットワーク・アドレス
      localPort - クライアント・ポート
      戻り値:
      Socket
      スロー:
      IOException - ソケットの作成時に入出力エラーが発生した場合
      IllegalArgumentException - portパラメータまたはlocalPortパラメータが指定された有効なポート値の範囲(0から65535)外である場合。
      NullPointerException - addressがnullである場合。
      関連項目: