- java.lang.Object
-
- javax.management.remote.JMXServiceURL
-
- All Implemented Interfaces:
- Serializable
public class JMXServiceURL extends Object implements Serializable
The address of a JMX API connector server. Instances of this class are immutable.
The address is an Abstract Service URL for SLP, as defined in RFC 2609 and amended by RFC 3111. It must look like this:
service:jmx:protocol:sap
Here,
protocol
is the transport protocol to be used to connect to the connector server. It is a string of one or more ASCII characters, each of which is a letter, a digit, or one of the characters+
or-
. The first character must be a letter. Uppercase letters are converted into lowercase ones.sap
is the address at which the connector server is found. This address uses a subset of the syntax defined by RFC 2609 for IP-based protocols. It is a subset because theuser@host
syntax is not supported.The other syntaxes defined by RFC 2609 are not currently supported by this class.
The supported syntax is:
//[host[:port]][url-path]
Square brackets
[]
indicate optional parts of the address. Not all protocols will recognize all optional parts.The
host
is a host name, an IPv4 numeric host address, or an IPv6 numeric address enclosed in square brackets.The
port
is a decimal port number. 0 means a default or anonymous port, depending on the protocol.The
host
andport
can be omitted. Theport
cannot be supplied without ahost
.The
url-path
, if any, begins with a slash (/
) or a semicolon (;
) and continues to the end of the address. It can contain attributes using the semicolon syntax specified in RFC 2609. Those attributes are not parsed by this class and incorrect attribute syntax is not detected.Although it is legal according to RFC 2609 to have a
url-path
that begins with a semicolon, not all implementations of SLP allow it, so it is recommended to avoid that syntax.Case is not significant in the initial
service:jmx:protocol
string or in the host part of the address. Depending on the protocol, case can be significant in theurl-path
.
-
-
Constructor Summary
Constructors Constructor and Description JMXServiceURL(String serviceURL)
Constructs aJMXServiceURL
by parsing a Service URL string.JMXServiceURL(String protocol, String host, int port)
Constructs aJMXServiceURL
with the given protocol, host, and port.JMXServiceURL(String protocol, String host, int port, String urlPath)
Constructs aJMXServiceURL
with the given parts.
-
Method Summary
Methods Modifier and Type Method and Description boolean
equals(Object obj)
Indicates whether some other object is equal to this one.String
getHost()
The host part of the Service URL.int
getPort()
The port of the Service URL.String
getProtocol()
The protocol part of the Service URL.String
getURLPath()
The URL Path part of the Service URL.int
hashCode()
Returns a hash code value for the object.String
toString()
The string representation of this Service URL.
-
-
-
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
- ifserviceURL
is null.MalformedURLException
- ifserviceURL
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. AJMXServiceURL
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 toJMXServiceURL(protocol, host, port, null)
.- Parameters:
protocol
- the protocol part of the URL. If null, defaults tojmxmp
.host
- the host part of the URL. If null, defaults to the local host name, as determined byInetAddress.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 ifhost
is null and it is not possible to find the local host name, or ifport
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 tojmxmp
.host
- the host part of the URL. If null, defaults to the local host name, as determined byInetAddress.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 ifhost
is null and it is not possible to find the local host name, or ifport
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 bygetHost()
. 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 bygetPort()
in its shortest decimal form. If the value is zero, it is omitted.
-
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 ofJMXServiceURL
whosegetProtocol()
,getHost()
,getPort()
, andgetURLPath()
methods return the same values as for this object. The values forgetProtocol()
andgetHost()
can differ in case without affecting equality.- Overrides:
equals
in classObject
- Parameters:
obj
- the reference object with which to compare.- Returns:
true
if this object is the same as theobj
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 byHashMap
.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 inequals
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 thehashCode
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 thehashCode
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 JavaTM programming language.)- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
- Whenever it is invoked on the same object more than once during
an execution of a Java application, the
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
25/11/2024 04:19:28 Cette version de la page est en cache (à la date du 25/11/2024 04:19:28) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/management/remote/JMXServiceURL.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.