|
|||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
javax.management.remote
类 JMXServiceURL
java.lang.Objectjavax.management.remote.JMXServiceURL
- 所有已实现的接口：
- Serializable
-
public class JMXServiceURL
- extends Object
- implements Serializable
JMX API 连接器服务器的地址。此类的实例是不可变的。
地址是 SLP 的抽象服务 URL，此内容在 RFC 2609 中进行了定义并在 RFC 3111 中进行了修正。它看起来应该如下所示：
service:jmx:protocol:sap
其中 protocol 为连接到连接器服务器所用的传输协议。它是一个或多个 ASCII 字符所组成的字符串，每个字符为字母、数字或字符 + 或 - 之一。第一个字符必须为字母。大写字母被转换为小写字母。
sap 是查找到连接器服务器的地址位置。此地址采用了 RFC 2609 中为基于 IP 的协议所定义的语法子集。说它是子集是因为它不支持 user@host 语法。
此类目前也不支持由 RFC 2609 定义的其他语法。
所支持的语法为：
//[host[:port]][url-path]
方括号 [] 指示地址的可选部分。并不是所有的协议都能识别所有可选部分。
host 是主机名，它是一个 IPv4 数值主机地址，或是括在方括号中的 IPv6 数值地址。
port 是一个十进制的端口号。0 表示默认或匿名端口，这取决于协议。
host 和 port 均可忽略。必须有了 host 才能提供 port。
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) 通过解析 Service 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() Service URL 的主机部分。 |
int |
getPort() Service URL 的端口部分。 |
String |
getProtocol() Service URL 的协议部分。 |
String |
getURLPath() Service URL 的 URL Path 部分。 |
int |
hashCode() 返回该对象的哈希码值。 |
String |
toString() 此 Service URL 的字符串表示形式。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| 构造方法详细信息 |
|---|
JMXServiceURL
public JMXServiceURL(String serviceURL) throws MalformedURLException
-
通过解析 Service URL 字符串来构造
JMXServiceURL。- 参数：
-
serviceURL- 要解析的 URL 字符串。 - 抛出：
-
NullPointerException- 如果serviceURL为 null。 -
MalformedURLException- 如果serviceURL不符合 Abstract Service URL 的语法，或者它不是 JMX Remote 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 Path 部分。如果为 null，则默认为空字符串。 - 抛出：
-
MalformedURLException- 如果某一部分在语法上不正确，或者如果host为 null 并且无法找到本地主机名，或者如果port为负。
| 方法详细信息 |
|---|
getProtocol
public String getProtocol()
-
Service URL 的协议部分。
-
-
- 返回：
- Service URL 的协议部分。它从不为 null。
getHost
public String getHost()
-
Service URL 的主机部分。如果 Service URL 是用带一个 URL 字符串参数的构造方法所构造的，则结果为该 URL 中指定主机的子字符串。如果此 Service URL 是用带一个独立主机参数的构造方法所构造的，则结果为所指定的字符串。如果该字符串为 null，则结果为
InetAddress.getLocalHost().getHostName()。无论是哪种情况，如果主机是使用数值 IPv6 地址的
[...]语法指定的，则此处的返回值不包括方括号。 -
-
- 返回：
- Service URL 的主机部分。它从不为 null。
getPort
public int getPort()
-
Service URL 的端口部分。如果未指定任何端口，则返回值为 0。
-
-
- 返回：
- Service URL 的端口，如果没有，则返回 0。
getURLPath
public String getURLPath()
-
Service URL 的 URL Path 部分。这是一个空字符串，或以斜杠 (
/) 开头的字符串，或以分号 (;) 开头的字符串。 -
-
- 返回：
- Service URL 的 URL Path 部分。它从不为 null。
toString
public String toString()
