Класс JMXServiceURL

java.lang.Object

javax.management.remote.JMXServiceURL

Все реализуемые интерфейсы:: Serializable

public class JMXServiceURL extends Object implements Serializable

Адрес сервера-коннектора JMX API. Экземпляры этого класса неизменяемы.

Адрес является абстрактным URL-адресом сервиса для SLP, как определено в 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, начинающийся с точки с запятой, не все реализации SLP позволяют это, поэтому рекомендуется избегать этого синтаксиса.

Регистр не имеет значения в начальной строке service:jmx:protocol или в части адреса хоста. В зависимости от протокола, регистр может иметь значение в url-path.

С момента:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`JMXServiceURL(String serviceURL)`	Создаёт `JMXServiceURL` путем парсинга строки URL-адреса службы.
`JMXServiceURL(String protocol, String host, int port)`	Создаёт `JMXServiceURL` с заданным протоколом, хостом и портом.
`JMXServiceURL(String protocol, String host, int port, String urlPath)`	Создаёт `JMXServiceURL` с заданными частями.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`String`	`getHost()`	Часть хоста URL-адреса службы.
`int`	`getPort()`	Порт URL-адреса службы.
`String`	`getProtocol()`	Часть протокола URL-адреса службы.
`String`	`getURLPath()`	Часть URL-пути URL-адреса службы.
`String`	`toString()`	Строковое представление этого URL-адреса службы.

Методы, унаследованные от класса java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

JMXServiceURL

public JMXServiceURL(String serviceURL) throws MalformedURLException

Создаёт JMXServiceURL путем разбора строки URL службы.

Параметры:: serviceURL - строка URL для разбора.
Исключения:: NullPointerException - если serviceURL равно null.; MalformedURLException - если serviceURL не соответствует синтаксису URL-адреса абстрактной службы или если это не допустимое имя службы API удалённого JMX. Адрес 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. Если host равен null и имя хоста локальной машины разрешается в IP-адрес, то host устанавливается равным имени хоста локальной машины, определённому InetAddress.getLocalHost().getHostName(). Если host равен null и имя хоста локальной машины не разрешается в IP-адрес, то host устанавливается равным числовому IP-адресу одного из активных сетевых интерфейсов. Если host является числовым 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. Если host равен null и имя хоста локальной машины разрешается в IP-адрес, то host устанавливается равным имени хоста локальной машины, определённому InetAddress.getLocalHost().getHostName(). Если host равен null и имя хоста локальной машины не разрешается в IP-адрес, то host устанавливается равным числовому IP-адресу одного из активных сетевых интерфейсов. Если host является числовым IPv6-адресом, он может быть необязательно заключён в квадратные скобки [].; port - часть порта URL.; urlPath - часть пути URL. Если null, используется пустая строка.
Исключения:: MalformedURLException - если одна из частей имеет синтаксические ошибки, или если host равно null и невозможно найти имя хоста локальной машины, или если port отрицательно.

Подробное описание методов

getProtocol

public String getProtocol()

Часть протокола URL службы.

Возвращает:: часть протокола URL службы. Никогда не равно null.

getHost

public String getHost()

Часть хоста URL службы. Если URL службы был создан с помощью конструктора, принимающего строку URL в качестве параметра, результат — подстрока, определяющая хост в этом URL. Если URL службы был создан с помощью конструктора, принимающего отдельный параметр хоста, результат — заданная строка. Если эта строка равна null, результат — InetAddress.getLocalHost().getHostName() если имя хоста локальной машины разрешается в IP-адрес. В противном случае используется числовой IP-адрес активного сетевого интерфейса.

В любом случае, если хост был указан с использованием синтаксиса [...] для числовых IPv6-адресов, квадратные скобки здесь не включены в возвращаемое значение.

Возвращает:: часть хоста URL службы. Никогда не равно null.

getPort

public int getPort()

Порт URL службы. Если порт не был указан, возвращаемое значение равно 0.

Возвращает:: порт URL службы, или 0, если не указан.

getURLPath

public String getURLPath()

Часть пути URL службы. Это пустая строка или строка, начинающаяся с косой черты (/), или строка, начинающаяся с точки с запятой (;).

Возвращает:: часть пути URL службы. Никогда не равно null.

toString

public String toString()

Строковое представление этого URL службы. Если возвращаемое значение этого метода передано в конструктор JMXServiceURL, полученный объект равен этому объекту.

Часть host возвращаемой строки — значение, возвращаемое getHost(). Если это значение задаёт числовой IPv6-адрес, оно заключено в квадратные скобки [].

Часть port возвращаемой строки — значение, возвращаемое getPort() в кратчайшей десятичной форме. Если значение равно нулю, оно опускается.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого URL службы.

equals

public boolean equals(Object obj)

Указывает, равен ли другой объект этому. Этот метод возвращает true тогда и только тогда, когда obj является экземпляром JMXServiceURL, чьи методы getProtocol(), getHost(), getPort() и getURLPath() возвращают такие же значения, как для этого объекта. Значения для getProtocol() и getHost() могут отличаться регистром без влияния на равенство.

Переопределяет:

equals в классе Object

Параметры:

obj - объект-ссылка для сравнения.

Возвращает:

true если этот объект такой же, как аргумент obj; false в противном случае.

См. также:

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/remote/JMXServiceURL.html