JavaTM 2 Platform
Std. Ed. v1.3

java.net
クラス InetAddress

java.lang.Object
  |
  +--java.net.InetAddress
すべての実装インタフェース:
Serializable

public final class InetAddress
extends Object
implements Serializable

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

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

導入されたバージョン:
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()
          この IP アドレスに対応するホスト名を取得します。
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 です。
戻り値:
InetAddress が IP マルチキャストアドレスかどうかを示す boolean
導入されたバージョン:
JDK1.1

getHostName

public String getHostName()
この IP アドレスに対応するホスト名を取得します。

セキュリティマネージャが存在する場合、最初にセキュリティマネージャの 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 アドレスのハッシュコードを返します。
オーバーライド:
クラス Object 内の hashCode
戻り値:
この IP アドレスのハッシュコード値

equals

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

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

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

toString

public String toString()
この IP アドレスを String に変換します。
オーバーライド:
クラス Object 内の toString
戻り値:
この IP アドレスの文字列表現

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)

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.