WAMフィルターおよびコマンド・ハンドラーの構造

すべてのWAMフィルターおよびコマンド・ハンドラーは#PRIM_WAMというベース・クラスを拡張(つまり、継承)します。ベース・クラスは一組の定義済みの動作をWAMに提供します。

Webページとして送信するものを定義するWebマップが常に存在します。この例では、プッシュ・ボタン#UB_SAVEおよび#UB_SEARCHが送信されます。

定義されるWEBROUTINEは必ず1つだけであり、ここでは2つの重要なことを行います：

・フィルターやコマンド・ハンドラーが扱えるすべてのイベントを登録し、イベント処理ルーチンに関連付けます。この例では、#UB_SAVEおよび#UB_SEARCHボタンのクリック・イベントを登録し、イベント・ルーチンに関連付けます(青および茶の矢印は関連を表す)。

・フレームワークマネージャに、フレームワークが初期化および実行できることを示します。

uHandleEventルーチンに追加する必要があるコードは、avRegisterEventメソッド呼び出しだけです。その他すべてのロジックは、uInitialize、uExecute、uTerminateまたはuWAMEvent_Nイベント処理ルーチンに適宜追加します。

フィルターやコマンド・ハンドラーはオプションuInitialize、uTerminate、uExecuteイベント・ハンドラーを持つことができます。WAMルーチンは実行のたびに作成、破棄されるため、WAMが呼び出されるたびにuInitializeおよびuTerminateルーチンが実行されます。したがって、WAMとクライアントの各対話処理の開始または終了時に実行するコードを入れておくだけで済みます。

uExecuteは、WAMの実行時(つまり、フィルターの開始時またはコマンド・ハンドラーの実行時)にのみ実行されます。アクティブなWAM(例えば、ボタンのクリック)の内部でイベントが発生すると、uExecuteのシグナルは通知されず、登録済みのuWAMEvent_Nイベントのシグナルのみが通知されます。

ほとんどのフィルターやコマンド・ハンドラーは固有のイベント処理ルーチンを持っています。ここで使われているサンプルWAMはイベント(UB_SAVE.ClickおよびUB_SEARCH.Click)を登録するので、それぞれのクリック・イベントを処理するために2つのイベント・ルーチンを定義しています。