java.net
クラス InetAddress

java.lang.Object
  |
  +--java.net.InetAddress

public final class InetAddress

extends Object

implements Serializable

IP (Internet Protocol) アドレスを表すクラスです。

アプリケーションでは、新しい InetAddress のインスタンスの生成には getLocalHost、getByName、getAllByName の各メソッドを使用してください。

導入されたバージョン:

JDK1.0

関連項目:

getAllByName(java.lang.String), getByName(java.lang.String), getLocalHost(), 直列化された形式

メソッドの概要

boolean	equals(Object obj) このオブジェクトと指定されたオブジェクトとを比較します。
byte[]	getAddress() この InetAddress オブジェクトの IP アドレスをそのまま返します。
static InetAddress[]	getAllByName(String host) 指定されたホスト名を持つホストの IP アドレスをすべて取得します。
static InetAddress	getByName(String host) 指定されたホスト名を持つホストの IP アドレスを取得します。
String	getHostAddress() IP アドレス文字列 "%d.%d.%d.%d" を返します。
String	getHostName() このアドレスのホスト名を返します。
static InetAddress	getLocalHost() ローカルホストを返します。
int	hashCode() この IP アドレスのハッシュコードを返します。
boolean	isMulticastAddress() InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティルーチンです。
String	toString() この IP アドレスを String に変換します。

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

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

メソッドの詳細

isMulticastAddress

public boolean isMulticastAddress()

InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティルーチンです。IP マルチキャストアドレスは Class D アドレスです。すなわち、最初の 4 ビットは 1110 です。

導入されたバージョン:

JDK1.1

getHostName

public String getHostName()

このアドレスのホスト名を返します。ホスト名が null の場合、このアドレスは任意のローカルマシンの利用可能なネットワークアドレスを表します。

セキュリティマネージャが存在する場合、まずセキュリティマネージャの checkConnect メソッドが、引数としてホスト名と -1 を指定して呼び出され、この操作が許可されていることを確認します。

戻り値:

この IP アドレスに対応するホスト名

例外:

SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkConnect メソッドがこの操作を許可しない場合

関連項目:

SecurityManager.checkConnect(java.lang.String, int)

getAddress

public byte[] getAddress()

この InetAddress オブジェクトの IP アドレスをそのまま返します。結果は、ネットワークバイト順序に従って返されます。アドレスの最上位バイトが getAddress()[0] になります。

戻り値:

このオブジェクトの IP アドレス

getHostAddress

public String getHostAddress()

IP アドレス文字列 "%d.%d.%d.%d" を返します。

戻り値:

IP アドレスの文字列形式

導入されたバージョン:

JDK1.0.2

hashCode

public int hashCode()

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

戻り値:

この IP アドレスのハッシュコード値

オーバーライド:

クラス Object 内の hashCode

equals

public boolean equals(Object obj)

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

getAddress によって返されるバイト配列の長さが同じであり、バイト配列の各要素が同じである場合、2 つの InetAddress のインスタンスは同じ IP アドレスを表しています。

パラメータ:

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

戻り値:

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

オーバーライド:

クラス Object 内の equals

関連項目:

getAddress()

toString

public String toString()

この IP アドレスを String に変換します。

戻り値:

この IP アドレスの文字列表現

オーバーライド:

クラス Object 内の toString

getByName

public static InetAddress getByName(String host)
                             throws UnknownHostException

指定されたホスト名を持つホストの IP アドレスを取得します。ホスト名は「java.sun.com」のようなマシン名か、「206.26.48.100」のような IP アドレスの文字列表現です。

パラメータ:

host - 指定するホスト、またはローカルホストの場合は null

戻り値:

指定されたホスト名の IP アドレス

例外:

UnknownHostException - host 引数に指定されたホストの IP アドレスが見つからない場合

getAllByName

public static InetAddress[] getAllByName(String host)
                                  throws UnknownHostException

指定されたホスト名を持つホストの IP アドレスをすべて取得します。ホスト名は「java.sun.com」のようなマシン名か、「206.26.48.100」のような IP アドレスの文字列表現です。

セキュリティマネージャが存在する場合、host が null ではなく、host.length() の値がゼロではないときは、セキュリティマネージャの checkConnect メソッドが、引数としてホスト名と -1 を指定して呼び出され、この操作が許可されていることを確認します。

パラメータ:

host - ホスト名

戻り値:

指定されたホスト名のすべての IP アドレスを含む配列

例外:

UnknownHostException - host 引数に指定されたホストの IP アドレスが見つからない場合

SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkConnect メソッドがこの操作を許可しない場合

関連項目:

SecurityManager.checkConnect(java.lang.String, int)

getLocalHost

public static InetAddress getLocalHost()
                                throws UnknownHostException

ローカルホストを返します。

セキュリティマネージャが存在する場合、セキュリティマネージャの checkConnect メソッドが、引数としてローカルホスト名および -1 を指定して呼び出され、この操作が許可されていることを確認します。

戻り値:

ローカルホストの IP アドレス

例外:

UnknownHostException - host 引数に指定されたホストの IP アドレスが見つからない場合

SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkConnect メソッドがこの操作を許可しない場合

関連項目:

SecurityManager.checkConnect(java.lang.String, int)