JMXServiceURL (Java Platform SE 8 )

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

All Implemented Interfaces:

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可以省略。 port无法提供host 。

url-path （如果有）以斜杠（ / ）或分号（ ; ）开头，并继续到地址的末尾。它可以使用RFC 2609中指定的分号语法来包含属性。这些属性不被此类解析，并且未检测到不正确的属性语法。

虽然根据RFC 2609具有以url-path开头的url-path是合法的，但SLP的所有实现都不允许它，因此建议避免使用该语法。

案例在初始service:jmx:protocol字符串或地址的主机部分service:jmx:protocol 。根据协议，案例可以在url-path中url-path 。

从以下版本开始：

1.5

另请参见：

RFC 2609, "Service Templates and Service: Schemes" ， RFC 3111, "Service Location Protocol Modifications for IPv6" ， Serialized Form

构造方法摘要

构造方法
Constructor and Description
`JMXServiceURL(String serviceURL)` 通过解析服务URL字符串构造一个 `JMXServiceURL` 。
`JMXServiceURL(String protocol, String host, int port)` 使用给定的协议，主机和端口构造一个 `JMXServiceURL` 。
`JMXServiceURL(String protocol, String host, int port, String urlPath)` 构造一个 `JMXServiceURL`与给定的部分。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` 指示一些其他对象是否等于此。
`String`	`getHost()` 服务网址的主机部分。
`int`	`getPort()` 服务网址的端口。
`String`	`getProtocol()` 服务网址的协议部分。
`String`	`getURLPath()` 服务网址的URL路径部分。
`int`	`hashCode()` 返回对象的哈希码值。
`String`	`toString()` 此服务网址的字符串表示形式。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - JMXServiceURL
```
public JMXServiceURL(String serviceURL)
              throws MalformedURLException
```
    通过解析服务URL字符串构造一个JMXServiceURL 。
    
    参数
    
    serviceURL - 要解析的URL字符串。
    
    异常
    
    NullPointerException - 如果 serviceURL为空。
    
    MalformedURLException - 如果serviceURL不符合抽象服务URL的语法，或者它不是JMX Remote API服务的有效名称。 A 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 - 网址的主机部分。如果为null，则默认为本地主机名，由InetAddress.getLocalHost().getHostName() 。如果是数字IPv6地址，则可以选择括在方括号[] 。
    
    port - URL的端口部分。
    
    异常
    
    MalformedURLException - 如果其中一个部分在语法上不正确，或者如果 host为空，并且无法找到本地主机名，或者如果 port为负。
  - JMXServiceURL
```
public JMXServiceURL(String protocol,
                     String host,
                     int port,
                     String urlPath)
              throws MalformedURLException
```
    构造一个JMXServiceURL与给定的部分。
    
    参数
    
    protocol - 协议的URL部分。如果为null，则默认为jmxmp 。
    
    host - 网址的主机部分。如果为null，则默认为本地主机名，由InetAddress.getLocalHost().getHostName() 。如果它是一个数字的IPv6地址，它可以选择括在方括号[] 。
    
    port - URL的端口部分。
    
    urlPath - URL的URL路径部分。如果为空，则默认为空字符串。
    
    异常
    
    MalformedURLException - 如果其中一个部分在语法上不正确，或者如果 host为空，并且无法找到本地主机名，或者如果 port为负。
- 方法详细信息
  - getProtocol
```
public String getProtocol()
```
    服务网址的协议部分。
    
    结果
    
    服务网址的协议部分。这从来不为空。
  - getHost
```
public String getHost()
```
    服务网址的主机部分。如果使用构造函数构造服务URL，该构造函数使用URL字符串参数，那么结果是指定该URL中的主机的子字符串。如果使用构造函数构造服务URL，该构造函数采用单独的主机参数，则结果是指定的字符串。如果该字符串为空，则结果为InetAddress.getLocalHost().getHostName() 。
    
    在任一情况下，如果使用数字IPv6地址的[...]语法指定了主机，则此处的返回值中不包括方括号。
    
    结果
    
    服务网址的主机部分。这从来不为空。
  - getPort
```
public int getPort()
```
    服务网址的端口。如果没有指定端口，返回值为0。
    
    结果
    
    服务URL的端口，如果没有，则为0。
  - getURLPath
```
public String getURLPath()
```
    服务网址的URL路径部分。这是一个空字符串，或某个字符串开头以斜线（ / ），或用分号（开头的字符串; ）。
    
    结果
    
    服务网址的URL路径部分。这从来不为空。
  - toString
```
public String toString()
```
    此服务网址的字符串表示形式。如果此方法返回的值提供给JMXServiceURL构造函数，则生成的对象等于此。
    
    host部分返回的字符串是由getHost()返回的值。如果该值指定了一个数字的IPv6地址，则它被方括号[] 。
    
    返回的字符串的port部分是getPort()以最小十进制形式返回的值。如果值为零，则省略。
    
    重写：
    
    toString在 Object
    
    结果
    
    此服务网址的字符串表示形式。
  - equals
```
public boolean equals(Object obj)
```
    指示一些其他对象是否等于此。当且仅当此方法返回true obj是一个实例JMXServiceURL其getProtocol() ， getHost() ， getPort()和getURLPath()种方法返回相同的值作为该对象。 getProtocol()和getHost()的值在不影响相等性的情况下可能不同。
    
    重写：
    
    equals在 Object
    
    参数
    
    obj - 用于比较的参考对象。
    
    结果
    
    true如果此对象与obj参数相同; false否则。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    描述从类别复制： Object
    返回对象的哈希码值。支持这种方法是为了散列表的利益，例如由HashMap提供的那些表。
    hashCode的总合同是：
    - 只要在执行Java应用程序时多次在同一个对象上调用该方法， hashCode方法必须始终返回相同的整数，前提是修改了对象中equals比较中没有使用的equals 。该整数不需要从一个应用程序的执行到相同应用程序的另一个执行保持一致。
    - 如果两个对象根据equals(Object)方法相等，则在两个对象中的每个对象上调用hashCode方法必须产生相同的整数结果。
    - 不要求如果两个对象根据Object.equals(java.lang.Object)方法不相等，那么在两个对象中的每个对象上调用hashCode方法必须产生不同的整数结果。但是，程序员应该意识到，为不等对象生成不同的整数结果可能会提高哈希表的性能。
    尽可能多的合理实用，由类Object定义的hashCode方法确实为不同对象返回不同的整数。（这通常通过将对象的内部地址转换为整数来实现，但Java的编程语言不需要此实现技术。）
    重写：
    
    hashCode在 Object
    
    结果
    
    该对象的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

Class JMXServiceURL

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

JMXServiceURL

JMXServiceURL

JMXServiceURL

方法详细信息

getProtocol

getHost

getPort

getURLPath

toString

equals

hashCode