クラスへのストレージ定義の追加

クラスへのストレージ定義の追加

クラス定義に新規のストレージ定義を追加するには、以下の 2 つの方法があります。

• クラス・エディタおよび [クラス]→[追加]→[ストレージ] を使用して、クラス定義にストレージ定義を追加する方法

• 新規ストレージ・ウィザードを使用する方法

クラス・インスペクタをストレージ定義で使用する

クラス・インスペクタを使用して、クラスのストレージ定義を視覚的に表示したり編集したりできます。クラス・インスペクタには、メソッドやプロパティの表示と同様にストレージ定義のリストが表示されます。

クラス・インスペクタで既存のストレージ定義を表示する方法は、以下のとおりです。

1. クラス・インスペクタを選択します。

2. インスペクタのメンバ・リスト・プルダウンで [Storage] を選択します。

3. ストレージ定義をダブルクリックします。

これで、クラス・インスペクタにストレージ・キーワードとその値が表示されます。

クラス・エディタをストレージ定義で使用する

クラス・エディタを使用して、クラスのストレージ定義を表示したり編集することができます。[ビュー]→[コードの展開] を使用すると、クラスのストレージ定義の表示を切り替えることができます。

ストレージ定義は、クラス定義の外部 XML 表示で使用されるのと同じ XML 要素を使用し、クラス定義の本文にインライン XML アイランドとして表示されます。

例えば、シンプルな MyApp.Person クラスを考慮してみましょう。

/// A simple persistent class
Class MyApp.Person Extends %Persistent 
{
Property Name As %String;
Property City As %String;
}

このクラスをコンパイルしたら、(クラス・コンパイラが、そのクラスに対するストレージ定義を生成したことを確認するため) [ビュー]→[コードの展開] を使用 (または、ブロックの最上行の隣にあるプラス・アイコンを選択) して、そのストレージ定義を表示します。これは、クラス・エディタ・ウィンドウで以下のように表示されます。

/// A simple persistent class
Class MyApp.Person Extends %Persistent 
{

Property Name As %String;
Property City As %String;

<Storage name="Default">
    <Data name="PersonDefaultData">
        <Value name="1">
            <Value>City</Value>
        </Value>
        <Value name="2">
            <Value>Name</Value>
        </Value>
    </Data>
    <DataLocation>^MyApp.PersonD</DataLocation>
    <DefaultData>PersonDefaultData</DefaultData>
    <IdLocation>^MyApp.PersonD</IdLocation>
    <IndexLocation>^MyApp.PersonI</IndexLocation>
    <Type>%Library.CacheStorage</Type>
</Storage>
}

XML ストレージ定義には、定義されたすべてのストレージ・キーワードと、XML 要素として表された対応する値が含まれています。

クラス定義と同様に、この定義はクラス・エディタで直接編集できます。無効な XML 構文を入力した場合、エラーとしてエディタにカラー表示でその構文が表示されます。

ストレージ定義は、単純な変更、または変更を繰り返す場合に便利です。

例えば、物理的なストレージ・レイアウトを変更することなく、プロパティ名を City から HomeCity に変更する場合 (つまり、新しい名前のプロパティで、古い名前のプロパティに保存されている値にアクセスする場合)を考慮してみましょう。これは、クラス・エディタを使用して以下のように行うことができます。

1. クラス定義をスタジオのクラス・エディタ・ウィンドウにロードし、そのストレージを表示します。

2. エディタの [既定値に戻す] コマンドを使用して、プロパティ City のすべてのオカレンスを HomeCity と置換します。(プロパティ定義、メソッド・コード、または説明、あるいはストレージ定義の本文の) プロパティ名である City のオカレンスだけを変更するように注意してください。他のクラス定義キーワードの値を置換しないでください。

3. クラス定義を保存し、再コンパイルします。