イベントのトリガと処理 

ABAP オブジェクトにおけるイベントのトリガと処理では、特定のメソッドがトリガとしてイベントをトリガし、そのイベントに他のメソッドつまり ハンドラが対応します。つまり、イベントが発生するとハンドラメソッドが実行されます。

このセクションでは、ABAP オブジェクトでイベントを処理する方法について説明します。関連する ABAP 命令の詳細については、ABAP エディタで対応するキーワード文書を参照してください。

イベントのトリガ

イベントをトリガするには、クラスで以下の操作が必要となります。

ｷ        その宣言部分でイベントを宣言する

ｷ        そのメソッドの 1 つでイベントをトリガする

イベントの宣言

イベントは、クラスの宣言部分またはインタフェースで宣言します。インスタンスイベントを宣言するには、以下の命令を使用します。

EVENTS <evt> EXPORTING...VALUE(<e_i>) TYPE type [OPTIONAL]..

静的イベントを宣言するには、以下の命令を使用します。

CLASS-EVENTS <evt>...

どちらの命令も構文は同じです。

イベントを宣言する際に、EXPORTING オプションを使用してイベントハンドラに渡されるパラメータを指定することができます。パラメータは常に値によって渡されます。インスタンスイベントには、必ず暗黙的なパラメータ SENDER が含まれています。このパラメータには、イベントが宣言されている型またはインタフェースへの参照の型が設定されています。

イベントのトリガ

クラス内のインスタンスイベントは、クラスの任意のメソッドでトリガすることができます。静的イベントは、任意の静的メソッドによってトリガすることができます。メソッド内でイベントをトリガするには、以下の命令を使用します。

RAISE EVENT <evt> EXPORTING...<e_i> = <f_i>...

オプションとして定義されていない各仮パラメータ <e _i> に対し、EXPORTING オプションで対応する実パラメータ <f _i> を渡す必要があります。自己参照 ME は、自動的に暗黙的なパラメータ SENDER に渡されます。

イベントの処理

イベントは、特別なメソッドを使って処理されます。イベントを処理するには、メソッドに対して以下の操作が必要となります。

ｷ        そのイベントのイベントハンドラメソッドとして定義する

ｷ        実行時にイベントに対して登録する

イベントハンドラメソッドの宣言

どのクラスにも、他のクラスのイベントに対するイベントハンドラメソッドを含めることができます。もちろん、イベント自体と同じクラスでイベントハンドラメソッドを定義することもできます。イベントハンドラメソッドを宣言するには、インスタンスメソッドに対して以下の命令を使用します。
METHODS <meth> FOR EVENT <evt> OF <cif> IMPORTING.. <e_i>..

静的メソッドの場合は、METHODS の代わりにCLASS_METHODS を使用します。<evt> は、クラスまたはインタフェース <cif> で宣言されているイベントです。

イベントハンドラメソッドのインタフェースには、イベント <evt> の宣言で定義された仮パラメータのみを含めることができます。パラメータの属性も、イベントによって採用されます。イベントハンドラメソッドでは、RAISE EVENT 命令で渡されるすべてのパラメータを使用する必要はありません。暗黙的なパラメータ SENDER も使用する場合は、このパラメータをインタフェースに列挙する必要があります。このパラメータによって、インスタンスイベントハンドラがトリガにアクセスできるようになるため、結果を返したりすることができます。

クラスでイベントハンドラメソッドを宣言すると、原則としてクラスのインスタンスまたはクラス自体が、メソッドでトリガされたイベント<evt> を処理できるようになります。 

イベントハンドラメソッドの登録

イベントハンドラメソッドがイベントに反応できるようにするには、反応するトリガを実行時に特定する必要があります。そのためには、以下の命令を使用します。

SET HANDLER...<h_i>...[FOR]...

これによって、ハンドラメソッドの一覧が、対応するトリガメソッドにリンクされます。イベントには次に示す 4 つのタイプがあります。

ｷ        クラスで宣言されるインスタンスイベント

ｷ        インタフェースで宣言されるインスタンスイベント

ｷ        クラスで宣言される静的イベント

ｷ        インタフェースで宣言される静的イベント

SET HANDLER の構文と効果は、イベントが上の 4 つのどれであるかによって異なります。 

インスタンスイベントの場合は、FOR オプションを使用してハンドラの登録対象となるインスタンスを指定する必要があります。単一のインスタンスをトリガとして指定するには、次のように参照変数<ref> を使用します。

SET HANDLER...<h_i>...FOR <ref>.

あるいは、イベントをトリガできるすべてのインスタンスに対してハンドラを登録することができます。

SET HANDLER...<h_i>...FOR ALL INSTANCES.

この登録は、ハンドラ登録時にはまだ登録されていなかったトリガ元のインスタンスにも適用されます。

静的イベントには FOR オプションを使用できません。

SET HANDLER...<h_i>...

登録は、クラス全体あるいはこの静的イベントを含んでいるインタフェースを実装するすべてのクラスに自動的に適用されます。インタフェースの場合は、ハンドラが登録されるまでロードされていなかったクラスにも登録が適用されます。

イベント処理のタイミング

RAISE EVENT 命令が実行されてから次の命令が処理されるまでの間に、登録されたすべてのハンドラメソッドが実行されます ( 同期イベント処理) 。ハンドラメソッド自体がイベントをトリガする場合は、そのハンドラメソッドが実行されてから、元のハンドラメソッドが続行されます。無限の繰返しを防ぐために、現在、イベントのネスティングレベルは 64 に制限されています。

ハンドラメソッドは、登録された順番に実行されます。イベントハンドラは動的に登録されるため、決まった順序で処理されるわけではありません。すべてのイベントハンドラが同時に実行されるものとしてプログラミングを行ってください。

 

参照:

概要図

イベント: 初歩的な例

イベント: 高度な例