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)
          2 つのほかのクエリー式を結合した 1 つのクエリー式を返します。
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)
          2 つの値の間の 1 つの値の制約を表すクエリー式を返します。
static AttributeValueExp classattr()
           ValueExp を取得する Query 呼び出しで使用可能な新しいクラス属性式を返します。
static ValueExp div(ValueExp value1, ValueExp value2)
          2 つの数値の商を表すバイナリ式を返します。
static QueryExp eq(ValueExp v1, ValueExp v2)
          2 つの値の等価制約を表すクエリー式を返します。
static QueryExp finalSubString(AttributeValueExp a, StringValueExp s)
          文字列引数のマッチング制約を表すクエリー式を返します。
static QueryExp geq(ValueExp v1, ValueExp v2)
          2 つの値の「大なりまたは等価」制約を表すクエリー式を返します。
static QueryExp gt(ValueExp v1, ValueExp v2)
          2 つの値の「大なり」制約を表すクエリー式を返します。
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)
          2 つの値の「小なりまたは等価」制約を表すクエリー式を返します。
static QueryExp lt(ValueExp v1, ValueExp v2)
          2 つの値の「小なり」制約を表すクエリー式を返します。
static QueryExp match(AttributeValueExp a, StringValueExp s)
          文字列引数のマッチング制約を表すクエリー式を返します。
static ValueExp minus(ValueExp value1, ValueExp value2)
          2 つの数値の差を表すバイナリ式を返します。
static QueryExp not(QueryExp queryExp)
          引数の否定になっている制約を返します。
static QueryExp or(QueryExp q1, QueryExp q2)
          2 つのほかのクエリー式を分離した 1 つのクエリー式を返します。
static ValueExp plus(ValueExp value1, ValueExp value2)
          2 つの数値の和、または 2 つの文字列値の連結を表すバイナリ式を返します。
static ValueExp times(ValueExp value1, ValueExp value2)
          2 つの数値の積を表すバイナリ式を返します。
static ValueExp value(boolean val)
          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)
2 つのほかのクエリー式を結合した 1 つのクエリー式を返します。

パラメータ:
q1 - クエリー式
q2 - もう 1 つのクエリー式
戻り値:
2 つの引数を結合したもの返されるオブジェクトは、非 public クラス javax.management.AndQueryExp のインスタンスとして直列化される

or

public static QueryExp or(QueryExp q1,
                          QueryExp q2)
2 つのほかのクエリー式を分離した 1 つのクエリー式を返します。

パラメータ:
q1 - クエリー式
q2 - もう 1 つのクエリー式
戻り値:
2 つの引数を分離したもの返されるオブジェクトは、非 public クラス javax.management.OrQueryExp のインスタンスとして直列化される

gt

public static QueryExp gt(ValueExp v1,
                          ValueExp v2)
2 つの値の「大なり」制約を表すクエリー式を返します。

パラメータ:
v1 - 値式
v2 - もう 1 つの値式
戻り値:
引数の「大なり」制約返されるオブジェクトは、relOpGT が等しい非 public クラス javax.management.BinaryRelQueryExp のインスタンスとして直列化される

geq

public static QueryExp geq(ValueExp v1,
                           ValueExp v2)
2 つの値の「大なりまたは等価」制約を表すクエリー式を返します。

パラメータ:
v1 - 値式
v2 - もう 1 つの値式
戻り値:
引数の「大なりまたは等価」 制約。返されるオブジェクトは、relOpGE が等しい非 public クラス javax.management.BinaryRelQueryExp のインスタンスとして直列化される

leq

public static QueryExp leq(ValueExp v1,
                           ValueExp v2)
2 つの値の「小なりまたは等価」制約を表すクエリー式を返します。

パラメータ:
v1 - 値式
v2 - もう 1 つの値式
戻り値:
引数の「小なりまたは等価」制約返されるオブジェクトは、relOpLE が等しい非 public クラス javax.management.BinaryRelQueryExp のインスタンスとして直列化される

lt

public static QueryExp lt(ValueExp v1,
                          ValueExp v2)
2 つの値の「小なり」制約を表すクエリー式を返します。

パラメータ:
v1 - 値式
v2 - もう 1 つの値式
戻り値:
引数の「小なり」制約返されるオブジェクトは、relOpLT が等しい非 public クラス javax.management.BinaryRelQueryExp のインスタンスとして直列化される

eq

public static QueryExp eq(ValueExp v1,
                          ValueExp v2)
2 つの値の等価制約を表すクエリー式を返します。

パラメータ:
v1 - 値式
v2 - もう 1 つの値式
戻り値:
引数の「等価」制約返されるオブジェクトは、relOpEQ が等しい非 public クラス javax.management.BinaryRelQueryExp のインスタンスとして直列化される

between

public static QueryExp between(ValueExp v1,
                               ValueExp v2,
                               ValueExp v3)
2 つの値の間の 1 つの値の制約を表すクエリー式を返します。

パラメータ:
v1 - v2 と v3 の間の値式
v2 - 制約の境界を表す値式
v3 - 制約の境界を表す値式
戻り値:
v1 を v2 と v3 の中間に配置する制約返されるオブジェクトは、非 public クラス javax.management.BetweenQueryExp のインスタンスとして直列化される

match

public static QueryExp match(AttributeValueExp a,
                             StringValueExp s)
文字列引数のマッチング制約を表すクエリー式を返します。マッチングの構文はファイルグロッビング (生成) に準拠しており、バックスラッシュ「\」でエスケープされた疑問符「?」、アスタリスク「*」、角括弧「[」をサポートします。文字クラスでは、否定を意味する感嘆符「!」、範囲を意味するハイフン「-」を使用できます。アスタリスク「*」は任意の文字シーケンス、疑問符「?」は任意の 1 文字、[...] を意味します。たとえば、a*b?c は、文字 a で始まり、任意の文字列のあと、b、その次に任意の単一文字、最後に c が続く文字列に一致します。

パラメータ:
a - 属性式
s - マッチング制約を表す文字列値式
戻り値:
文字列引数のマッチング制約を表す クエリー式。返されるオブジェクトは、非 public クラス 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 - 属性の名前
戻り値:
属性で指定された名前の属性式返されるオブジェクトは、非 public クラス javax.management.QualifiedAttributeValueExp のインスタンスとして直列化される

classattr

public static AttributeValueExp classattr()
 

ValueExp を取得する Query 呼び出しで使用可能な新しいクラス属性式を返します。

 

指定の objectName について、この式を評価します。 評価の一環として、MBeanServer.getObjectInstance(objectName) が実行されます。

戻り値:
クラス属性式返されるオブジェクトは、非 public クラス javax.management.ClassAttributeValueExp のインスタンスとして直列化される

not

public static QueryExp not(QueryExp queryExp)
引数の否定になっている制約を返します。

パラメータ:
queryExp - 否定する制約
戻り値:
否定された制約返されるオブジェクトは、非 public クラス javax.management.NotQueryExp のインスタンスとして直列化される

in

public static QueryExp in(ValueExp val,
                          ValueExp[] valueList)
明示リストのいずれかの値に制約を課す式を返します。

パラメータ:
val - 制約を課される値
valueList - ValueExp の配列
戻り値:
制約を表す QueryExp返されるオブジェクトは、非 public クラス javax.management.InQueryExp のインスタンスとして直列化される

value

public static StringValueExp value(String val)
新しい文字列式を返します。

パラメータ:
val - 文字列値
戻り値:
文字列引数を含む ValueExp オブジェクト

value

public static ValueExp value(Number val)
ValueExp を取得する Query 呼び出しで使用可能な数値式を返します。

パラメータ:
val - Number のインスタンス
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.NumericValueExp のインスタンスとして直列化される

value

public static ValueExp value(int val)
ValueExp を取得する Query 呼び出しで使用可能な数値式を返します。

パラメータ:
val - int 値
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.NumericValueExp のインスタンスとして直列化される

value

public static ValueExp value(long val)
ValueExp を取得する Query 呼び出しで使用可能な数値式を返します。

パラメータ:
val - long 値
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.NumericValueExp のインスタンスとして直列化される

value

public static ValueExp value(float val)
ValueExp を取得する Query 呼び出しで使用可能な数値式を返します。

パラメータ:
val - float 値
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.NumericValueExp のインスタンスとして直列化される

value

public static ValueExp value(double val)
ValueExp を取得する Query 呼び出しで使用可能な数値式を返します。

パラメータ:
val - double 値
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.NumericValueExp のインスタンスとして直列化される

value

public static ValueExp value(boolean val)
ValueExp を取得する Query 呼び出しで使用可能なブール値の式を返します。

パラメータ:
val - ブール値
戻り値:
引数を含む ValueExp オブジェクト返されるオブジェクトは、非 public クラス javax.management.BooleanValueExp のインスタンスとして直列化される

plus

public static ValueExp plus(ValueExp value1,
                            ValueExp value2)
2 つの数値の和、または 2 つの文字列値の連結を表すバイナリ式を返します。

パラメータ:
value1 - 最初の「+」オペランド
value2 - 2 番目の「+」オペランド
戻り値:
2 つの引数の和または 連結を表す ValueExp。返されるオブジェクトは、opPLUS が等しい非 public クラス javax.management.BinaryOpValueExp のインスタンスとして直列化される

times

public static ValueExp times(ValueExp value1,
                             ValueExp value2)
2 つの数値の積を表すバイナリ式を返します。

パラメータ:
value1 - 最初の「*」オペランド
value2 - 2 番目の「*」オペランド
戻り値:
積を表す ValueExp返されるオブジェクトは、opTIMES が等しい非 public クラス javax.management.BinaryOpValueExp のインスタンスとして直列化される

minus

public static ValueExp minus(ValueExp value1,
                             ValueExp value2)
2 つの数値の差を表すバイナリ式を返します。

パラメータ:
value1 - 最初の「-」オペランド
value2 - 2 番目の「-」オペランド
戻り値:
2 つの引数の差を 表す ValueExp。返されるオブジェクトは、opMINUS が等しい非 public クラス javax.management.BinaryOpValueExp のインスタンスとして直列化される

div

public static ValueExp div(ValueExp value1,
                           ValueExp value2)
2 つの数値の商を表すバイナリ式を返します。

パラメータ:
value1 - 最初の「/」オペランド
value2 - 2 番目の「/」オペランド
戻り値:
2 つの引数の商を表す ValueExp返されるオブジェクトは、opDIV が等しい非 public クラス javax.management.BinaryOpValueExp のインスタンスとして直列化される

initialSubString

public static QueryExp initialSubString(AttributeValueExp a,
                                        StringValueExp s)
文字列引数のマッチング制約を表すクエリー式を返します。値は、指定のリテラル文字列値で開始します。

パラメータ:
a - 属性式
s - 文字列値の開始を表す 文字列値式
戻り値:
s に一致する制約。 返されるオブジェクトは、非 public クラス javax.management.MatchQueryExp のインスタンスとして直列化される

anySubString

public static QueryExp anySubString(AttributeValueExp a,
                                    StringValueExp s)
文字列引数のマッチング制約を表すクエリー式を返します。値には、指定のリテラル文字列値が含まれていなければいけません。

パラメータ:
a - 属性式
s - サブ文字列を表す文字列値式
戻り値:
s に一致する制約。 返されるオブジェクトは、非 public クラス javax.management.MatchQueryExp のインスタンスとして直列化される

finalSubString

public static QueryExp finalSubString(AttributeValueExp a,
                                      StringValueExp s)
文字列引数のマッチング制約を表すクエリー式を返します。値は、指定のリテラル文字列値で終了します。

パラメータ:
a - 属性式
s - 文字列値の終了を表す 文字列値式
戻り値:
s に一致する制約。 返されるオブジェクトは、非 public クラス 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 - 選択した MBean がインスタンスである クラスの名前を返す StringValueExp
戻り値:
MBean クラスに対する 継承制約を表すクエリー式。返されるオブジェクトは、非 public クラス javax.management.InstanceOfQueryExp のインスタンスとして直列化される
導入されたバージョン:
1.6

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。