Spec-Zone .ru
спецификации, руководства, описания, API
|
public class JMXServiceURL extends Object implements Serializable
Адрес сервера соединителя API JMX. Экземпляры этого class являются неизменными.
Адресом является Реферативная служба URL для SLP, как определено в RFC 2609 и исправленный RFC 3111. Это должно быть похожим на это:
service:jmx:protocol:sap
Здесь, protocol
транспортный протокол, который будет использоваться, чтобы соединиться с сервером соединителя. Это - строка одного или более символов ASCII, каждый из которых является буквой, цифрой, или одним из символов +
или -
. Первый символ должен быть буквой. Прописные буквы преобразовываются в строчные.
sap
адрес, в котором находится сервер соединителя. Этот адрес использует подмножество синтаксиса, определенного RFC 2609 для основанных на IP протоколов. Это - подмножество потому что user@host
синтаксис не поддерживается.
Другие синтаксисы, определенные RFC 2609, в настоящий момент не поддерживаются этим class.
Поддерживаемый синтаксис:
//[host[:port]][url-path]
Квадратные скобки []
укажите на дополнительные части адреса. Не все протоколы распознают все дополнительные части.
host
имя хоста, IPv4 числовой адрес узла, или IPv6 числовой адрес, включенный в квадратные скобки.
port
десятичный номер порта. 0 означает значение по умолчанию или анонимный порт, в зависимости от протокола.
host
и port
может быть опущен. port
не может быть предоставлен без a host
.
url-path
, если таковые вообще имеются, начинается с наклонной черты (/
) или точка с запятой (;
) и продолжается до конца адреса. Это может содержать атрибуты, используя синтаксис точки с запятой, определенный в RFC 2609. Те атрибуты не анализируются этим class, и неправильный синтаксис атрибута не обнаруживается.
Хотя законно согласно RFC 2609 иметь a url-path
это начинается с точки с запятой, не, все реализации SLP позволяют ее, таким образом, рекомендуется избежать что синтаксис.
Случай не является существенным в начальной букве service:jmx:protocol
строка или в части узла адреса. В зависимости от протокола случай может быть существенным в url-path
.
Конструктор и Описание |
---|
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.
|
public JMXServiceURL(String serviceURL) throws MalformedURLException
Конструкции a JMXServiceURL
анализируя Службу строка URL.
serviceURL
- строка URL, которая будет проанализирована.NullPointerException
- если serviceURL
нуль.MalformedURLException
- если serviceURL
не приспосабливает синтаксису для Реферативной службы URL или если это не допустимое имя для JMX Удаленная служба API. A JMXServiceURL
должен начаться со строки "service:jmx:"
(нечувствительный к регистру). Это не должно содержать символы, которые не являются печатаемыми символами ASCII.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
отрицательно.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
отрицательно.public String getProtocol()
Часть протокола Службы URL.
public String getHost()
Часть узла Службы URL. Если Служба, URL был создан с конструктором, который берет строковый параметр URL, результат, является подстрокой, определяющей узел в том URL. Если Служба, URL был создан с конструктором, который берет отдельный параметр узла, результат, является строкой, которая была определена. Если та строка была нулем, результат InetAddress.getLocalHost().getHostName()
.
В любом случае, если узел был определен, используя [...]
синтаксис для числовых адресов IPv6, квадратные скобки не включаются в возвращаемое значение здесь.
public int getPort()
Порт Службы URL. Если никакой порт не был определен, возвращенное значение 0.
public String getURLPath()
Часть Пути URL Службы URL. Это - пустая строка, или строка, начинающаяся с наклонной черты (/
), или строка, начинающаяся с точки с запятой (;
).
public String toString()
Строковое представление этой Службы URL. Если значение, возвращенное этим методом, предоставляется JMXServiceURL
конструктор, результирующий объект равен этому.
host
часть возвращенной строки является значением, возвращенным getHost()
. Если то значение определяет числовой адрес IPv6, оно окружается квадратными скобками []
.
port
часть возвращенной строки является значением, возвращенным getPort()
в его самой короткой десятичной форме. Если значение является нулем, оно опускается.
public boolean equals(Object obj)
Указывает, равен ли некоторый другой объект этому. Этот метод возвращает true если и только если obj
экземпляр JMXServiceURL
чей getProtocol()
, getHost()
, getPort()
, и getURLPath()
методы возвращают те же самые значения что касается этого объекта. Значения для getProtocol()
и getHost()
может отличаться в случае, если, не влияя на равенство.
equals
в class Object
obj
- ссылочный объект, с которым можно сравниться.true
если этот объект является тем же самым как obj
параметр; false
иначе.Object.hashCode()
, HashMap
public int hashCode()
Object
HashMap
. Общий контракт hashCode
:
hashCode
метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals
сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный class Object
действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92