インスタンスの取得と設定

クライアントアプリケーションは、一般に、getInstance メソッドを使って CIMOM から CIM インスタンスを取得します。クラスのインスタンスが作成されると、クラスはクラス階層内のすべての親クラスのプロパティを継承します。getInstance メソッドは、ブール値引数 localOnly を受け取ります。

• localOnly が true の場合、getInstance メソッドは指定されたインスタンスの非継承プロパティだけを返します。非継承プロパティは、インスタンス内で定義されます。

• localOnly が false の場合、クラス内のすべてのプロパティが返されます。たとえば、インスタンス内で定義されたプロパティや、クラス階層内のすべての親クラスから継承されたすべてのプロパティが返されます。

既存のインスタンスを更新する場合は、setInstance メソッドを使用します。

例 4–7 インスタンスの取得と設定

この例は次のことを行います。

• 列挙内のオブジェクトパスのインスタンスを取得する

• 各インスタンス内の b のプロパティ値を 10 に更新する

• 更新されたインスタンスを CIMOM に渡す

...
{
    // オブジェクトパス、myclass という CIM 名を含むオブジェクト
    // を作成する
    CIMObjectPath cop = new CIMObjectPath("myclass"); 

    /* 列挙内の各インスタンスオブジェクトパスのインスタンスを取得し、
    各インスタンス内で b のプロパティ値を 10 に更新し、
    更新したインスタンスを CIM オブジェクトマネージャに渡す */
    
    while(e.hasMoreElements()) {
        CIMInstance ci = cc.getInstance((CIMObjectPath)
                         (e.nextElement()),true, true, true, null);
        ci.setProperty("b", new CIMValue(new Integer(10)));
        cc.setInstance(new CIMObjectPath(),ci);
    }
}
...