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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/// A simple persistent class

Class User.Person Extends %Persistent
{

Property Name As %String;

Property City As %String;

Storage Default
{
<Data name="PersonDefaultData">
    <Value name="1">
        <Value>%%CLASSNAME</Value>
    </Value>
    <Value name="2">
        <Value>Name</Value>
    </Value>
    <Value name="3">
        <Value>City</Value>
    </Value>
</Data>
<DataLocation>^User.PersonD</DataLocation>
<DefaultData>PersonDefaultData</DefaultData>
<IdLocation>^User.PersonD</IdLocation>
<IndexLocation>^User.PersonI</IndexLocation>
<StreamLocation>^User.PersonS</StreamLocation>
<Type>%Storage.Persistent</Type>
}

}

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

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

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

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

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

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

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