- すべての実装されたインタフェース:
Serializable
JMX APIコネクタ・サーバーのアドレスです。 このクラスのインスタンスは不変です。
RFC 2609の定義およびRFC 3111での修正に従って、このアドレスがSLPの抽象サービスURLになります。 次のような形式になります。
service:jmx:protocol:sap
ここで、protocol
はコネクタ・サーバーへの接続に使用する転送プロトコルです。 1文字以上のASCII文字から成る文字列であり、その各文字は、英字と数字の他、+
と-
のいずれか1つです。 最初の文字は英字である必要があります。 英字の大文字は小文字に変換されます。
sap
は、コネクタ・サーバーが検出されたアドレスです。 このアドレスは、IPベースのプロトコルについて定義するRFC 2609の構文のサブセットを使用します。 サブセットである理由は、user@host
構文がサポートされていないからです。
このクラスは、現在、RFC 2609に定義されているその他の構文はサポートしません。
サポートされている構文は次のとおりです。
//[host[:port]][url-path]
角括弧[]
は、アドレスのオプション部分を示します。 プロトコルによっては、オプション部分が認識されない場合もあります。
host
は、ホスト名、IPv4数値ホスト・アドレス、IPv6数値アドレスのいずれかで、角括弧で囲まれます。
port
は10進ポート番号です。プロトコルによって、0はデフォルトまたは匿名ポートを表します。
host
およびport
は省略可能です。 port
は必ずhost
と共に指定します。
url-path
(存在する場合)は、スラッシュ(/
)またはセミコロン(;
)で始まり、アドレスの末尾まで続きます。 RFC 2609に指定されたセミコロン構文を使って、属性を含めることができます。 このクラスはこれらの属性を解析せず、属性構文が不正な場合も検出されません。
RFC 2609によると、セミコロンで始まるurl-path
は正当なアドレスですが、SLPの実装の中には、これを許可しないものもあります。したがって、この構文の使用を避けることをお勧めします。
初期service:jmx:protocol
文字列や、アドレスのホスト部分では、英字は大文字でも小文字でもかまいません。 ただし、プロトコルによっては、url-path
内の英字の大文字と小文字が区別されます。
-
コンストラクタのサマリー
コンストラクタ説明JMXServiceURL(String serviceURL)
サービスURL文字列を解析してJMXServiceURL
を作成します。JMXServiceURL(String protocol, String host, int port)
指定されたプロトコル、ホスト、およびポートでJMXServiceURL
を作成します。JMXServiceURL(String protocol, String host, int port, String urlPath)
指定された部分で、JMXServiceURL
を作成します。 -
メソッドのサマリー
-
コンストラクタの詳細
-
JMXServiceURL
public JMXServiceURL(String serviceURL) throws MalformedURLExceptionサービスURL文字列を解析して
JMXServiceURL
を作成します。- パラメータ:
serviceURL
- 構文解析されるURL文字列。- 例外:
NullPointerException
-serviceURL
がnullである場合。MalformedURLException
-serviceURL
が抽象サービスURLの構文に準拠していない場合、またはJMXリモートAPIサービスの有効な名前でない場合。JMXServiceURL
の先頭文字列は"service:jmx:"
(大文字と小文字の区別なし)である必要がある。 印刷可能ASCII文字以外の文字を含めることはできない。
-
JMXServiceURL
public JMXServiceURL(String protocol, String host, int port) throws MalformedURLException指定されたプロトコル、ホスト、およびポートで
JMXServiceURL
を作成します。 このコンストラクタはJMXServiceURL(protocol, host, port, null)
と同等です。- パラメータ:
protocol
- URLのプロトコル部分。 nullの場合、デフォルトのjmxmp
になる。host
- URLのホスト部分。 hostがヌルで、ローカル・ホスト名がIPに解決できる場合、ホストはInetAddress.getLocalHost().getHostName()
で決定されるローカル・ホスト名にデフォルト設定されます。 hostがヌルで、ローカル・ホスト名がIPに解決できない場合、ホストはアクティブなネットワーク・インタフェースの1つの数値IPアドレスにデフォルト設定されます。 hostが数字のIPv6アドレスの場合、オプションで大カッコ[]
で囲むことができます。port
- URLのポート部分。- 例外:
MalformedURLException
- 構文が正しくない部分が存在する場合、host
がnullでローカル・ホスト名を検出できない場合、またはport
が負の値の場合。
-
JMXServiceURL
public JMXServiceURL(String protocol, String host, int port, String urlPath) throws MalformedURLException指定された部分で、
JMXServiceURL
を作成します。- パラメータ:
protocol
- URLのプロトコル部分。 nullの場合、デフォルトのjmxmp
になる。host
- URLのホスト部分。 hostがヌルで、ローカル・ホスト名がIPに解決できる場合、ホストはInetAddress.getLocalHost().getHostName()
で決定されるローカル・ホスト名にデフォルト設定されます。 hostがヌルで、ローカル・ホスト名がIPに解決できない場合、ホストはアクティブなネットワーク・インタフェースの1つの数値IPアドレスにデフォルト設定されます。 hostが数字のIPv6アドレスの場合、オプションで大カッコ[]
で囲むことができます。port
- URLのポート部分。urlPath
- URLのURLパス部分。 nullの場合、空文字列になる。- 例外:
MalformedURLException
- 構文が正しくない部分が存在する場合、host
がnullでローカル・ホスト名を検出できない場合、またはport
が負の値の場合。
-
-
メソッドの詳細
-
getProtocol
public String getProtocol()サービスURLのプロトコル部分です。
- 戻り値:
- サービスURLのプロトコル部分。 nullは不可。
-
getHost
public String getHost()サービスURLのホスト部分です。 このサービスURLが、URL文字列パラメータを取るコンストラクタで作成されたものである場合、結果は、このURL内のホストを指定するサブ文字列に一致します。 このサービスURLが、個別のホスト・パラメータを取るコンストラクタで作成されたものである場合、結果は、指定された文字列に一致します。 その文字列がNULLの場合、ローカル・ホスト名をIPに解決できる場合、結果は
InetAddress.getLocalHost().getHostName()
になります。 それ以外の有効なネットワーク・インタフェースの数値IPアドレスが使用されます。いずれの場合も、ホストがIPv6数値アドレスの
[...]
構文で指定されていた場合、ここでの戻り値に角括弧は含まれません。- 戻り値:
- サービスURLのホスト部分。 nullは不可。
-
getPort
public int getPort()サービスURLのポートです。 ポートが指定されなかった場合、戻り値は0です。
- 戻り値:
- サービスURLのポート。存在しない場合は0。
-
getURLPath
public String getURLPath()サービスURLのURLパス部分です。 これは、空文字列、スラッシュ(
/
)で始まる文字列、またはセミコロン(;
)で始まる文字列です。- 戻り値:
- サービスURLのURLパス部分。 nullは不可。
-
toString
public String toString() -
equals
public boolean equals(Object obj)このオブジェクトと同等のオブジェクトがあるかどうかを示します。 このメソッドは、
obj
が、このオブジェクトと同じ値を返すgetProtocol()
、getHost()
、getPort()
、およびgetURLPath()
メソッドを持つJMXServiceURL
のインスタンスである場合にかぎり、trueを返します。getProtocol()
およびgetHost()
の値の大文字と小文字は区別されません。- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- 比較対象の参照オブジェクト。- 戻り値:
- このオブジェクトが
obj
引数と同じである場合はtrue
、それ以外の場合はfalse
。 - 関連項目:
Object.hashCode()
、HashMap
-