クラスInetSocketAddress

java.lang.Object
java.net.SocketAddress
java.net.InetSocketAddress
すべての実装されたインタフェース:
Serializable
public class InetSocketAddress extends SocketAddress
このクラスは、IPソケット・アドレス(IPアドレス+ポート番号)を実装します。これはペア(ホスト名+ポート番号)にすることもできます。その 合、ホスト名の解決が試みられます。 解決に失敗すると、そのアドレスは未解決と呼ばれるようになりますが、プロキシ経由の接続のような一部の環境ではま 使用することができます。

このクラスは、バインドまたは接続のためにソケットが使用する、または戻り値として使用する変更不可能なオブジェクトを提供します。

ワイルドカードは特殊なローカルIPアドレスです。 それは通常「任意」を意味しており、bind操作 けに使用できます。

導入されたバージョン:
1.4
関連 目:

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

    コンストラクタ
    コンストラクタ
    説明
    InetSocketAddress(int port)
    ソケット・アドレスを作成します。この 合、IPアドレスはワイルドカード・アドレスで、ポート番号は指定された値です。
    InetSocketAddress(String hostname, int port)
    ホスト名とポート番号からソケット・アドレスを作成します。
    InetSocketAddress(InetAddress addr, int port)
    IPアドレスとポート番号からソケット・アドレスを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static InetSocketAddress
    createUnresolved(String host, int port)
    ホスト名とポート番号から未解決のソケット・アドレスを作成します。
    final boolean
    equals(Object obj)
    このオブジェクトと指定されたオブジェクトを比較します。
    final InetAddress
    getAddress()
    InetAddressを取得します。
    final String
    getHostName()
    hostnameを取得します。
    final String
    getHostString()
    ホスト名または、ホスト名がない(リテラルを使用して作成された) 合は文字列形式のアドレスを返します。
    final int
    getPort()
    ポート番号を取得します。
    final int
    hashCode()
    このソケット・アドレスのハッシュ・コードを返します。
    final boolean
    isUnresolved()
    アドレスが解決されたかどうかを調べます。
    String
    toString()
    このInetSocketAddressの文字列表現を構築します。

    クラスjava.lang.Objectで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • コンストラクタの詳細

    • InetSocketAddress

      public InetSocketAddress(int port)
      ソケット・アドレスを作成します。この 合、IPアドレスはワイルドカード・アドレスで、ポート番号は指定された値です。

      有効なポート番号は0から65535の範囲です。 ポート番号がzeroの 合は、bind操作で一時的なポートが選択されます。

      パラメータ:
      port - ポート番号
      スロー:
      IllegalArgumentException - portパラメータが指定された有効なポート値の範囲外である 合。

    • InetSocketAddress

      public InetSocketAddress(InetAddress addr, int port)
      IPアドレスとポート番号からソケット・アドレスを作成します。

      有効なポート番号は0から65535の範囲です。 ポート番号がzeroの 合は、bind操作で一時的なポートが選択されます。

      アドレスがnullの 合は、ワイルドカード・アドレスが割り当てられます。

      パラメータ:
      addr－IPアドレス
      port - ポート番号
      スロー:
      IllegalArgumentException - portパラメータが指定された有効なポート値の範囲外である 合。

    • InetSocketAddress

      public InetSocketAddress(String hostname, int port)
      ホスト名とポート番号からソケット・アドレスを作成します。

      InetAddressへのホスト名の解決が試みられます。 その試みが失敗すると、そのアドレスには未解決のフラグが付けられます。

      有効なポート番号は0から65535の範囲です。 ポート番号がzeroの 合は、bind操作で一時的なポートが選択されます。

      パラメータ:
      hostname - ホスト名
      port - ポート番号
      スロー:
      IllegalArgumentException - ポート・パラメータが有効なポート値の範囲外にある 合、またはホスト名パラメータがnullの 合。
      関連 目:

  • メソッドの詳細

    • createUnresolved

      public static InetSocketAddress createUnresolved(String host, int port)
      ホスト名とポート番号から未解決のソケット・アドレスを作成します。

      InetAddressへのホスト名の解決は試みられません。 このアドレスには未解決のフラグが付けられます。

      有効なポート番号は0から65535の範囲です。 ポート番号がzeroの 合は、bind操作で一時的なポートが選択されます。

      パラメータ:
      host - ホスト名
      port - ポート番号
      戻り値:
      未解決のソケット・アドレスを表すInetSocketAddress
      スロー:
      IllegalArgumentException - ポート・パラメータが有効なポート値の範囲外にある 合、またはホスト名パラメータがnullの 合。
      導入されたバージョン:
      1.5
      関連 目:

    • getPort

      public final int getPort()
      ポート番号を取得します。
      戻り値:
      ポート番号

    • getAddress

      public final InetAddress getAddress()
      InetAddressを取得します。
      戻り値:
      InetAddressまたはnullが未解決の 合は、これらを参照してく さい。

    • getHostName

      public final String getHostName()
      hostnameを取得します。 ノート: このメソッドは、アドレスがリテラルIPアドレスで作成された 合、逆ネー ・サービス検索をトリガーする 合があります。
      戻り値:
      アドレスのホスト名部分。

    • getHostString

      public final String getHostString()
      ホスト名または、ホスト名がない(リテラルを使用して作成された) 合は文字列形式のアドレスを返します。 これは、逆検索を試みないという利点があります。
      戻り値:
      ホスト名。またはアドレスのString表現。
      導入されたバージョン:
      1.7

    • isUnresolved

      public final boolean isUnresolved()
      アドレスが解決されたかどうかを調べます。
      戻り値:
      ホスト名をInetAddressに解決できなかった 合はtrue。

    • toString

      public String toString()
      このInetSocketAddressの文字列表現を構築します。 この文字列は、InetAddressでInetAddress.toString()を呼び出してポート番号(コロン付き)を連結することで構築されます。

      アドレスがIPv6アドレスの 合、IPv6リテラルは大カッコで囲まれます。たとえば: "localhost/[0:0:0:0:0:0:0:1]:80"。 アドレスが未解決の 合、アドレス・リテラルのかわりに<unresolved>が表示されます(例:"foo/<unresolved>:80")。

      ホスト名またはアドレスの文字列表現を取得するには、このtoString()メソッドによって返される文字列を解析するのではなく、getHostString()を使用します。

      オーバーライド:
      toString、クラスObject
      戻り値:
      このオブジェクトの文字列表現。

    • equals

      public final boolean equals(Object obj)
      このオブジェクトと指定されたオブジェクトを比較します。 引数がnullではなく、その引数がこのオブジェクトと同じアドレスを表す 合に け、結果がtrueになります。

      2つのInetSocketAddressインスタンスのInetAddress (アドレスが未解決の 合はホスト名)とポート番号の両方が等しい 合、両者は同じアドレスを表しています。 どちらのアドレスも未解決である 合には、ホスト名とポート番号が比較されます。 ノート:ホスト名は大文字と小文字が区別されません。たとえば、「FooBar」と「foobar」は同等と見なされます。

      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - 比較対象のオブジェクト。
      戻り値:
      オブジェクトが同じである 合はtrue、そうでない 合はfalse。
      関連 目:

    • hashCode

      public final int hashCode()
      このソケット・アドレスのハッシュ・コードを返します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このソケット・アドレスのハッシュ・コード値。
      関連 目: