Класс Query

java.lang.Object

javax.management.Query

public class Query extends Object

Создает ограничения для объектов запросов.

Сервер MBean можно запросить, чтобы найти MBean, удовлетворяющие определенному условию, с помощью метода queryNames или queryMBeans. Параметром QueryExp этого метода может быть любая реализация интерфейса QueryExp, однако обычно лучше получить значение QueryExp, вызвав статические методы этого класса. Особенно это важно при запросе удаленного сервера MBean: пользовательская реализация интерфейса QueryExp может отсутствовать на удаленном сервере MBean, тогда как методы этого класса возвращают только стандартные классы, входящие в реализацию JMX.

Предположим, например, что вы хотите найти все MBean, у которых атрибут Enabled имеет значение true, а атрибут Owner — значение "Duke". Ниже показано, как можно создать подходящий QueryExp, объединив вызовы методов:

QueryExp query =
    Query.and(Query.eq(Query.attr("Enabled"), Query.value(true)),
              Query.eq(Query.attr("Owner"), Query.value("Duke")));

Начиная с:: 1.5

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

Модификатор и тип	Поле	Описание
`static final int`	`DIV`	Код, представляющий выражение `div(ValueExp, ValueExp)`.
`static final int`	`EQ`	Код, представляющий запрос `eq(ValueExp, ValueExp)`.
`static final int`	`GE`	Код, представляющий запрос `geq(ValueExp, ValueExp)`.
`static final int`	`GT`	Код, представляющий запрос `gt(ValueExp, ValueExp)`.
`static final int`	`LE`	Код, представляющий запрос `leq(ValueExp, ValueExp)`.
`static final int`	`LT`	Код, представляющий запрос `lt(ValueExp, ValueExp)`.
`static final int`	`MINUS`	Код, представляющий выражение `minus(ValueExp, ValueExp)`.
`static final int`	`PLUS`	Код, представляющий выражение `plus(ValueExp, ValueExp)`.
`static final int`	`TIMES`	Код, представляющий выражение `times(ValueExp, ValueExp)`.

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

Конструктор	Описание
`Query()`	Базовый конструктор.

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

Модификатор и тип	Метод	Описание
`static QueryExp`	`and(QueryExp q1, QueryExp q2)`	Возвращает выражение запроса, представляющее собой конъюнкцию двух других выражений запроса.
`static QueryExp`	`anySubString(AttributeValueExp a, StringValueExp s)`	Возвращает выражение запроса, представляющее ограничение сопоставления строкового аргумента.
`static AttributeValueExp`	`attr(String name)`	Возвращает новое выражение атрибута.
`static AttributeValueExp`	`attr(String className, String name)`	Возвращает новое выражение квалифицированного атрибута.
`static QueryExp`	`between(ValueExp v1, ValueExp v2, ValueExp v3)`	Возвращает выражение запроса, представляющее ограничение, согласно которому одно значение должно находиться между двумя другими значениями.
`static AttributeValueExp`	`classattr()`	Возвращает новое выражение атрибута класса, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`div(ValueExp value1, ValueExp value2)`	Возвращает бинарное выражение, представляющее частное от деления двух числовых значений.
`static QueryExp`	`eq(ValueExp v1, ValueExp v2)`	Возвращает выражение запроса, представляющее ограничение равенства двух значений.
`static QueryExp`	`finalSubString(AttributeValueExp a, StringValueExp s)`	Возвращает выражение запроса, представляющее ограничение сопоставления строкового аргумента.
`static QueryExp`	`geq(ValueExp v1, ValueExp v2)`	Возвращает выражение запроса, представляющее ограничение «больше или равно» для двух значений.
`static QueryExp`	`gt(ValueExp v1, ValueExp v2)`	Возвращает выражение запроса, представляющее ограничение «больше» для двух значений.
`static QueryExp`	`in(ValueExp val, ValueExp[] valueList)`	Возвращает выражение, ограничивающее значение одним из явно перечисленных значений.
`static QueryExp`	`initialSubString(AttributeValueExp a, StringValueExp s)`	Возвращает выражение запроса, представляющее ограничение сопоставления строкового аргумента.
`static QueryExp`	`isInstanceOf(StringValueExp classNameValue)`	Возвращает выражение запроса, представляющее ограничение наследования для класса MBean.
`static QueryExp`	`leq(ValueExp v1, ValueExp v2)`	Возвращает выражение запроса, представляющее ограничение «меньше или равно» для двух значений.
`static QueryExp`	`lt(ValueExp v1, ValueExp v2)`	Возвращает выражение запроса, представляющее ограничение «меньше» для двух значений.
`static QueryExp`	`match(AttributeValueExp a, StringValueExp s)`	Возвращает выражение запроса, представляющее ограничение сопоставления строкового аргумента.
`static ValueExp`	`minus(ValueExp value1, ValueExp value2)`	Возвращает бинарное выражение, представляющее разность двух числовых значений.
`static QueryExp`	`not(QueryExp queryExp)`	Возвращает ограничение, являющееся отрицанием своего аргумента.
`static QueryExp`	`or(QueryExp q1, QueryExp q2)`	Возвращает выражение запроса, представляющее собой дизъюнкцию двух других выражений запроса.
`static ValueExp`	`plus(ValueExp value1, ValueExp value2)`	Возвращает бинарное выражение, представляющее сумму двух числовых значений или конкатенацию двух строковых значений.
`static ValueExp`	`times(ValueExp value1, ValueExp value2)`	Возвращает бинарное выражение, представляющее произведение двух числовых значений.
`static ValueExp`	`value(boolean val)`	Возвращает логическое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`value(double val)`	Возвращает числовое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`value(float val)`	Возвращает числовое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`value(int val)`	Возвращает числовое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`value(long val)`	Возвращает числовое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static ValueExp`	`value(Number val)`	Возвращает числовое выражение, которое можно использовать в любом вызове Query, ожидающем ValueExp.
`static StringValueExp`	`value(String val)`	Возвращает новое строковое выражение.

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

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

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

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

GT

public static final int GT

Код, представляющий запрос gt(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

LT

public static final int LT

Код, представляющий запрос lt(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

GE

public static final int GE

Код, представляющий запрос geq(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

LE

public static final int LE

Код, представляющий запрос leq(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

EQ

public static final int EQ

Код, представляющий запрос eq(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

PLUS

public static final int PLUS

Код, представляющий выражение plus(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

MINUS

public static final int MINUS

Код, представляющий выражение minus(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

TIMES

public static final int TIMES

Код, представляющий выражение times(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

DIV

public static final int DIV

Код, представляющий выражение div(ValueExp, ValueExp). Он представляет интерес главным образом для сериализованной формы запросов.

См. также:

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

Query

public Query()

Базовый конструктор.

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

and

public static QueryExp and(QueryExp q1, QueryExp q2)

Возвращает выражение запроса, являющееся конъюнкцией двух других выражений запроса.

Параметры:: q1 — выражение запроса.; q2 — другое выражение запроса.
Возвращает:: Конъюнкцию двух аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.AndQueryExp.

or

public static QueryExp or(QueryExp q1, QueryExp q2)

Возвращает выражение запроса, являющееся дизъюнкцией двух других выражений запроса.

Параметры:: q1 — выражение запроса.; q2 — другое выражение запроса.
Возвращает:: Дизъюнкцию двух аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.OrQueryExp.

gt

public static QueryExp gt(ValueExp v1, ValueExp v2)

Возвращает выражение запроса, представляющее условие «больше» для двух значений.

Параметры:: v1 — выражение значения.; v2 — другое выражение значения.
Возвращает:: Условие «больше» для аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BinaryRelQueryExp со значением relOp, равным GT.

geq

public static QueryExp geq(ValueExp v1, ValueExp v2)

Возвращает выражение запроса, представляющее условие «больше или равно» для двух значений.

Параметры:: v1 — выражение значения.; v2 — другое выражение значения.
Возвращает:: Условие «больше или равно» для аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BinaryRelQueryExp со значением relOp, равным GE.

leq

public static QueryExp leq(ValueExp v1, ValueExp v2)

Возвращает выражение запроса, представляющее условие «меньше или равно» для двух значений.

Параметры:: v1 — выражение значения.; v2 — другое выражение значения.
Возвращает:: Условие «меньше или равно» для аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BinaryRelQueryExp со значением relOp, равным LE.

lt

public static QueryExp lt(ValueExp v1, ValueExp v2)

Возвращает выражение запроса, представляющее условие «меньше» для двух значений.

Параметры:: v1 — выражение значения.; v2 — другое выражение значения.
Возвращает:: Условие «меньше» для аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BinaryRelQueryExp со значением relOp, равным LT.

eq

public static QueryExp eq(ValueExp v1, ValueExp v2)

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

Параметры:: v1 — выражение значения.; v2 — другое выражение значения.
Возвращает:: Условие «равно» для аргументов. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BinaryRelQueryExp со значением relOp, равным EQ.

between

public static QueryExp between(ValueExp v1, ValueExp v2, ValueExp v3)

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

Параметры:: v1 — выражение значения, которое находится «между» v2 и v3.; v2 — выражение значения, представляющее одну границу условия.; v3 — выражение значения, представляющее одну границу условия.
Возвращает:: Условие, что v1 находится между v2 и v3. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.BetweenQueryExp.

match

public static QueryExp match(AttributeValueExp a, StringValueExp s)

Возвращает выражение запроса, представляющее условие сопоставления строкового аргумента. Синтаксис сопоставления соответствует поиску файлов с использованием шаблонов glob: поддерживаются «?», «*», «[», каждый из которых можно экранировать с помощью «\»; в классах символов для отрицания можно использовать «!», а для диапазона — «-». (* для любой последовательности символов, ? для одного произвольного символа, [...] для последовательности символов). Например: a*b?c соответствует строке, начинающейся с символа a, за которым следует любое количество символов, а затем b, любой одиночный символ и c.

Параметры:: a — выражение атрибута; s — строковое выражение значения, представляющее условие сопоставления
Возвращает:: Выражение запроса, представляющее условие сопоставления строкового аргумента. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.MatchQueryExp.

attr

public static AttributeValueExp attr(String name)

Возвращает новое выражение атрибута. Подробное описание семантики выражения см. в разделе AttributeValueExp.

Вычисление этого выражения для заданного objectName включает выполнение MBeanServer.getAttribute(objectName, name).

Параметры:: name — имя атрибута.
Возвращает:: Выражение атрибута для атрибута с именем name.

attr

public static AttributeValueExp attr(String className, String name)

Возвращает новое квалифицированное выражение атрибута.

Вычисление этого выражения для заданного objectName включает выполнение MBeanServer.getObjectInstance(objectName) и MBeanServer.getAttribute(objectName, name).

Параметры:: className — имя класса, которому принадлежит атрибут.; name — имя атрибута.
Возвращает:: Выражение атрибута для атрибута с именем name. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.QualifiedAttributeValueExp.

classattr

public static AttributeValueExp classattr()

Возвращает новое выражение атрибута класса, которое можно использовать в любом вызове Query, ожидающем ValueExp.

Вычисление этого выражения для заданного objectName включает выполнение MBeanServer.getObjectInstance(objectName).

Возвращает:: Выражение атрибута класса. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.ClassAttributeValueExp.

not

public static QueryExp not(QueryExp queryExp)

Возвращает условие, являющееся отрицанием аргумента.

Параметры:: queryExp — условие, которое требуется отрицать.
Возвращает:: Отрицание условия. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.NotQueryExp.

in

public static QueryExp in(ValueExp val, ValueExp[] valueList)

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

Параметры:: val — ограничиваемое значение.; valueList — массив ValueExp.
Возвращает:: QueryExp, представляющий условие. Возвращённый объект будет сериализован как экземпляр непубличного класса javax.management.InQueryExp.

value

public static StringValueExp value(String val)

Возвращает новое строковое выражение.

Параметры:: val — строковое значение.
Возвращает:: Объект ValueExp, содержащий строковый аргумент.