Класс JMXServiceURL

Все реализованные интерфейсы:
Serializable
public class JMXServiceURL
extends Object
implements Serializable

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

Адрес является Абстрактным адресом службы для 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
См. также:
RFC 2609, "Шаблоны служб и схемы Service:", RFC 3111, "Модификации протокола обнаружения служб для IPv6", Сериализованная форма

Конструкторы

Конструктор Описание
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-адреса Абстрактной службы или если это не допустимое имя службы JMX Remote API. URL 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 если этот объект такой же, как переданный аргумент; false в противном случае.
См. также:
Object.hashCode(), HashMap

© 1993, 2020, 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/11/docs/api/java.management/javax/management/remote/JMXServiceURL.html

Spec-Zone .ru
спецификации, руководства, описания, API