javax.management

Class Query

public class Query extends Object

Provides static methods for constructing queries. Queries may be used to list and enumerate management beans, via the MBeanServer. By using the methods in this class, complex queries can be created from their more basic components.

Since: 1.5

Field Summary
static intDIV
A code representing the
static intEQ
A code representing the
static intGE
A code representing the
static intGT
A code representing the
static intLE
A code representing the
static intLT
A code representing the
static intMINUS
A code representing the
static intPLUS
A code representing the
static intTIMES
A code representing the
Method Summary
static QueryExpand(QueryExp q1, QueryExp q2)
Returns a query expression formed from the conjunction of the two supplied query expressions.
static QueryExpanySubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp contains the string specified by the given StringValueExp.
static AttributeValueExpattr(String name)
Returns a value expression for the value of the named attribute.
static AttributeValueExpattr(String className, String name)
Returns a value expression for the value of the named attribute from the specified class.
static QueryExpbetween(ValueExp v1, ValueExp v2, ValueExp v3)
Returns a query expression representing the constraint that the value, v1, lies between v2 and v3.
static AttributeValueExpclassattr()
Returns a value expression which evaluates to the name of the class of the bean when applied.
static ValueExpdiv(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of dividing v1 by v2.
static QueryExpeq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 for equality.
static QueryExpfinalSubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp ends with the string specified by the given StringValueExp.
static QueryExpgeq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is greater than or equal to v2.
static QueryExpgt(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is greater than v2.
static QueryExpin(ValueExp v, ValueExp[] vlist)
Returns a query expression representing the constraint that the value, v, is a member of the list, vlist.
static QueryExpinitialSubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp starts with the string specified by the given StringValueExp.
static QueryExpisInstanceOf(StringValueExp className)
Returns a query expression which checks that a bean is an instance of the class specified by the given StringValueExp.
static QueryExpleq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is less than or equal to v2.
static QueryExplt(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is less than v2.
static QueryExpmatch(AttributeValueExp attrib, StringValueExp string)

Returns a query expression which checks that an attribute value matches the pattern specified by the given StringValueExp.

static ValueExpminus(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of subtracting v2 from v1.
static QueryExpnot(QueryExp q)
Returns a query expression representing the negation of the specified query expression.
static QueryExpor(QueryExp q1, QueryExp q2)
Returns a query expression formed from the disjunction of the two supplied query expressions.
static ValueExpplus(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of adding v1 to v2.
static ValueExptimes(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of multiplying v1 by v2.
static ValueExpvalue(boolean val)
Returns a value expression wrapping the specified value.
static ValueExpvalue(double val)
Returns a value expression wrapping the specified value.
static ValueExpvalue(float val)
Returns a value expression wrapping the specified value.
static ValueExpvalue(int val)
Returns a value expression wrapping the specified value.
static ValueExpvalue(long val)
Returns a value expression wrapping the specified value.
static ValueExpvalue(Number val)
Returns a value expression wrapping the specified value.
static StringValueExpvalue(String val)
Returns a value expression wrapping the specified string.

Field Detail

DIV

public static final int DIV
A code representing the query to be used in serialization.

EQ

public static final int EQ
A code representing the query to be used in serialization.

GE

public static final int GE
A code representing the query to be used in serialization.

GT

public static final int GT
A code representing the query to be used in serialization.

LE

public static final int LE
A code representing the query to be used in serialization.

LT

public static final int LT
A code representing the query to be used in serialization.

MINUS

public static final int MINUS
A code representing the query to be used in serialization.

PLUS

public static final int PLUS
A code representing the query to be used in serialization.

TIMES

public static final int TIMES
A code representing the query to be used in serialization.

Method Detail

and

public static QueryExp and(QueryExp q1, QueryExp q2)
Returns a query expression formed from the conjunction of the two supplied query expressions.

Parameters: q1 the first query expression. q2 the second query expression.

Returns: a query expression representing q1 && q2. This will be serialized as the non-public class AndQueryExp.

anySubString

public static QueryExp anySubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp contains the string specified by the given StringValueExp.

Parameters: attrib the attribute to match. string the substring to find.

Returns: a query expression representing attrib.matches("*" + string + "*"). This will be serialized as the non-public class MatchQueryExp.

attr

public static AttributeValueExp attr(String name)
Returns a value expression for the value of the named attribute. Evaluating this using an ObjectName involves an underlying call to getAttribute.

Parameters: name the name of the attribute.

Returns: a value expression which returns the value of the named attribute when applied.

attr

public static AttributeValueExp attr(String className, String name)
Returns a value expression for the value of the named attribute from the specified class. Evaluating this using an ObjectName involves an underlying call to both getObjectInstance and getAttribute.

Parameters: className the class containing the attribute. name the name of the attribute.

Returns: a value expression which returns the value of the named attribute when applied. This will be serialized as the non-public class QualifiedAttributeValueExp.

between

public static QueryExp between(ValueExp v1, ValueExp v2, ValueExp v3)
Returns a query expression representing the constraint that the value, v1, lies between v2 and v3.

Parameters: v1 the value to compare against the boundaries. v2 the lower boundary. v3 the upper boundary.

Returns: a query expression representing a comparison of v1 against v2 and v3. It returns true if v2 <= v1 <= v3. This will be serialized as the non-public class BetweenQueryExp.

classattr

public static AttributeValueExp classattr()
Returns a value expression which evaluates to the name of the class of the bean when applied. Associating the expression with an ObjectName involves an underlying call to both getObjectInstance to obtain this information.

Returns: a value expression which returns the class name of the bean to which it is applied. This will be serialized as the non-public class ClassAttributeValueExp.

div

public static ValueExp div(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of dividing v1 by v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the division when applied. This will be serialized as the non-public class BinaryOpValueExp with an operation of DIV.

eq

public static QueryExp eq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 for equality.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the comparison when applied. This will be serialized as the non-public class BinaryRelQueryExp with an operation of EQ.

finalSubString

public static QueryExp finalSubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp ends with the string specified by the given StringValueExp.

Parameters: attrib the attribute to match. string the substring to find.

Returns: a query expression representing attrib.matches("*" + string). This will be serialized as the non-public class MatchQueryExp.

geq

public static QueryExp geq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is greater than or equal to v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the comparison when applied. This will be serialized as the non-public class BinaryRelQueryExp with an operation of GE.

gt

public static QueryExp gt(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is greater than v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the comparison when applied. This will be serialized as the non-public class BinaryRelQueryExp with an operation of GT.

in

public static QueryExp in(ValueExp v, ValueExp[] vlist)
Returns a query expression representing the constraint that the value, v, is a member of the list, vlist.

Parameters: v the value to look for in the list. vlist the list of allowed values.

Returns: a query expression representing a membership check of v against the list, vlist. This will be serialized as the non-public class InQueryExp.

initialSubString

public static QueryExp initialSubString(AttributeValueExp attrib, StringValueExp string)
Returns a query expression which checks that an attribute value held by the specified AttributeValueExp starts with the string specified by the given StringValueExp.

Parameters: attrib the attribute to match. string the substring to find.

Returns: a query expression representing attrib.matches(string + "*"). This will be serialized as the non-public class MatchQueryExp.

isInstanceOf

public static QueryExp isInstanceOf(StringValueExp className)
Returns a query expression which checks that a bean is an instance of the class specified by the given StringValueExp. Associating the expression with an ObjectName involves an underlying call to MBeanServer using the value of ((StringValueExp) className.apply(objectName)).getValue() as the class name.

Parameters: className the name of the class which the bean should be an instance of.

Returns: a query expression representing the inheritance check. This will be serialized as the non-public class InstanceOfQueryExp.

Since: 1.6

leq

public static QueryExp leq(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is less than or equal to v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the comparison when applied. This will be serialized as the non-public class BinaryRelQueryExp with an operation of LE.

lt

public static QueryExp lt(ValueExp v1, ValueExp v2)
Returns a query expression which evaluates to the result of comparing v1 to v2 to see if v1 is less than v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the comparison when applied. This will be serialized as the non-public class BinaryRelQueryExp with an operation of LT.

match

public static QueryExp match(AttributeValueExp attrib, StringValueExp string)

Returns a query expression which checks that an attribute value matches the pattern specified by the given StringValueExp. The pattern uses file-globbing syntax:

Parameters: attrib the attribute to match. string the substring to find.

Returns: a query expression representing the result of matching the pattern against the evaluated value of the attribute. This will be serialized as the non-public class MatchQueryExp.

minus

public static ValueExp minus(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of subtracting v2 from v1.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the subtraction when applied. This will be serialized as the non-public class BinaryOpValueExp with an operation of MINUS.

not

public static QueryExp not(QueryExp q)
Returns a query expression representing the negation of the specified query expression.

Parameters: q the query to negate.

Returns: a query expression representing the negation of q. This will be serialized as the non-public class NotQueryExp.

or

public static QueryExp or(QueryExp q1, QueryExp q2)
Returns a query expression formed from the disjunction of the two supplied query expressions.

Parameters: q1 the first query expression. q2 the second query expression.

Returns: a query expression representing q1 || q2. This will be serialized as the non-public class OrQueryExp.

plus

public static ValueExp plus(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of adding v1 to v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the addition when applied. This will be serialized as the non-public class BinaryOpValueExp with an operation of PLUS.

times

public static ValueExp times(ValueExp v1, ValueExp v2)
Returns a value expression which evaluates to the result of multiplying v1 by v2.

Parameters: v1 the left-hand operand. v2 the right-hand operand.

Returns: a value expression which returns the result of the multiplication when applied. This will be serialized as the non-public class BinaryOpValueExp with an operation of TIMES.

value

public static ValueExp value(boolean val)
Returns a value expression wrapping the specified value.

Parameters: val the boolean value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class BooleanValueExp.

value

public static ValueExp value(double val)
Returns a value expression wrapping the specified value.

Parameters: val the double value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class NumericValueExp.

value

public static ValueExp value(float val)
Returns a value expression wrapping the specified value.

Parameters: val the float value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class NumericValueExp.

value

public static ValueExp value(int val)
Returns a value expression wrapping the specified value.

Parameters: val the integer value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class NumericValueExp.

value

public static ValueExp value(long val)
Returns a value expression wrapping the specified value.

Parameters: val the long value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class NumericValueExp.

value

public static ValueExp value(Number val)
Returns a value expression wrapping the specified value.

Parameters: val the Number value to wrap.

Returns: a value expression wrapping val. This will be serialized as the non-public class NumericValueExp.

value

public static StringValueExp value(String val)
Returns a value expression wrapping the specified string.

Parameters: val the String to wrap.

Returns: a StringValueExp wrapping val.