java.net
クラス InetSocketAddress

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)
ソケットアドレスを作成します。

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

メソッドの概要

static InetSocketAddress	createUnresolved(String host, int port) ホスト名とポート番号から未解決のソケットアドレスを作成します。
boolean	equals(Object obj) オブジェクトと指定されたオブジェクトを比較します。
InetAddress	getAddress() InetAddress を取得します。
String	getHostName() hostname を取得します。
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 の範囲です。ポート番号が 0 の場合は、bind 操作で一時的なポートが選択されます。

パラメータ:

port - ポート番号

例外:

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

InetSocketAddress

public InetSocketAddress(InetAddress addr,
                         int port)

IP アドレスとポート番号からソケットアドレスを作成します。

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

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

パラメータ:

addr - IP アドレス

port - ポート番号

例外:

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

InetSocketAddress

public InetSocketAddress(String hostname,
                         int port)

ホスト名とポート番号からソケットアドレスを作成します。

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

セキュリティーマネージャーが存在する場合、その checkConnect メソッドがホスト名を引数に指定して呼び出され、ホスト名を解決する権限がチェックされます。この結果、SecurityException がスローされることがあります。

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

パラメータ:

hostname - ホスト名

port - ポート番号

例外:

IllegalArgumentException - port パラメータが有効なポート値の範囲外である場合、または hostname パラメータが null の場合

SecurityException - セキュリティーマネージャーが存在し、ホスト名を解決する権限が拒否された場合

関連項目:

isUnresolved()

メソッドの詳細

createUnresolved

public static InetSocketAddress createUnresolved(String host,
                                                 int port)

ホスト名とポート番号から未解決のソケットアドレスを作成します。

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

有効なポート番号は 0 から 65535 の範囲です。ポート番号が 0 の場合は、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 を取得します。

戻り値:

アドレスのホスト名部分

isUnresolved

public final boolean isUnresolved()

アドレスが解決されたかどうかを調べます。

戻り値:

ホスト名から InetAddress への解決ができなかった場合は true

toString

public String toString()

この InetSocketAddress の文字列表現を構築します。この String は、InetAddress の toString() を呼び出し、それにポート番号を (コロン付きで) 連結することで構築されます。アドレスが未解決の場合、コロンの前の部分にはホスト名だけが含まれます。

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現

equals

public final boolean equals(Object obj)

オブジェクトと指定されたオブジェクトを比較します。引数が null ではなく、このオブジェクトと同じアドレスを表している場合にだけ、結果が true になります。

2 つの InetSocketAddress インスタンスの InetAddress (アドレスが未解決の場合はホスト名) とポート番号の両方が等しい場合、両者は同じアドレスを表しています。どちらのアドレスも未解決である場合には、ホスト名とポート番号が比較されます。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象のオブジェクト

戻り値:

オブジェクトが同じである場合は true、そうでない場合は false

関連項目:

InetAddress.equals(java.lang.Object)

hashCode

public final int hashCode()

このソケットアドレスのハッシュコードを返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

このソケットアドレスのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable