Класс JMXServiceURL

java.lang.Object

javax.management.remote.JMXServiceURL

Все реализованные интерфейсы:: Serializable

public class JMXServiceURL extends Object implements Serializable

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

Адрес представляет собой абстрактный 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 службы.
`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 сервиса или не является допустимым именем сервиса JMX Remote API. Строка 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, то хост по умолчанию устанавливается в имя хоста локальной машины, определенное InetAddress.getLocalHost().getHostName(). Если host равен null и имя хоста локальной машины не может быть разрешено в IP, то хост устанавливается в числовой IP-адрес одного из активных сетевых интерфейсов. Если хост является числовым 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, то хост по умолчанию устанавливается в имя хоста локальной машины, определенное InetAddress.getLocalHost().getHostName(). Если host равен null и имя хоста локальной машины не может быть разрешено в IP, то хост устанавливается в числовой IP-адрес одного из активных сетевых интерфейсов. Если хост является числовым 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/remote/JMXServiceURL.html