JavaTM Platform
Standard Ed. 6

javax.management
类 Query

java.lang.Object
  继承者 javax.management.Query

public class Query
extends Object

构造查询对象约束。提供的 static 方法返回可用来列出和枚举 MBean 的查询表达式。每种约束构造方法仅允许使用适当的类型作为参数。如下例所述,混合调用可以构造约束的随意嵌套:

 QueryExp exp = Query.and(Query.gt(Query.attr("age"),Query.value(5)),
                          Query.match(Query.attr("name"),
                                      Query.value("Smith")));
 

从以下版本开始:
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
          表示 minus(javax.management.ValueExp, javax.management.ValueExp) 表达式的代码。
static int PLUS
          表示 plus(javax.management.ValueExp, javax.management.ValueExp) 表达式的代码。
static 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()
          返回一个新的类属性表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
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)
          返回一个 boolean 值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
static ValueExp value(double val)
          返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
static ValueExp value(float val)
          返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
static ValueExp value(int val)
          返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
static ValueExp value(long val)
          返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
static ValueExp value(Number val)
          返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。
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)
返回一个查询表达式,表示基于字符串参数的匹配约束条件。匹配的语法与文件 globbing 一致:支持 "?"、"*" 和 "[",其中的每一项都可以使用 "\" 转义;字符类可以使用 "!" 来否定,使用 "-" 来划定范围。(* 用于任何字符序列,? 用于任意单个字符,[...] 用于字符序列)。例如:与 a*b?c 匹配的将是以字符 a 开头,后跟任意数量的字符,再接 b、任意单个字符,然后接 c 的一个字符串。

参数:
a - 属性表达式
s - 表示匹配约束条件的字符串值表达式
返回:
一个查询表达式,表示基于字符串参数的匹配约束条件。返回对象将被序列化为非公共类 javax.management.MatchQueryExp 的实例。

attr

public static AttributeValueExp attr(String name)

返回新的属性表达式。

针对给定的 objectName 计算此表达式,包括执行 MBeanServer.getAttribute(objectName、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 的 Query 调用中。

针对给定的 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 对象。

value

public static ValueExp value(Number val)
返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - Number 的实例。
返回:
包含参数的 ValueExp 对象。返回对象将被序列化为非公共类 javax.management.NumericValueExp 的实例。

value

public static ValueExp value(int val)
返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - 一个 int 值。
返回:
包含参数的 ValueExp 对象。返回对象将被序列化为非公共类 javax.management.NumericValueExp 的实例。

value

public static ValueExp value(long val)
返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - 一个 long 值。
返回:
包含参数的 ValueExp 对象。返回对象将被序列化为非公共类 javax.management.NumericValueExp 的实例。

value

public static ValueExp value(float val)
返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - 一个 float 值。
返回:
包含参数的 ValueExp 对象。返回对象将被序列化为非公共类 javax.management.NumericValueExp 的实例。

value

public static ValueExp value(double val)
返回一个数值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - 一个 double 值。
返回:
包含参数的 ValueExp 对象。返回对象将被序列化为非公共类 javax.management.NumericValueExp 的实例。

value

public static ValueExp value(boolean val)
返回一个 boolean 值表达式,该表达式可用于任何希望获得 ValueExp 的 Query 调用中。

参数:
val - 一个 boolean 值。
返回:
包含参数的 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)
返回一个查询表达式,表示基于 MBean 类的继承约束条件。

示例:要找到作为 NotificationBroadcaster 实例的 MBean,使用 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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策