declare namespace javax { namespace management { namespace remote { /** *
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 the
* user@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
and port
* can be omitted. The port
cannot be supplied
* without a host
.
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 the url-path
.
Service:
Schemes"
* @see RFC 3111,
* "Service Location Protocol Modifications for IPv6"
* @since 1.5
*/
// @ts-ignore
class JMXServiceURL extends java.lang.Object implements java.io.Serializable {
/**
* Constructs a JMXServiceURL
by parsing a Service URL
* string.
serviceURL
is
* null.
* @exception 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.
*/
// @ts-ignore
constructor(serviceURL: java.lang.String | string)
/**
* Constructs a JMXServiceURL
with the given protocol,
* host, and port. This constructor is equivalent to
* {@link #JMXServiceURL(String, String, int, String)
* JMXServiceURL(protocol, host, port, null)}.
jmxmp
.
* @param 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 []
.
* @param port the port part of the URL.
* @exception 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.
*/
// @ts-ignore
constructor(protocol: java.lang.String | string, host: java.lang.String | string, port: number /*int*/)
/**
* Constructs a JMXServiceURL
with the given parts.
* @param protocol the protocol part of the URL. If null, defaults
* to jmxmp
.
* @param 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 []
.
* @param port the port part of the URL.
* @param urlPath the URL path part of the URL. If null, defaults to
* the empty string.
* @exception 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.
*/
// @ts-ignore
constructor(protocol: java.lang.String | string, host: java.lang.String | string, port: number /*int*/, urlPath: java.lang.String | string)
/**
*
The protocol part of the Service URL. * @return the protocol part of the Service URL. This is never null. */ // @ts-ignore public getProtocol(): string /** *
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.
The port of the Service URL. If no port was * specified, the returned value is 0.
* @return the port of the Service URL, or 0 if none. */ // @ts-ignore public getPort(): number /*int*/ /** *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 (;
).
* @return the URL Path part of the Service URL. This is never
* null.
*/
// @ts-ignore
public getURLPath(): string
/**
*
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 {@link #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 {@link #getPort()} in its shortest
* decimal form. If the value is zero, it is omitted.
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 {@link
* #getProtocol()}, {@link #getHost()}, {@link #getPort()}, and
* {@link #getURLPath()} methods return the same values as for
* this object. The values for {@link #getProtocol()} and {@link
* #getHost()} can differ in case without affecting equality.
* @param obj the reference object with which to compare.
* @return true
if this object is the same as the
* obj
argument; false
otherwise.
*/
// @ts-ignore
public equals(obj: java.lang.Object | any): boolean
// @ts-ignore
public hashCode(): number /*int*/
}
}
}
}