Запрос (Платформа Java SE 7)

java.lang. Объект
- javax.management. Запрос

```
public class Query
extends Object
```
Конструкции запрашивают объектные ограничения.

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

Как пример, предположите, что Вы хотели найти весь MBeans где 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 int`	`DIV` Код, представляющий `div(javax.management.ValueExp, javax.management.ValueExp)` выражение.
`static int`	`EQ` Код, представляющий `eq(javax.management.ValueExp, javax.management.ValueExp)` запрос.
`static int`	`GE` Код, представляющий `geq(javax.management.ValueExp, javax.management.ValueExp)` запрос.
`static int`	`GT` Код, представляющий `gt(javax.management.ValueExp, javax.management.ValueExp)` запрос.
`static int`	`LE` Код, представляющий `leq(javax.management.ValueExp, javax.management.ValueExp)` запрос.
`static int`	`LT` Код, представляющий `lt(javax.management.ValueExp, javax.management.ValueExp)` запрос.
`static int`	`МИНУС` Код, представляющий `minus(javax.management.ValueExp, javax.management.ValueExp)` выражение.
`static int`	`ПЛЮС` Код, представляющий `plus(javax.management.ValueExp, javax.management.ValueExp)` выражение.
`static int`	`ВРЕМЕНА` Код, представляющий `times(javax.management.ValueExp, javax.management.ValueExp)` выражение.

Сводка конструктора

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

Query()
Основной конструктор.

Конструкторы
Конструктор и Описание
`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()` Возвращает новое выражение атрибута класса, которое может использоваться в любом вызове Запроса, который ожидает 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)` Возвращает выражение булева значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static ValueExp`	`value(double val)` Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static ValueExp`	`value(float val)` Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static ValueExp`	`value(int val)` Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static ValueExp`	`value(long val)` Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static ValueExp`	`value(Number val)` Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
`static StringValueExp`	`value(String val)` Возвращает новое строковое выражение.

Методы java.lang унаследованный от класса. Объект
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) запрос. Это является в основном представляющим интерес для сериализированной формы запросов.
    
    См. Также:
    Постоянные Значения полей
  - ПЛЮС
```
public static final int PLUS
```
    Код, представляющий plus(javax.management.ValueExp, javax.management.ValueExp) выражение. Это является в основном представляющим интерес для сериализированной формы запросов.
    
    См. Также:
    Постоянные Значения полей
  - МИНУС
```
public static final int MINUS
```
    Код, представляющий minus(javax.management.ValueExp, javax.management.ValueExp) выражение. Это является в основном представляющим интерес для сериализированной формы запросов.
    
    См. Также:
    Постоянные Значения полей
  - ВРЕМЕНА
```
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) выражение. Это является в основном представляющим интерес для сериализированной формы запросов.
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - Запрос
```
public Query()
```
    Основной конструктор.
- Деталь метода
  - и
```
public static QueryExp and(QueryExp q1,
           QueryExp q2)
```
    Возвращает выражение запроса, которое является соединением двух других выражений запроса.
    
    Параметры:
    q1 - Выражение запроса.
    q2 - Другое выражение запроса.
    
    Возвраты:
    Соединение этих двух параметров. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. AndQueryExp.
  - или
```
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 с a relOp равный GT.
  - geq
```
public static QueryExp geq(ValueExp v1,
           ValueExp v2)
```
    Возвращает выражение запроса, которое представляет "больше чем или равный" ограничению на два значения.
    
    Параметры:
    v1 - Выражение.
    v2 - Другое выражение.
    
    Возвраты:
    "Больше чем или равный" ограничению на параметры. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BinaryRelQueryExp с a relOp равный GE.
  - leq
```
public static QueryExp leq(ValueExp v1,
           ValueExp v2)
```
    Возвращает выражение запроса, которое представляет "меньше чем или равный" ограничению на два значения.
    
    Параметры:
    v1 - Выражение.
    v2 - Другое выражение.
    
    Возвраты:
    "Меньше чем или равный" ограничению на параметры. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BinaryRelQueryExp с a relOp равный LE.
  - лейтенант
```
public static QueryExp lt(ValueExp v1,
          ValueExp v2)
```
    Возвращает выражение запроса, которое представляет "меньше чем" ограничение на два значения.
    
    Параметры:
    v1 - Выражение.
    v2 - Другое выражение.
    
    Возвраты:
    "Меньше чем" ограничение на параметры. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BinaryRelQueryExp с a relOp равный LT.
  - eq
```
public static QueryExp eq(ValueExp v1,
          ValueExp v2)
```
    Возвращает выражение запроса, которое представляет ограничение равенства на два значения.
    
    Параметры:
    v1 - Выражение.
    v2 - Другое выражение.
    
    Возвраты:
    "Равный" ограничению на параметры. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BinaryRelQueryExp с a relOp равный EQ.
  - между
```
public static QueryExp between(ValueExp v1,
               ValueExp v2,
               ValueExp v3)
```
    Возвращает выражение запроса, которое представляет ограничение, что одно значение между двумя другими значениями.
    
    Параметры:
    v1 - Выражение, которое является "между" v2 и v3.
    v2 - Выражение, которое представляет границу ограничения.
    v3 - Выражение, которое представляет границу ограничения.
    
    Возвраты:
    Ограничение, что v1 находится между v2 и v3. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BetweenQueryExp.
  - соответствие
```
public static QueryExp match(AttributeValueExp a,
             StringValueExp s)
```
    Возвращает выражение запроса, которое представляет соответствующее ограничение на строковый параметр. Соответствующий синтаксис является непротиворечивым с файлом globbing: поддерживает"?", "*", "[", каждого из которых можно оставить с"\"; классы символов могут использовать"!"для отрицания и"-"для диапазона. (* для любой символьной последовательности, ? для единственного произвольного символа, [...] для символьной последовательности). Например: a*b?c соответствовал бы строку, запускающуюся с символа a, сопровождаемый любым числом символов, сопровождаемых a b, любой единственный символ, и a 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 - Имя атрибута.
    
    Возвраты:
    Выражение атрибута для атрибута, названного именем. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management.QualifiedAttributeValueExp.
  - classattr
```
public static AttributeValueExp classattr()
```
    Возвращает новое выражение атрибута класса, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Оценка этого выражения для данного objectName включает выполнение MBeanServer.getObjectInstance(objectName).
    
    Возвраты:
    Выражение атрибута класса. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. ClassAttributeValueExp.
  - нет
```
public static QueryExp not(QueryExp queryExp)
```
    Возвращает ограничение, которое является отрицанием его параметра.
    
    Параметры:
    queryExp - Ограничение, чтобы инвертировать.
    
    Возвраты:
    Отрицаемое ограничение. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NotQueryExp.
  - в
```
public static QueryExp in(ValueExp val,
          ValueExp[] valueList)
```
    Возвращает выражение, ограничивающее значение быть одним из явного списка.
    
    Параметры:
    val - Значение, которое будет ограничено.
    valueList - Массив ValueExps.
    
    Возвраты:
    QueryExp, который представляет ограничение. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. InQueryExp.
  - значение
```
public static StringValueExp value(String val)
```
    Возвращает новое строковое выражение.
    
    Параметры:
    val - Строковое значение.
    
    Возвраты:
    Объект ValueExp, содержащий строковый параметр.
  - значение
```
public static ValueExp value(Number val)
```
    Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Экземпляр Числа.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NumericValueExp.
  - значение
```
public static ValueExp value(int val)
```
    Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Международное значение.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NumericValueExp.
  - значение
```
public static ValueExp value(long val)
```
    Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Длинное значение.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NumericValueExp.
  - значение
```
public static ValueExp value(float val)
```
    Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Значение плавающее.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NumericValueExp.
  - значение
```
public static ValueExp value(double val)
```
    Возвращает выражение числового значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Двойное значение.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. NumericValueExp.
  - значение
```
public static ValueExp value(boolean val)
```
    Возвращает выражение булева значения, которое может использоваться в любом вызове Запроса, который ожидает ValueExp.
    
    Параметры:
    val - Булево значение.
    
    Возвраты:
    Объект ValueExp, содержащий параметр. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BooleanValueExp.
  - плюс
```
public static ValueExp plus(ValueExp value1,
            ValueExp value2)
```
    Возвращает двоичное выражение, представляющее сумму двух числовых значений, или связь двух строковых значений.
    
    Параметры:
    value1 - Первое '+' операнд.
    value2 - Второе '+' операнд.
    
    Возвраты:
    ValueExp, представляющий сумму или связь этих двух параметров. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. BinaryOpValueExp с op равный PLUS.
  - времена
```
public static ValueExp times(ValueExp value1,
             ValueExp value2)
```
    Возвращает двоичное выражение, представляющее продукт двух числовых значений.
    
    Параметры:
    value1 - Первое '*' операнд.
    value2 - Второе '*' операнд.
    
    Возвраты:
    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 - Строковое выражение, представляющее начало строкового значения.
    
    Возвраты:
    Ограничение, что соответствия s. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. MatchQueryExp.
  - anySubString
```
public static QueryExp anySubString(AttributeValueExp a,
                    StringValueExp s)
```
    Возвращает выражение запроса, которое представляет соответствующее ограничение на строковый параметр. Значение должно содержать данное значение литеральной строки.
    
    Параметры:
    a - Выражение атрибута.
    s - Строковое выражение, представляющее подстроку.
    
    Возвраты:
    Ограничение, что соответствия s. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. MatchQueryExp.
  - finalSubString
```
public static QueryExp finalSubString(AttributeValueExp a,
                      StringValueExp s)
```
    Возвращает выражение запроса, которое представляет соответствующее ограничение на строковый параметр. Значение должно закончиться данным значением литеральной строки.
    
    Параметры:
    a - Выражение атрибута.
    s - Строковое выражение, представляющее конец строкового значения.
    
    Возвраты:
    Ограничение, что соответствия s. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. MatchQueryExp.
  - isInstanceOf
```
public static QueryExp isInstanceOf(StringValueExp classNameValue)
```
    Возвращает выражение запроса, которое представляет ограничение наследования на класс MBean.
    Пример: найти MBeans, которые являются экземплярами NotificationBroadcaster, использовать Query.isInstanceOf(Query.value(NotificationBroadcaster.class.getName())).
    
    Оценка этого выражения для данного objectName включает выполнение MBeanServer.isInstanceOf(objectName, ((StringValueExp)classNameValue.apply(objectName)).getValue().
    
    Параметры:
    classNameValue - StringValueExp возврат имени класса, которого выбрал MBeans, должен быть экземплярами.
    
    Возвраты:
    выражение запроса, которое представляет ограничение наследования на класс MBean. Возвращенный объект будет сериализирован как экземпляр непубличного класса javax.management. InstanceOfQueryExp.
    С тех пор:
    
    1.6

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Запрос класса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

GT

LT

GE

LE

EQ

ПЛЮС

МИНУС

ВРЕМЕНА

DIV

Деталь конструктора

Запрос

Деталь метода

и

или

gt

geq

leq

лейтенант

eq

между

соответствие

attr

attr

classattr

нет

в

значение

значение

значение

значение

значение

значение

значение

плюс

времена

минус

отделение

initialSubString

anySubString

finalSubString

isInstanceOf