Class JMXServiceURL

Constructor Detail

• JMXServiceURL

  public JMXServiceURL(String serviceURL)
                throws MalformedURLException

  Constructs a JMXServiceURL by parsing a Service URL string.

  Parameters:

  serviceURL - the URL string to be parsed.

  Throws:

  NullPointerException - if serviceURL is null.

  MalformedURLException - if serviceURL does not conform to the syntax for an Abstract Service URL or if it is not a valid name for a JMX Remote API service. A JMXServiceURL must begin with the string "service:jmx:" (case-insensitive). It must not contain any characters that are not printable ASCII characters.

• JMXServiceURL

  public JMXServiceURL(String protocol,
               String host,
               int port)
                throws MalformedURLException

  Constructs a JMXServiceURL with the given protocol, host, and port. This constructor is equivalent to JMXServiceURL(protocol, host, port, null).

  Parameters:

  protocol - the protocol part of the URL. If null, defaults to jmxmp.

  host - the host part of the URL. If null, defaults to the local host name, as determined by InetAddress.getLocalHost().getHostName(). If it is a numeric IPv6 address, it can optionally be enclosed in square brackets [].

  port - the port part of the URL.

  Throws:

  MalformedURLException - if one of the parts is syntactically incorrect, or if host is null and it is not possible to find the local host name, or if port is negative.

• JMXServiceURL

  public JMXServiceURL(String protocol,
               String host,
               int port,
               String urlPath)
                throws MalformedURLException

  Constructs a JMXServiceURL with the given parts.

  Parameters:

  protocol - the protocol part of the URL. If null, defaults to jmxmp.

  host - the host part of the URL. If null, defaults to the local host name, as determined by InetAddress.getLocalHost().getHostName(). If it is a numeric IPv6 address, it can optionally be enclosed in square brackets [].

  port - the port part of the URL.

  urlPath - the URL path part of the URL. If null, defaults to the empty string.

  Throws:

  MalformedURLException - if one of the parts is syntactically incorrect, or if host is null and it is not possible to find the local host name, or if port is negative.

Method Detail

• getProtocol

  public String getProtocol()

  The protocol part of the Service URL.

  Returns:

  the protocol part of the Service URL. This is never null.

• getHost

  public String getHost()

  The host part of the Service URL. If the Service URL was constructed with the constructor that takes a URL string parameter, the result is the substring specifying the host in that URL. If the Service URL was constructed with a constructor that takes a separate host parameter, the result is the string that was specified. If that string was null, the result is InetAddress.getLocalHost().getHostName().

  In either case, if the host was specified using the [...] syntax for numeric IPv6 addresses, the square brackets are not included in the return value here.

  Returns:

  the host part of the Service URL. This is never null.

• getPort

  public int getPort()

  The port of the Service URL. If no port was specified, the returned value is 0.

  Returns:

  the port of the Service URL, or 0 if none.

• getURLPath

  public String getURLPath()

  The URL Path part of the Service URL. This is an empty string, or a string beginning with a slash (/), or a string beginning with a semicolon (;).

  Returns:

  the URL Path part of the Service URL. This is never null.

• toString

  public String toString()

  The string representation of this Service URL. If the value returned by this method is supplied to the JMXServiceURL constructor, the resultant object is equal to this one.

  The host part of the returned string is the value returned by getHost(). If that value specifies a numeric IPv6 address, it is surrounded by square brackets [].

  The port part of the returned string is the value returned by getPort() in its shortest decimal form. If the value is zero, it is omitted.

  Overrides:

  toString in class Object

  Returns:

  the string representation of this Service URL.

• equals

  public boolean equals(Object obj)

  Indicates whether some other object is equal to this one. This method returns true if and only if obj is an instance of JMXServiceURL whose getProtocol(), getHost(), getPort(), and getURLPath() methods return the same values as for this object. The values for getProtocol() and getHost() can differ in case without affecting equality.

  Overrides:

  equals in class Object

  Parameters:

  obj - the reference object with which to compare.

  Returns:

  true if this object is the same as the obj argument; false otherwise.

  See Also:

  Object.hashCode(), HashMap

• hashCode

  public int hashCode()

  Description copied from class: Object
  Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

  The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

  As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java^TM programming language.)

  Overrides:

  hashCode in class Object

  Returns:

  a hash code value for this object.

  See Also:

  Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)