JavaTM 2 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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only