クラス・プロジェクションの定義

概要

クラス・プロジェクションは、クラスをコンパイルまたは削除したときの動作をカスタマイズする手段を提供します。クラス・プロジェクションは、クラス定義をプロジェクション・クラスと関連させます。プロジェクション・クラス (%Projection.AbstractProjectionOpens in a new tab クラスから派生) は、Caché が自動的に追加のコードを生成するために、次の 2 つの時点で使用するメソッドを提供します。

• クラスがコンパイルされるとき

• クラスが削除されるとき

このメカニズムは、Java プロジェクションや C++ プロジェクション (プロジェクションの語源) によって、クラスがコンパイルされるときは常に、必要なクライアント・バインディング・コードを自動的に生成するために使用されます。

クラスにプロジェクションを追加する

クラス定義にプロジェクションを追加するには、クラス定義内の Projection 文を使用します。

class MyApp.Person extends %Persistent
{
Projection JavaClient As %Projection.Java(ROOTDIR="c:\java");
}

この例では、%Projection.JavaOpens in a new tab プロジェクション・クラスを使用する JavaClient というプロジェクションを定義しています。プロジェクション・クラスのメソッドが呼び出されるとき、そのメソッドは ROOTDIR パラメータの値を受け取ります。

クラスには、一意に名付けられた複数のプロジェクションを含めることができます。複数のプロジェクションの場合、各プロジェクション・クラスのメソッドは、クラスがコンパイルされるとき、または削除されるときに呼び出されます。複数のプロジェクションが処理される順序は、未定義です。

Caché には、以下のプロジェクション・クラスが用意されています。

また、独自のプロジェクション・クラスを生成し、組み込みのプロジェクション・クラスと同様に使用することもできます。

新規プロジェクション・クラスの作成

新規のプロジェクション・クラスを作成するには、%Projection.AbstractProjectionOpens in a new tab クラスのサブクラスを作成し、プロジェクション・インタフェース・メソッドを実装して (サブセクションを参照)、必要なクラス・パラメータを定義します。例えば、以下のようになります。

Class MyApp.MyProjection Extends %Projection.AbstractProjection
{

Parameter MYPARAM;

/// This method is invoked when a class is compiled
ClassMethod CreateProjection(cls As %String, ByRef params) As %Status
{
    // code here...
    QUIT $$$OK 
}

/// This method is invoked when a class is 'uncompiled'
ClassMethod RemoveProjection(cls As %String, ByRef params, recompile as %Boolean) As %Status
{
    // code here...
    QUIT $$$OK 
  }
}