JMXServiceURL (Java Platform SE 8)

java.lang.Object
- javax.management.remote.JMXServiceURL

すべての実装されたインタフェース:

Serializable
```
public class JMXServiceURL
extends Object
implements 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内の英字の大文字と小文字が区別されます。

導入されたバージョン:

1.5

関連項目:

RFC 2609「Service Templates and Service: Schemes」, RFC 3111「Service Location Protocol Modifications for IPv6」, 直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`JMXServiceURL(String serviceURL)` サービスURL文字列を解析して`JMXServiceURL`を作成します。
`JMXServiceURL(String protocol, String host, int port)` 指定されたプロトコル、ホスト、およびポートで`JMXServiceURL`を作成します。
`JMXServiceURL(String protocol, String host, int port, String urlPath)` 指定された部分で、`JMXServiceURL`を作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`boolean`	`equals(Object obj)` このオブジェクトと同等のオブジェクトがあるかどうかを示します。
`String`	`getHost()` サービスURLのホスト部分です。
`int`	`getPort()` サービスURLのポートです。
`String`	`getProtocol()` サービスURLのプロトコル部分です。
`String`	`getURLPath()` サービスURLのURLパス部分です。
`int`	`hashCode()` オブジェクトのハッシュ・コード値を返します。
`String`	`toString()` このサービスURLの文字列表現です。

クラス java.lang.Objectから継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - 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のホスト部分。nullの場合、InetAddress.getLocalHost().getHostName()で確認されたローカル・ホスト名(デフォルト)になる。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のホスト部分。nullの場合、InetAddress.getLocalHost().getHostName()で確認されたローカル・ホスト名(デフォルト)になる。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であった場合、結果は、InetAddress.getLocalHost().getHostName()になります。
    
    いずれの場合も、ホストがIPv6数値アドレスの[...]構文で指定されていた場合、ここでの戻り値に角括弧は含まれません。
    
    戻り値:
    
    サービスURLのホスト部分。nullは不可。
  - getPort
```
public int getPort()
```
    サービスURLのポートです。ポートが指定されなかった場合、戻り値は0です。
    
    戻り値:
    
    サービスURLのポート。存在しない場合は0。
  - getURLPath
```
public String getURLPath()
```
    サービスURLのURLパス部分です。これは、空文字列、スラッシュ(/)で始まる文字列、またはセミコロン(;)で始まる文字列です。
    
    戻り値:
    
    サービスURLのURLパス部分。nullは不可。
  - toString
```
public String toString()
```
    このサービスURLの文字列表現です。このメソッドによって返される値がJMXServiceURLコンストラクタに渡される場合、結果として、この文字列表現と同等のオブジェクトが生成されます。
    
    返される文字列のhost部分は、getHost()の戻り値に一致します。この値がIPv6数値アドレスを指定する場合、角括弧[]で囲まれた形式になります。
    
    返される文字列のport部分は、getPort()によって返される一番短い10進形式の値です。値が0の場合は省略されます。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    このサービスURLの文字列表現。
  - equals
```
public boolean equals(Object obj)
```
    このオブジェクトと同等のオブジェクトがあるかどうかを示します。このメソッドは、objが、このオブジェクトと同じ値を返すgetProtocol()、getHost()、getPort()、およびgetURLPath()メソッドを持つJMXServiceURLのインスタンスである場合にかぎり、trueを返します。getProtocol()およびgetHost()の値の大文字と小文字は区別されません。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    
    obj - 比較対象の参照オブジェクト。
    
    戻り値:
    
    このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。
    
    関連項目:
    
    Object.hashCode()、HashMap
  - hashCode
```
public int hashCode()
```
    次のクラスからコピーされた説明: Object
    オブジェクトのハッシュ・コード値を返します。このメソッドは、HashMapによって提供されるハッシュ・テーブルなどの、ハッシュ・テーブルの利点のためにサポートされています。
    hashCodeの一般的な規則は次のとおりです。
    - Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対するequalsの比較で使用される情報が変更されていなければ、hashCodeメソッドは常に同じ整数を返す必要があります。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
    - equals(Object)メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって同じ整数の結果が生成される必要があります。
    - Object.equals(java.lang.Object)メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって異なる整数の結果が生成される必要はありません。ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ・テーブルのパフォーマンスが向上する可能性があることに注意するようにしてください。
    クラスObjectによって定義されたhashCodeメソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。(これは通常、オブジェクトの内部アドレスを整数に変換することによって実装されますが、この実装テクニックはJava™プログラミング言語では必要ありません。)
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    
    このオブジェクトのハッシュ・コード値。
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスJMXServiceURL

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

JMXServiceURL

JMXServiceURL

JMXServiceURL

メソッドの詳細

getProtocol

getHost

getPort

getURLPath

toString

equals

hashCode