- すべての実装されたインタフェース:
Serializable
public class InetSocketAddress extends SocketAddress
このクラスは、バインドまたは接続のためにソケットが使用する、または戻り値として使用する変更不可能なオブジェクトを提供します。
ワイルドカードは特殊なローカルIPアドレスです。 それは通常「任意」を意味しており、bind
操作だけに使用できます。
- 導入されたバージョン:
- 1.4
- 関連項目:
Socket
、ServerSocket
、直列化された形式
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 InetSocketAddress(int port)
ソケット・アドレスを作成します。この場合、IPアドレスはワイルドカード・アドレスで、ポート番号は指定された値です。InetSocketAddress(String hostname, int port)
ホスト名とポート番号からソケット・アドレスを作成します。InetSocketAddress(InetAddress addr, int port)
IPアドレスとポート番号からソケット・アドレスを作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 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の文字列表現を構築します。
-
コンストラクタの詳細
-
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
を取得します。- 戻り値:
- 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の文字列表現を構築します。 このStringは、InetAddressのtoString()を呼び出し、それにポート番号を(コロン付きで)連結することで構築されます。 アドレスが未解決の場合、コロンの前の部分にはホスト名だけが含まれます。 -
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)
-