クラスへのプロジェクションの追加
この章では、クラス定義にプロジェクション定義を追加する方法を説明します。
プロジェクション定義では、クラス定義がコンパイルされたとき、または削除されたときに、InterSystems IRIS® クラス・コンパイラが指定された操作を実行するように指示します。プロジェクションは、(%Projection.AbstractProjectionOpens in a new tab クラスから派生した) プロジェクション・クラスの名前を定義します。プロジェクション・クラスは、以下のいずれかが当てはまる場合に呼び出されるメソッドを実装します。
クラスには、任意の数のプロジェクション定義を指定できます。これらのすべてのアクションは、クラスがコンパイルされるときに呼び出されます (呼び出される順序は定義されていません)。
InterSystems IRIS には、Java や MV などからクラスにアクセスするためのクライアント・コードを生成する、事前定義されたプロジェクション・クラスが含まれています。
プロジェクション・クラス
また、独自のプロジェクション・クラスを生成し、組み込みのプロジェクション・クラスと同様に、スタジオで使用することもできます。
新規のプロジェクションをクラス定義に追加するには、以下の 2 つの方法があります。
クラス・エディタを使用してプロジェクションを追加するには、クラス・エディタの空の行にカーソルを置き、プロジェクション宣言を入力します。
また、既存のプロジェクション宣言をコピーして貼り付け、それを編集することもできます。
詳細は、"クラス定義リファレンス" の “プロジェクション定義” を参照してください。
新規プロジェクション・ウィザード
[クラス]→[追加]→[プロジェクション] を選択して、新規プロジェクション・ウィザードを起動できます。または、クラス・インスペクタで右クリックし、[追加]→[新規プロジェクション] を選択します。
[新規プロジェクション・ウィザード] では、複数のページが表示され、新規プロジェクションに関する情報の入力が促されます。すべてのウィザード・ページを完了する前に [完了] をクリックできます。この場合、指定していない情報には既定値が設定されます。
名前および説明ページ
新規プロジェクション・ウィザードで、以下の情報の入力が促されます (これらの値は後で変更できます)。
プロジェクション名
(必須) 新規プロジェクションの名前。これは、有効なプロジェクション名である必要があります。また、定義済みの既存のプロジェクションと同じ名前を付けることはできません。
"サーバ側プログラミングの入門ガイド" の付録 “識別子のルールとガイドライン” にあるセクション “クラス・メンバ” を参照してください。
説明
(オプション) 新規プロジェクションに関する説明。
プロジェクション・タイプ・ページ
プロジェクトのタイプでは、クラス定義がコンパイルまたは削除されたときのアクションを決定します。定義するプロジェクションの種類を選択できます。
プロジェクション・タイプ
プロジェクション・クラスの名前。このクラスのメソッドは、クラス定義がコンパイル、または削除されるときに実行されます。
プロジェクション・パラメータ
プロジェクション・クラスの動作を制御する名前と値の組み合わせです。利用できるパラメータ名のリストは、選択されたプロジェクション・クラスによって決定されます。
新規プロジェクション・ウィザード実行の結果
新規プロジェクション・ウィザードの実行後、クラス・エディタ・ウィンドウは更新され、新規のプロジェクション定義が表示されます。以下に例を示します。
/// This is a Person class
class MyApp.Person extends %Persistent
{
Property Name As %String;
Projection JavaClient As %Projection.Java;
}
このプロジェクション定義を編集するには、クラス・エディタまたはクラス・インスペクタを使用します。