Класс 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 службы.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо истечения определённого промежутка реального времени.

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

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

JMXServiceURL

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

Создаёт JMXServiceURL с указанными частями.

Параметры:: protocol — часть URL, содержащая протокол. Указание обязательно, значения по умолчанию нет.; host — часть URL, содержащая хост. Если host равен null и локальное имя хоста можно сопоставить с IP-адресом, в качестве host по умолчанию используется локальное имя хоста, определённое с помощью InetAddress.getLocalHost().getHostName(). Если host равен null и локальное имя хоста невозможно сопоставить с IP-адресом, в качестве host по умолчанию используется числовой IP-адрес одного из активных сетевых интерфейсов. Если host — числовой адрес IPv6, его можно заключить в квадратные скобки [].; port — часть URL, содержащая порт.; urlPath — часть URL, содержащая путь URL. Если значение равно null, по умолчанию используется пустая строка.
Исключения:: MalformedURLException — если одна из частей имеет неправильный синтаксис, если host равно null и невозможно определить локальное имя хоста, если port отрицательно или если protocol равен null.

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

getProtocol

public String getProtocol()

Часть URL службы, содержащая протокол.

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

getHost

public String getHost()

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

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

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

getPort

public int getPort()

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

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

getURLPath

public String getURLPath()

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

Возвращает:: часть 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.