javax.management.remote

Класс JMXServiceURL

java.lang. Объект

javax.management.remote. JMXServiceURL

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

Сериализуемый

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 не может быть предоставлен без a host.

url-path, если таковые вообще имеются, начинается с наклонной черты (/) или точка с запятой (;) и продолжается до конца адреса. Это может содержать атрибуты, используя синтаксис точки с запятой, определенный в RFC 2609. Те атрибуты не анализируются этим классом, и неправильный синтаксис атрибута не обнаруживается.

Хотя законно согласно RFC 2609 иметь a url-path это начинается с точки с запятой, не, все реализации SLP позволяют ее, таким образом, рекомендуется избежать что синтаксис.

Случай не является существенным в начальной букве service:jmx:protocol строка или в части узла адреса. В зависимости от протокола случай может быть существенным в url-path.

С тех пор:

1.5

См. Также:

RFC 2609, "Шаблоны службы и Service: Схемы", RFC 3111, "Модификации протокола обнаружения сервисов для IPv6", Сериализированная Форма

Сводка конструктора

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

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

Сводка метода

Методы

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

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

JMXServiceURL

public JMXServiceURL(String serviceURL)
              throws MalformedURLException

Конструкции a JMXServiceURL анализируя Службу строка URL.

Параметры:

serviceURL - строка URL, которая будет проанализирована.

Броски:

NullPointerException - если serviceURL нуль.

MalformedURLException - если serviceURL не приспосабливает синтаксису для Реферативной службы URL или если это не допустимое имя для JMX Удаленная служба API. A JMXServiceURL должен начаться со строки "service:jmx:" (нечувствительный к регистру). Это не должно содержать символы, которые не являются печатаемыми символами ASCII.

JMXServiceURL

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

Конструкции a JMXServiceURL с данным протоколом, узлом, и портом. Этот конструктор эквивалентен JMXServiceURL(protocol, host, port, null).

Параметры:

protocol - часть протокола URL. Если ноль, значения по умолчанию к jmxmp.

host - часть узла URL. Если ноль, значения по умолчанию к локальному имени хоста, как определено InetAddress.getLocalHost().getHostName(). Если это - числовой адрес IPv6, это может дополнительно быть включено в квадратные скобки [].

port - часть порта URL.

Броски:

MalformedURLException - если одна из частей является синтаксически неправильной, или если host нуль, и не возможно найти локальное имя хоста, или если port отрицательно.

JMXServiceURL

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

Конструкции a JMXServiceURL с данными частями.

Параметры:

protocol - часть протокола URL. Если ноль, значения по умолчанию к jmxmp.

host - часть узла URL. Если ноль, значения по умолчанию к локальному имени хоста, как определено InetAddress.getLocalHost().getHostName(). Если это - числовой адрес IPv6, это может дополнительно быть включено в квадратные скобки [].

port - часть порта URL.

urlPath - часть пути URL URL. Если ноль, значения по умолчанию к пустой строке.

Броски:

MalformedURLException - если одна из частей является синтаксически неправильной, или если host нуль, и не возможно найти локальное имя хоста, или если port отрицательно.

Деталь метода

getProtocol

public String getProtocol()

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

Возвраты:

часть протокола Службы URL. Это никогда не нуль.

getHost

public String getHost()

Часть узла Службы URL. Если Служба, URL был создан с конструктором, который берет строковый параметр URL, результат, является подстрокой, определяющей узел в том URL. Если Служба, URL был создан с конструктором, который берет отдельный параметр узла, результат, является строкой, которая была определена. Если та строка была нулем, результат InetAddress.getLocalHost().getHostName().

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

Возвраты:

часть узла Службы URL. Это никогда не нуль.

getPort

public int getPort()

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

Возвраты:

порт Службы URL, или 0, если ни один.

getURLPath

public String getURLPath()

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

Возвраты:

часть Пути URL Службы URL. Это никогда не нуль.

toString

public String toString()

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

host часть возвращенной строки является значением, возвращенным getHost(). Если то значение определяет числовой адрес IPv6, оно окружается квадратными скобками [].

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

Переопределения:

toString в классе Object

Возвраты:

строковое представление этой Службы URL.

равняется

public boolean equals(Object obj)

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

Переопределения:

equals в классе Object

Параметры:

obj - ссылочный объект, с которым можно сравниться.

Возвраты:

true если этот объект является тем же самым как obj параметр; false иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Описание скопировало с класса: Object

Возвращает значение хэш-кода для объекта. Этот метод поддерживается в пользу хэш-таблиц, таких как обеспеченные HashMap.

Общий контракт hashCode :

• Всякий раз, когда это вызывается на тот же самый объект не раз во время выполнения приложения Java, hashCode метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения.
• Если два объекта равны согласно equals(Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к тому же самому целочисленному результату.
• Не требуется это, если два объекта неравны согласно Object.equals(java.lang.Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц.

Столько, сколько разумно практично, метод хэш-кода, определенный классом Object действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования ^JavaTM.)

Переопределения:

hashCode в классе Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)