InetSocketAddress (Java Platform SE 7)

java.lang.Object
- java.net.SocketAddress
- - java.net.InetSocketAddress

すべての実装されたインタフェース:

Serializable
```
public class InetSocketAddress
extends SocketAddress
```
このクラスは、IP ソケットアドレス (IP アドレス + ポート番号) を実装します。これはペア (ホスト名 + ポート番号) にすることもできます。その場合、ホスト名の解決が試みられます。解決に失敗すると、そのアドレスは未解決と呼ばれるようになりますが、プロキシ経由の接続のような一部の環境ではまだ使用することができます。
このクラスは、バインドまたは接続のためにソケットが使用する、または戻り値として使用する変更不可能なオブジェクトを提供します。
ワイルドカードは特殊なローカル IP アドレスです。それは通常「任意」を意味しており、bind 操作だけに使用できます。

導入されたバージョン:

1.4

関連項目:
Socket、ServerSocket、直列化された形式

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

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

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`static InetSocketAddress`	`createUnresolved(String host, int port)` ホスト名とポート番号から未解決のソケットアドレスを作成します。
`boolean`	`equals(Object obj)` このオブジェクトと指定されたオブジェクトを比較します。
`InetAddress`	`getAddress()` `InetAddress` を取得します。
`String`	`getHostName()` `hostname` を取得します。
`String`	`getHostString()` ホスト名または、ホスト名がない (リテラルを使用して作成された) 場合は文字列形式のアドレスを返します。
`int`	`getPort()` ポート番号を取得します。
`int`	`hashCode()` このソケットアドレスのハッシュコードを返します。
`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 へのホスト名の解決が試みられます。その試みが失敗すると、そのアドレスには未解決のフラグが付けられます。
    セキュリティーマネージャーが存在する場合、その checkConnect メソッドがホスト名を引数に指定して呼び出され、ホスト名を解決する権限がチェックされます。この結果、SecurityException がスローされることがあります。
    有効なポート番号は 0 から 65535 の範囲です。ポート番号が zero の場合は、bind 操作で一時的なポートが選択されます。
    
    パラメータ:
    hostname - ホスト名
    port - ポート番号
    
    例外:
    
    IllegalArgumentException - port パラメータが有効なポート値の範囲外である場合、または hostname パラメータが null の場合。
    
    SecurityException －セキュリティーマネージャーが存在し、ホスト名を解決する権限が拒否された場合。
    関連項目:
    isUnresolved()
- メソッドの詳細
  - createUnresolved
```
public static InetSocketAddress createUnresolved(String host,
                                 int port)
```
    ホスト名とポート番号から未解決のソケットアドレスを作成します。
    InetAddress へのホスト名の解決は試みられません。このアドレスには未解決のフラグが付けられます。
    有効なポート番号は 0 から 65535 の範囲です。ポート番号が zero の場合は、bind 操作で一時的なポートが選択されます。
    
    パラメータ:
    host - ホスト名
    port - ポート番号
    
    戻り値:
    未解決のソケットアドレスを表す InetSocketAddress
    
    例外:
    
    IllegalArgumentException - port パラメータが有効なポート値の範囲外である場合、または hostname パラメータが null の場合。
    導入されたバージョン:
    
    1.5
    
    関連項目:
    isUnresolved()
  - getPort
```
public final int getPort()
```
    ポート番号を取得します。
    
    戻り値:
    ポート番号。
  - getAddress
```
public final InetAddress getAddress()
```
    InetAddress を取得します。
    
    戻り値:
    InetAdress。未解決の場合は 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 の文字列表現を構築します。この String は、InetAddress の toString() を呼び出し、それにポート番号を (コロン付きで) 連結することで構築されます。アドレスが未解決の場合、コロンの前の部分にはホスト名だけが含まれます。
    
    オーバーライド:
    
    toString 、クラス: Object
    
    戻り値:
    このオブジェクトの文字列表現。
  - equals
```
public final boolean equals(Object obj)
```
    このオブジェクトと指定されたオブジェクトを比較します。引数が null ではなく、その引数がこのオブジェクトと同じアドレスを表す場合にだけ、結果が true になります。
    2 つの InetSocketAddress インスタンスの InetAddress (アドレスが未解決の場合はホスト名) とポート番号の両方が等しい場合、両者は同じアドレスを表しています。どちらのアドレスも未解決である場合には、ホスト名とポート番号が比較されます。注:ホスト名は大文字と小文字が区別されません。たとえば、「FooBar」と「foobar」は同等と見なされます。
    
    オーバーライド:
    
    equals 、クラス: Object
    
    パラメータ:
    obj - 比較対象のオブジェクト。
    
    戻り値:
    オブジェクトが同じである場合は true、そうでない場合は false。
    関連項目:
    InetAddress.equals(java.lang.Object)
  - hashCode
```
public final int hashCode()
```
    このソケットアドレスのハッシュコードを返します。
    
    オーバーライド:
    
    hashCode 、クラス: Object
    
    戻り値:
    このソケットアドレスのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス InetSocketAddress

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

メソッドのサマリー

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

コンストラクタの詳細

InetSocketAddress

InetSocketAddress

InetSocketAddress

メソッドの詳細

createUnresolved

getPort

getAddress

getHostName

getHostString

isUnresolved

toString

equals

hashCode