Класс 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")));

Since:: 1.5

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

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

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

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

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

GT

public static final int GT

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

См. также:

Значения постоянных полей

LT

public static final int LT

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

См. также:

Значения постоянных полей

GE

public static final int GE

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

См. также:

Значения постоянных полей

LE

public static final int LE

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

См. также:

Значения постоянных полей

EQ

public static final int EQ

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

См. также:

Значения постоянных полей

PLUS

public static final int PLUS

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

См. также:

Значения постоянных полей

MINUS

public static final int MINUS

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

См. также:

Значения постоянных полей

TIMES

public static final int TIMES

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

См. также:

Значения постоянных полей

DIV

public static final int DIV

Код, представляющий выражение div(javax.management.ValueExp, javax.management.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)

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

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

attr

public static AttributeValueExp attr(String name)

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

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

Parameters:: name - Имя атрибута.
Returns:: Выражение атрибута для атрибута с именем name.

attr

public static AttributeValueExp attr(String className, String name)

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

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

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

classattr

public static AttributeValueExp classattr()

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

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

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

not

public static QueryExp not(QueryExp queryExp)

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

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

in

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

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

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

value

public static StringValueExp value(String val)

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

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

value

public static ValueExp value(Number val)

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

Parameters:: val - Экземпляр Number.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.NumericValueExp.

value

public static ValueExp value(int val)

Parameters:: val - Целочисленное значение.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.NumericValueExp.

value

public static ValueExp value(long val)

Parameters:: val - Длинное целое значение.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.NumericValueExp.

value

public static ValueExp value(float val)

Parameters:: val - Вещественное значение с плавающей точкой.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.NumericValueExp.

value

public static ValueExp value(double val)

Parameters:: val - Двойное значение.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.NumericValueExp.

value

public static ValueExp value(boolean val)

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

Parameters:: val - Логическое значение.
Returns:: Объект ValueExp, содержащий аргумент. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BooleanValueExp.

plus

public static ValueExp plus(ValueExp value1, ValueExp value2)

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

Parameters:: value1 - Первый операнд '+'.; value2 - Второй операнд '+'.
Returns:: ValueExp, представляющий сумму или конкатенацию двух аргументов. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным PLUS.

times

public static ValueExp times(ValueExp value1, ValueExp value2)

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

Parameters:: value1 - Первый операнд '*'.; value2 - Второй операнд '*'.
Returns:: ValueExp, представляющий произведение. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным TIMES.

вычитание

public static ValueExp minus(ValueExp value1, ValueExp value2)

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

Параметры:: value1 - Первый операнд '-'.; value2 - Второй операнд '-'.
Возвращает:: ValueExp, представляющий разность двух аргументов. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным MINUS.

деление

public static ValueExp div(ValueExp value1, ValueExp value2)

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

Параметры:: value1 - Первый операнд '/'.; value2 - Второй операнд '/'.
Возвращает:: ValueExp, представляющий частное двух аргументов. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным DIV.

initialSubString

public static QueryExp initialSubString(AttributeValueExp a, StringValueExp s)

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

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

anySubString

public static QueryExp anySubString(AttributeValueExp a, StringValueExp s)

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

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

finalSubString

public static QueryExp finalSubString(AttributeValueExp a, StringValueExp s)

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

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

isInstanceOf

public static QueryExp isInstanceOf(StringValueExp classNameValue)

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

Пример: чтобы найти MBean, которые являются экземплярами NotificationBroadcaster, используйте Query.isInstanceOf(Query.value(NotificationBroadcaster.class.getName())).

Вычисление этого выражения для данного objectName включает выполнение MBeanServer.isInstanceOf(objectName, ((StringValueExp)classNameValue.apply(objectName)).getValue().

Параметры:: classNameValue - StringValueExp, возвращающий имя класса, экземплярами которого должны быть выбранные MBean.
Возвращает:: выражение запроса, представляющее ограничение наследования для класса MBean. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.InstanceOfQueryExp.
С:: 1.6

© 1993, 2021, 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/17/docs/api/java.management/javax/management/Query.html