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

Поля

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.

Параметры:

a - Выражение атрибута

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

Возвращает:

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

attr

public static AttributeValueExp attr(String name)

Параметры:

name - Название атрибута.

Возвращает:

Выражение атрибута для атрибута с именем name.

attr

public static AttributeValueExp attr(String className,
                                     String name)

Параметры:

className - Имя класса, содержащего атрибут.

name - Имя атрибута.

Возвращает:

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

classattr

public static AttributeValueExp classattr()

Возвращает:

Выражение атрибута класса. Возвращаемый объект будет сериализован как экземпляр закрытого класса 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 - Массив ValueExps.

Возвращает:

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

value

public static StringValueExp value(String val)

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

Параметры:

val - Строковое значение.

Возвращает:

Объект ValueExp, содержащий строковый аргумент.

value

public static ValueExp value(Number val)

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

Параметры:

val - Экземпляр Number.

Возвращает:

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

value

public static ValueExp value(int val)

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

Параметры:

val - Целочисленное значение.

Возвращает:

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

value

public static ValueExp value(long val)

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

Параметры:

val - Значение типа long.

Возвращает:

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

value

public static ValueExp value(float val)

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

Параметры:

val - Значение типа float.

Возвращает:

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

value

public static ValueExp value(double val)

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

Параметры:

val - Значение типа double.

Возвращает:

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

value

public static ValueExp value(boolean val)

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

Параметры:

val - Булевое значение.

Возвращает:

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

plus

public static ValueExp plus(ValueExp value1,
                            ValueExp value2)

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

Параметры:

value1 - Первый операнд '+'.

value2 - Второй операнд '+'.

Возвращает:

ValueExp, представляющий сумму или конкатенацию двух аргументов. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным PLUS.

times

public static ValueExp times(ValueExp value1,
                             ValueExp value2)

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

Параметры:

value1 - Первый операнд '*'.

value2 - Второй операнд '*'.

Возвращает:

ValueExp, представляющий произведение. Возвращаемый объект будет сериализован как экземпляр закрытого класса javax.management.BinaryOpValueExp с op равным TIMES.

minus

public static ValueExp minus(ValueExp value1,
                             ValueExp value2)

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

Параметры:

value1 - Первый операнд '-'.

value2 - Второй операнд '-'.

Возвращает:

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

div

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)

Параметры:

classNameValue - The StringValueExp возвращающий имя класса, экземплярами которого должны быть выбранные MBeans.

Возвращаемое значение:

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

С момента:

1.6