Класс ObjectName

java.lang.Object

javax.management.ObjectName

Все реализованные интерфейсы:: Serializable, Comparable<ObjectName>, QueryExp

public class ObjectName extends Object implements Comparable<ObjectName>, QueryExp

Представляет имя объекта MBean или шаблон, который может соответствовать именам нескольких MBean. Экземпляры этого класса неизменяемы.

Экземпляр этого класса можно использовать для представления:

Имени объекта
Шаблона имени объекта в контексте запроса

Имя объекта состоит из двух частей: домена и свойств-ключей.

Домен — это строка символов, не содержащая двоеточие (:). Рекомендуется, чтобы домен не содержал строку "//", зарезервированную для будущего использования.

Если домен содержит хотя бы одно вхождение символов подстановки — звездочки (*) или вопросительного знака (?), — имя объекта является шаблоном. Звездочка соответствует любой последовательности из нуля или более символов, а вопросительный знак — любому отдельному символу.

Если домен пуст, в определенных контекстах он заменяется на домен по умолчанию сервера MBean, в котором используется ObjectName.

Свойства-ключи — это неупорядоченный набор ключей и соответствующих им значений.

Каждый ключ — это непустая строка символов, которая не может содержать ни один из следующих символов: запятую (,), знак равенства (=), двоеточие, звездочку или вопросительный знак. Один и тот же ключ не может встречаться в одном ObjectName дважды.

Каждое значение, связанное с ключом, — это строка символов, которая может быть заключена в кавычки или не заключена в них.

Значение без кавычек — это строка символов, возможно пустая, которая не может содержать ни один из следующих символов: запятую, знак равенства, двоеточие или кавычку.

Если значение без кавычек содержит хотя бы одно вхождение символов подстановки — звездочки или вопросительного знака, — имя объекта является шаблоном значения свойства. Звездочка соответствует любой последовательности из нуля или более символов, а вопросительный знак — любому отдельному символу.

Значение в кавычках состоит из кавычки ("), за которой следует, возможно, пустая строка символов, а затем еще одна кавычка. Внутри строки символов обратная косая черта (\) имеет особое значение. За ней должен следовать один из следующих символов:

Еще одна обратная косая черта. Вторая обратная косая черта не имеет особого значения, и эти два символа представляют одну обратную косую черту.
Символ 'n'. Эти два символа представляют символ новой строки ('\n' в Java).
Кавычка. Эти два символа представляют кавычку, которая не считается завершающей кавычкой значения. Чтобы значение в кавычках было допустимым, в конце должна присутствовать закрывающая кавычка.
Вопросительный знак (?) или звездочка (*). Эти два символа представляют соответственно вопросительный знак или звездочку.

Кавычка не может находиться внутри значения в кавычках, кроме случая, когда ей непосредственно предшествует нечетное количество подряд идущих обратных косых черт.

Кавычки, окружающие значение в кавычках, и любые обратные косые черты внутри этого значения считаются его частью.

Если значение в кавычках содержит хотя бы одно вхождение символов звездочки или вопросительного знака, не предваренное обратной косой чертой, они считаются символами подстановки, а имя объекта является шаблоном значения свойства. Звездочка соответствует любой последовательности из нуля или более символов, а вопросительный знак — любому отдельному символу.

ObjectName может быть шаблоном списка свойств. В этом случае он может содержать ноль или более ключей и соответствующих им значений. Он соответствует ObjectName, не являющемуся шаблоном, домен которого совпадает и который содержит те же ключи и соответствующие им значения, а также, возможно, другие ключи и значения.

ObjectName является шаблоном значения свойства, если хотя бы одно из значений его свойств-ключей, заключенных или не заключенных в кавычки, содержит символы подстановки — звездочку или вопросительный знак, как описано выше. В этом случае он содержит один или более ключей и соответствующих им значений, причем хотя бы одно из значений содержит символы подстановки. Он соответствует ObjectName, не являющемуся шаблоном, домен которого совпадает и который содержит те же ключи со значениями, соответствующими шаблону; если шаблон значения свойства также является шаблоном списка свойств, ObjectName, не являющийся шаблоном, может содержать другие ключи и значения.

ObjectName является шаблоном свойств, если он представляет собой шаблон списка свойств, шаблон значения свойства или и то и другое.

ObjectName является шаблоном, если его домен содержит символ подстановки или если ObjectName является шаблоном свойств.

Если ObjectName не является шаблоном, он должен содержать хотя бы один ключ с соответствующим ему значением.

Примеры шаблонов ObjectName:

*:type=Foo,name=Bar соответствует именам в любом домене, точный набор ключей которых — type=Foo,name=Bar.
d:type=Foo,name=Bar,* соответствует именам в домене d, содержащим ключи type=Foo,name=Bar и ноль или более других ключей.
*:type=Foo,name=Bar,* соответствует именам в любом домене, содержащим ключи type=Foo,name=Bar и ноль или более других ключей.
d:type=F?o,name=Bar будет соответствовать, например, d:type=Foo,name=Bar и d:type=Fro,name=Bar.
d:type=F*o,name=Bar будет соответствовать, например, d:type=Fo,name=Bar и d:type=Frodo,name=Bar.
d:type=Foo,name="B*" будет соответствовать, например, d:type=Foo,name="Bling". Символы подстановки распознаются даже внутри кавычек и, как и другие специальные символы, могут быть экранированы с помощью \.

ObjectName можно записать в виде строки со следующими элементами в указанном порядке:

Домен.
Двоеточие (:).
Список свойств-ключей, определенный ниже.

Список свойств-ключей, записанный в виде строки, представляет собой разделенный запятыми список элементов. Каждый элемент — это звездочка или свойство-ключ. Свойство-ключ состоит из ключа, знака равенства (=) и соответствующего значения.

В списке свойств-ключей может быть не более одного элемента-звездочки. Если список свойств-ключей содержит элемент-звездочку, ObjectName является шаблоном списка свойств.

Пробелы не имеют особого значения в строке, представляющей ObjectName. Например, строка:

domain: key1 = value1 , key2 = value2

представляет ObjectName с двумя ключами. Имя каждого ключа состоит из шести символов, причем первый и последний символы — пробелы. Значение, связанное с ключом " key1 ", также начинается и заканчивается пробелом.

Помимо перечисленных выше ограничений на символы, ни одна часть ObjectName не может содержать символ новой строки ('\n'): ни домен, ни ключ, ни значение, независимо от того, заключено оно в кавычки или нет. Символ новой строки можно представить в значении в кавычках последовательностью \n.

Правила использования специальных символов и кавычек применяются независимо от того, какой конструктор используется для создания ObjectName.

Чтобы избежать конфликтов между MBean, предоставляемыми разными поставщиками, полезно начинать имя домена с обратного DNS-имени организации, определяющей MBean, за которым следуют точка и строка, смысл которой определяется этой организацией. Например, домены MBean, определенных example.com, могли бы выглядеть так: com.example.MyDomain. По сути, это то же соглашение, что и для имен пакетов языка Java.

serialVersionUID этого класса — 1081892073854801359L.

Примечание по реализации:

Максимально допустимая длина имени домена в данной реализации составляет Integer.MAX_VALUE/4

Начиная с версии:

1.5

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final ObjectName`	`WILDCARD`	Определяет ObjectName-шаблон ":".

Краткое описание конструкторов

Конструктор	Описание
`ObjectName(String name)`	Создает имя объекта из заданной строки.
`ObjectName(String domain, String key, String value)`	Создает имя объекта ровно с одним свойством-ключом.
`ObjectName(String domain, Hashtable<String,String> table)`	Создает имя объекта с несколькими свойствами-ключами из Hashtable.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`apply(ObjectName name)`	Проверяет, соответствует ли этот ObjectName, который может быть шаблоном, другому ObjectName.
`int`	`compareTo(ObjectName name)`	Сравнивает два экземпляра ObjectName.
`boolean`	`equals(Object object)`	Сравнивает текущее имя объекта с другим именем объекта.
`String`	`getCanonicalKeyPropertyListString()`	Возвращает строковое представление списка свойств-ключей, в котором свойства-ключи отсортированы в лексикографическом порядке.
`String`	`getCanonicalName()`	Возвращает каноническую форму имени, то есть строковое представление, в котором свойства отсортированы в лексикографическом порядке.
`String`	`getDomain()`	Возвращает часть, содержащую домен.
`static ObjectName`	`getInstance(String name)`	Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью `new ObjectName(name)`.
`static ObjectName`	`getInstance(String domain, String key, String value)`	Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью `new ObjectName(domain, key, value)`.
`static ObjectName`	`getInstance(String domain, Hashtable<String,String> table)`	Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью `new ObjectName(domain, table)`.
`static ObjectName`	`getInstance(ObjectName name)`	Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать заданный объект.
`String`	`getKeyProperty(String property)`	Получает значение, связанное с ключом в свойстве-ключе.
`Hashtable<String,String>`	`getKeyPropertyList()`	Возвращает свойства-ключи в виде Hashtable.
`String`	`getKeyPropertyListString()`	Возвращает строковое представление списка свойств-ключей, заданного при создании.
`int`	`hashCode()`	Возвращает хеш-код этого имени объекта.
`boolean`	`isDomainPattern()`	Проверяет, является ли имя объекта шаблоном в части домена.
`boolean`	`isPattern()`	Проверяет, является ли имя объекта шаблоном.
`boolean`	`isPropertyListPattern()`	Проверяет, является ли имя объекта шаблоном списка свойств-ключей.
`boolean`	`isPropertyPattern()`	Проверяет, является ли имя объекта шаблоном свойств-ключей.
`boolean`	`isPropertyValuePattern()`	Проверяет, является ли имя объекта шаблоном по части значения хотя бы одного из свойств-ключей.
`boolean`	`isPropertyValuePattern(String property)`	Проверяет, является ли шаблоном значение, связанное с ключом в свойстве-ключе.
`static String`	`quote(String s)`	Возвращает заданную строку в кавычках, пригодную для включения в ObjectName.
`void`	`setMBeanServer(MBeanServer mbs)`	Задает сервер MBean, на котором должен выполняться запрос.
`String`	`toString()`	Возвращает строковое представление имени объекта.
`static String`	`unquote(String q)`	Возвращает заданную строку без кавычек.

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

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

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

Подробное описание полей

WILDCARD

public static final ObjectName WILDCARD

Определяет ObjectName-шаблон "*:*".

Начиная с:: 1.6

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

ObjectName

public ObjectName(String name) throws MalformedObjectNameException

Создаёт имя объекта из указанной строки.

Параметры:: name — строковое представление имени объекта.
Исключения:: MalformedObjectNameException — строка, переданная в качестве параметра, имеет неверный формат.; NullPointerException — параметр name равен null.

ObjectName

public ObjectName(String domain, String key, String value) throws MalformedObjectNameException

Создаёт имя объекта ровно с одним ключевым свойством.

Параметры:: domain — доменная часть имени объекта.; key — атрибут ключевого свойства имени объекта.; value — значение ключевого свойства имени объекта.
Исключения:: MalformedObjectNameException — domain, key или value содержит недопустимый символ, либо value не соответствует правилам заключения в кавычки, либо длина домена превышает максимально допустимую.; NullPointerException — один из параметров равен null.

ObjectName

public ObjectName(String domain, Hashtable<String,String> table) throws MalformedObjectNameException

Создаёт имя объекта с несколькими ключевыми свойствами из Hashtable.

Параметры:: domain — доменная часть имени объекта.; table — хеш-таблица, содержащая одно или несколько ключевых свойств. Ключ каждой записи в таблице является ключом ключевого свойства имени объекта. Связанное значение в таблице является соответствующим значением в имени объекта.
Исключения:: MalformedObjectNameException — domain содержит недопустимый символ, либо один из ключей или значений в table содержит недопустимый символ, либо одно из значений в table не соответствует правилам заключения в кавычки, либо длина домена превышает максимально допустимую.; NullPointerException — один из параметров равен null.

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

getInstance

public static ObjectName getInstance(String name) throws MalformedObjectNameException, NullPointerException

Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью new ObjectName(name). Возвращаемый объект может быть экземпляром подкласса ObjectName. При двух вызовах этого метода с одинаковыми параметрами может быть возвращён один и тот же объект либо два равных, но не идентичных объекта.

Параметры:: name — строковое представление имени объекта.
Возвращает:: ObjectName, соответствующий указанной строке.
Исключения:: MalformedObjectNameException — строка, переданная в качестве параметра, имеет неверный формат.; NullPointerException — параметр name равен null.

getInstance

public static ObjectName getInstance(String domain, String key, String value) throws MalformedObjectNameException

Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью new ObjectName(domain, key, value). Возвращаемый объект может быть экземпляром подкласса ObjectName. При двух вызовах этого метода с одинаковыми параметрами может быть возвращён один и тот же объект либо два равных, но не идентичных объекта.

Параметры:: domain — доменная часть имени объекта.; key — атрибут ключевого свойства имени объекта.; value — значение ключевого свойства имени объекта.
Возвращает:: ObjectName, соответствующий указанным домену, ключу и значению.
Исключения:: MalformedObjectNameException — domain, key или value содержит недопустимый символ, либо value не соответствует правилам заключения в кавычки, либо длина домена превышает максимально допустимую.; NullPointerException — один из параметров равен null.

getInstance

public static ObjectName getInstance(String domain, Hashtable<String,String> table) throws MalformedObjectNameException

Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать объект, полученный с помощью new ObjectName(domain, table). Возвращаемый объект может быть экземпляром подкласса ObjectName. При двух вызовах этого метода с одинаковыми параметрами может быть возвращён один и тот же объект либо два равных, но не идентичных объекта.

Параметры:: domain — доменная часть имени объекта.; table — хеш-таблица, содержащая одно или несколько ключевых свойств. Ключ каждой записи в таблице является ключом ключевого свойства имени объекта. Связанное значение в таблице является соответствующим значением в имени объекта.
Возвращает:: ObjectName, соответствующий указанному домену и отображениям ключей.
Исключения:: MalformedObjectNameException — domain содержит недопустимый символ, либо один из ключей или значений в table содержит недопустимый символ, либо одно из значений в table не соответствует правилам заключения в кавычки, либо длина домена превышает максимально допустимую.; NullPointerException — один из параметров равен null.

getInstance

public static ObjectName getInstance(ObjectName name)

Возвращает экземпляр ObjectName, который можно использовать везде, где можно использовать указанный объект. Возвращаемый объект может быть экземпляром подкласса ObjectName. Если name является экземпляром подкласса ObjectName, не гарантируется, что возвращённый объект будет принадлежать к тому же классу.

Возвращённое значение может быть идентично name, а может и не быть. При двух вызовах этого метода с одинаковыми параметрами может быть возвращён один и тот же объект либо два равных, но не идентичных объекта.

Поскольку ObjectName является неизменяемым классом, обычно нет смысла создавать копию ObjectName. Основное назначение этого метода — защитить код, работающий с чувствительными данными, от злоумышленника, который может передать экземпляр подкласса с неожиданным поведением. Такой код может вызвать этот метод, чтобы получить ObjectName, поведение которого заведомо предсказуемо.

Параметры:: name — экземпляр класса ObjectName или его подкласса
Возвращает:: экземпляр ObjectName или его подкласса, для которого гарантирована та же семантика. Если name соответствует семантике ObjectName, возвращённый объект равен (хотя и не обязательно идентичен) name.
Исключения:: NullPointerException — name равен null.

isPattern

public boolean isPattern()

Проверяет, является ли имя объекта шаблоном.

Имя объекта является шаблоном, если его домен содержит подстановочный знак или если имя объекта является шаблоном свойств.

Возвращает:: Истина, если имя является шаблоном, иначе ложь.

isDomainPattern

public boolean isDomainPattern()

Проверяет, является ли доменная часть имени объекта шаблоном.

Возвращает:: Истина, если имя является шаблоном домена, иначе ложь.

isPropertyPattern

public boolean isPropertyPattern()

Проверяет, является ли имя объекта шаблоном ключевых свойств.

Имя объекта является шаблоном ключевых свойств, если оно представляет собой шаблон списка ключевых свойств (например, "d:k=v,*"), шаблон значений свойств (например, "d:k=*") или оба варианта сразу (например, "d:k=*,*").

Возвращает:: Истина, если имя является шаблоном свойств, иначе ложь.

isPropertyListPattern

public boolean isPropertyListPattern()

Проверяет, является ли имя объекта шаблоном списка ключевых свойств.

Например, "d:k=v,*" и "d:k=*,*" являются шаблонами списка ключевых свойств, а "d:k=*" — нет.

Возвращает:: Истина, если имя является шаблоном списка свойств, иначе ложь.
Начиная с:: 1.6

isPropertyValuePattern

public boolean isPropertyValuePattern()

Проверяет, является ли хотя бы одно значение ключевого свойства шаблоном.

Например, "d:k=*" и "d:k=*,*" являются шаблонами значений свойств, а "d:k=v,*" — нет.

Возвращает:: Истина, если имя является шаблоном значения свойства, иначе ложь.
Начиная с:: 1.6

isPropertyValuePattern

public boolean isPropertyValuePattern(String property)

Проверяет, является ли значение, связанное с ключом в ключевом свойстве, шаблоном.

Параметры:: property — свойство, значение которого нужно проверить.
Возвращает:: Истина, если значение, связанное с указанным ключевым свойством, является шаблоном, иначе ложь.
Исключения:: NullPointerException — если property равно null.; IllegalArgumentException — если property не является допустимым ключевым свойством для этого ObjectName.
Начиная с:: 1.6

getCanonicalName

public String getCanonicalName()

Возвращает каноническую форму имени, то есть строковое представление, в котором свойства отсортированы в лексикографическом порядке.

Точнее, каноническая форма имени — это строка, состоящая из доменной части, двоеточия (:), канонического списка ключевых свойств и обозначения шаблона.

Канонический список ключевых свойств — это та же строка, которая описана для getCanonicalKeyPropertyListString().

Обозначение шаблона имеет следующий вид:

пустая строка для ObjectName, который не является шаблоном списка свойств;
звёздочка для ObjectName, являющегося шаблоном списка свойств без ключей; или
запятая и звёздочка (,*) для ObjectName, являющегося шаблоном списка свойств с одним или несколькими ключами.

Возвращает:: Каноническую форму имени.

getDomain

public String getDomain()

Возвращает доменную часть.

Возвращает:: Домен.

getKeyProperty

public String getKeyProperty(String property)

Получает значение, связанное с ключом в ключевом свойстве.

Параметры:: property — свойство, значение которого нужно получить.
Возвращает:: Значение свойства или null, если в этом ObjectName нет такого свойства.
Исключения:: NullPointerException — если property равно null.

getKeyPropertyList

public Hashtable<String,String> getKeyPropertyList()

Возвращает ключевые свойства в виде Hashtable. Возвращаемое значение — это Hashtable, в которой каждый ключ является ключом из списка ключевых свойств ObjectName, а каждое значение — соответствующим значением.

Возвращаемое значение может быть неизменяемым. Если его можно изменить, изменения не повлияют на этот ObjectName.

Возвращает:: Таблицу ключевых свойств.

getKeyPropertyListString

public String getKeyPropertyListString()

Возвращает строковое представление списка ключевых свойств, заданных при создании. Если этот ObjectName был создан с помощью конструктора ObjectName(String), ключевые свойства в возвращаемой строке будут расположены в том же порядке, что и в аргументе конструктора.

Возвращает:: Строку списка ключевых свойств. Эта строка не зависит от того, является ли ObjectName шаблоном.

getCanonicalKeyPropertyListString

public String getCanonicalKeyPropertyListString()

Возвращает строковое представление списка ключевых свойств, в котором ключевые свойства отсортированы в лексикографическом порядке. Это используется при лексикографических сравнениях, выполняемых для выбора MBean на основе списка их ключевых свойств. Лексикографический порядок определяется методом String.compareTo(String).

Возвращает:: Строку канонического списка ключевых свойств. Эта строка не зависит от того, является ли ObjectName шаблоном.

toString

public String toString()

Возвращает строковое представление имени объекта. Формат этой строки не определён, но можно ожидать, что два объекта ObjectName возвращают одну и ту же строку тогда и только тогда, когда они равны.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого имени объекта.

equals

public boolean equals(Object object)

Сравнивает текущее имя объекта с другим именем объекта. Два экземпляра ObjectName равны тогда и только тогда, когда их канонические формы равны. Каноническая форма — это строка, описанная для getCanonicalName().

Переопределяет:

equals в классе Object

Параметры:

object — имя объекта, с которым нужно сравнить текущее имя объекта.

Возвращает:

Истина, если object является ObjectName, каноническая форма которого равна канонической форме этого ObjectName.

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этого имени объекта.

Переопределяет:

hashCode в классе Object

Возвращает:

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

См. также:

quote

public static String quote(String s)

Возвращает заключённую в кавычки форму указанной строки, пригодную для включения в ObjectName. Возвращённое значение можно использовать в качестве значения, связанного с ключом в ObjectName. Строка s может содержать любые символы. Правильное заключение в кавычки гарантирует, что возвращённое значение допустимо в ObjectName.

Возвращённое значение состоит из кавычки ('"'), последовательности символов, соответствующих символам s, и ещё одной кавычки. Символы в s остаются неизменными в возвращённом значении, за исключением следующих случаев:

Кавычка ('"') заменяется обратной косой чертой (\), за которой следует кавычка.
Звёздочка ('*') заменяется обратной косой чертой (\), за которой следует звёздочка.
Знак вопроса ('?') заменяется обратной косой чертой (\), за которой следует знак вопроса.
Обратная косая черта ('\') заменяется двумя обратными косыми чертами.
Символ новой строки (символ '\n' в Java) заменяется обратной косой чертой, за которой следует символ '\n'.

Параметры:: s — строка, которую нужно заключить в кавычки.
Возвращает:: строку в кавычках.
Исключения:: NullPointerException — если s равно null.

unquote

public static String unquote(String q)

Возвращает форму указанной строки без кавычек. Если q — это строка, возвращённая методом quote(s), то unquote(q).equals(s). Если не существует строки s, для которой выполняется quote(s).equals(q), вызов unquote(q) выбрасывает IllegalArgumentException.

Из этих правил следует, что между формами в кавычках и без кавычек существует взаимно однозначное соответствие.

Параметры:: q — строка, из которой нужно удалить кавычки.
Возвращает:: строку без кавычек.
Исключения:: IllegalArgumentException — если q не могла быть возвращена методом quote(String), например если она не начинается и не заканчивается кавычкой (").; NullPointerException — если q равно null.

apply

public boolean apply(ObjectName name)

Проверяет, соответствует ли этот ObjectName, который может быть шаблоном, другому ObjectName. Если name является шаблоном, результатом будет false. Если этот ObjectName является шаблоном, результатом будет true тогда и только тогда, когда name соответствует шаблону. Если ни этот ObjectName, ни name не являются шаблонами, результатом будет true тогда и только тогда, когда два объекта ObjectName равны, как описано для метода equals(Object).

Определён в:: apply в интерфейсе QueryExp
Параметры:: name — имя MBean для сравнения.
Возвращает:: Истина, если name соответствует этому ObjectName.
Исключения:: NullPointerException — если name равно null.

setMBeanServer

public void setMBeanServer(MBeanServer mbs)

Описание скопировано из интерфейса: QueryExp

Задаёт сервер MBean, на котором должен выполняться запрос.

Определён в:: setMBeanServer в интерфейсе QueryExp
Параметры:: mbs — сервер MBean, на котором должен выполняться запрос.

compareTo

public int compareTo(ObjectName name)

Сравнивает два экземпляра ObjectName. Порядок сортировки ObjectName определён не полностью, но предполагается, что отсортированный список ObjectName будет упорядочен так, чтобы его было удобно читать.

В частности, если домены двух экземпляров ObjectName различаются, их порядок определяется лексикографическим порядком доменов. Порядок списка ключевых свойств не определён.

Например, экземпляры ObjectName ниже:

Shapes:type=Square,name=3
Colors:type=Red,name=2
Shapes:type=Triangle,side=isosceles,name=2
Colors:type=Red,name=1
Shapes:type=Square,name=1
Colors:type=Blue,name=1
Shapes:type=Square,name=2
JMImplementation:type=MBeanServerDelegate
Shapes:type=Triangle,side=scalene,name=1

могут быть упорядочены следующим образом:

Colors:type=Blue,name=1
Colors:type=Red,name=1
Colors:type=Red,name=2
JMImplementation:type=MBeanServerDelegate
Shapes:type=Square,name=1
Shapes:type=Square,name=2
Shapes:type=Square,name=3
Shapes:type=Triangle,side=scalene,name=1
Shapes:type=Triangle,side=isosceles,name=2

Определён в:: compareTo в интерфейсе Comparable<ObjectName>
Параметры:: name — сравниваемый ObjectName.
Возвращает:: отрицательное целое число, ноль или положительное целое число, если этот ObjectName меньше, равен или больше указанного ObjectName.
Начиная с:: 1.6

© 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.