| Oracle® Complex Event Processing開発者ガイド 11g リリース1 (11.1.1) for Eclipse B61654-01 |
|
 前 |
 次 |
Oracle CEPのイベント処理ネットワーク(EPN)は、Oracle CEPアプリケーションの中心的な概念で、アプリケーションのコンポーネントを連結するプライマリ・ポイントです。Oracle CEP IDE for Eclipseを使用すると、EPNのグラフィカル・ビューを提供し、視覚化とナビゲーションの機能を提供しOracle CEPアプリケーションを作成できるEPNエディタを使用できます。
この項では、次のようなエディタおよびエディタに表示される情報を使用する方法を説明します。
EPNエディタは、Oracle CEPアプリケーションのプロジェクト・フォルダ、コンテキストまたは構成ファイルから開くことができます。
Oracle CEPアプリケーションのEclipseプロジェクト・フォルダからEPNエディタを開くことができます。また、EPNエディタは、コンテキストまたは構成ファイルからも開くことができます(5.1.2項「コンテキストまたは構成ファイルからEPNエディタを開く方法」を参照)。
プロジェクトからEPNエディタを開くには:
EPNエディタは、Oracle CEPアプリケーションのSpringコンテキスト・ファイルまたはOracle CEPサーバー構成ファイルから開くことができます。また、コンテキストまたは構成ファイルからEPNエディタを開くこともできます(詳細は、5.1.1項「プロジェクト・フォルダからEPNエディタを開く方法」を参照)。
コンテキストまたは構成ファイルからEPNエディタを開くには:
この項では、EPNの表示を管理するために使用する主なコントロールおよびEPNエディタでのOracle CEPアプリケーションの情報の表示方法について説明します。次の項が含まれます。
図5-5に示すように、エディタのプライマリ表示ではアプリケーション内のフローが表示されます。
EPNは、リンクおよびストリームで接続されたノードで構成されます。アダプタ、プロセッサ、データベース表、Bean、およびキャッシュなど様々なタイプのノードがあります。EPNエディタによってノード、リンク、およびストリムで使用されるグラフィック表記法の詳細は、次の項を参照してください。
通常、EPNは1つのアセンブリ・ファイルに指定しますが、複数のアセンブリ・ファイルにもEPNを指定できます。
デフォルトでは、EPNエディタは単一Oracle CEPアプリケーション・バンドルのEPNとともにすべてのファイルから収集した情報を表示します。
単一アセンブリ・ファイルのネットワークを表示するには、図5-6に示すように、「フィルタ」プルダウン・メニューからそのファイルを選択します。
EPNを編集する場合、EPNエディタのフィルタに示されるアセンブリ・ファイルに新規ノードが追加されます。EPNエディタのフィルタが「EPN全体」に設定される場合、フィルタ・リストの最初のアセンブリ・ファイルに新規ノードが追加されます。既存のノードは、それが定義されているアセンブリ・ファイルで編集されるかまたは削除されます。
EPNエディタで編集するアセンブリ・ファイルがEclipseソース・エディタで開いている場合、その開いているファイルへの編集内容がエディタに編集されます。この場合は、ディスク上のファイルに変更が反映されるようにするには、開いているエディタの変更を保存する必要があります。
EPNエディタで編集するアセンブリ・ファイルがEclipseソース・エディタで開いていない場合は、編集内容がすぐにディスク上のファイルに反映されます。
詳細は、3.3項「EPNアセンブリ・ファイルの作成」を参照してください。
「ズーム」フィールドにパーセント値を入力するか、または図5-7に示すように「ズーム」フィールドのプルダウン・メニューから値を選択して、EPNエディタのズーム・レベルを変更できます。EPNを現在のEPNエディタ・ウィンドウに合せるには、「ウィンドウに合せる」を選択します。
図5-8に示すように、「EPNのレイアウト」をクリックしてEPNのレイアウトを最適化および単純化できます。
EPNにおいて参照のない<bean>要素をフィルタ処理で除外できます。図5-9に示すように、「接続されていないBeanの表示/非表示」をクリックして、そのBeanの可視性を切り替えることができます。詳細は、5.4.3項「ノードのレイアウト」を参照してください。
図5-10に示すように、「イメージとしてエクスポート」をクリックして、EPNエディタのビューをイメージ・ファイルにエクスポートできます。イメージを.bmp、.gif、.jpg、または.pngファイルとしてエクスポートできます。
図5-11に示すように、「印刷」をクリックしてEPNエディタのビューを印刷できます。
図5-12に示すように、META-INF/wlevsディレクトリの1つの構成ファイルに構成情報が格納されているノードの右下にそのことを示すインジケータ付きのバッジが付けられます。
このバッジがついたノードには、「構成のソースに移動」コンテキスト・メニュー項目もあります。
ストリームを使用している場合、アセンブリ・ファイルにリンクを次として指定できます:
ダウンストリーム・ノードのソース要素。
アップストリーム・ノードのリスナー要素。
線上の円は、アセンブリ・ファイルで特定のリンクが指定される場所を表します。
図5-13に示す例では、ダウンストリーム・ノードoutStream上にソース要素としてリンクが指定されているので、outStreamノードの横に円が表示されます。図5-14は、対応するアセンブリ・ファイルを示します。
図5-15に示す例では、リンクがアップストリーム・ノードalgoTradingProcessorでリスナー要素として指定されているので、円がalgoTradingProcessorノードの横に表示されます。図5-16は、対応するアセンブリ・ファイルを示します。
親ノード内に子ノードを定義している場合、その子ノードはネストされているノードと言われます。親ノードのみが子ノードをリスナーとして指定できます。ネストされる要素から参照をドラッグできますが、それらの要素へ参照をドラッグできません。詳細は、5.4.2項「ノードの接続」を参照してください。
図5-17に示したEPNを参照してください。例5-1には、このEPNのEPNアセンブリ・ソースを示します。HelloWorldBeanはhelloworldOutputChannel内にネストされているので、EPNダイアグラムではボックス内に表示されます。親ノードであるhelloworldOutputChannelのみがネストされているBeanをリスナーとして指定できます。
例5-1 ネストされるBeanを含むEPNのアセンブリ・ソース
<wlevs:adapter id="helloworldAdapter"
class="com.bea.wlevs.adapter.example.helloworld.HelloWorldAdapter" >
<wlevs:instance-property name="message" value="HelloWorld - the current time is:"/>
</wlevs:adapter>
<wlevs:channel id="helloworldInputChannel" event-type="HelloWorldEvent" >
<wlevs:listener ref="helloworldProcessor"/>
<wlevs:source ref="helloworldAdapter"/>
</wlevs:channel>
<wlevs:processor id="helloworldProcessor" />
<wlevs:channel id="helloworldOutputChannel" event-type="HelloWorldEvent" advertise="true">
<wlevs:listener>
<bean class="com.bea.wlevs.example.helloworld.HelloWorldBean"/>
</wlevs:listener>
<wlevs:source ref="helloworldProcessor"/>
</wlevs:channel>
または、図5-18に示すように、すべてのノードがネストされるようにこのEPNを定義できます。例5-2には、このEPNのEPNアセンブリ・ソースを示します。すべてのノードがネストされているので、EPNダイアグラムではすべてのノードがボックス内に表示されます。helloworldAdapterは、最外部の親ノードであり、EPNダイアグラムではボックス内に表示されません。
例5-2 すべてのノードがネストされたEPNのアセンブリ・ソース
<wlevs:adapter id="helloworldAdapter" class="com.bea.wlevs.adapter.example.helloworld.HelloWorldAdapter" >
<wlevs:instance-property name="message" value="HelloWorld - the current time is:"/>
<wlevs:listener>
<wlevs:channel id="helloworldInputChannel" event-type="HelloWorldEvent" >
<wlevs:listener>
<wlevs:processor id="helloworldProcessor">
<wlevs:listener>
<wlevs:channel id="helloworldOutputChannel" event-type="HelloWorldEvent">
<wlevs:listener>
<bean class="com.bea.wlevs.example.helloworld.HelloWorldBean"/>
</wlevs:listener>
</wlevs:channel>
</wlevs:listener>
</wlevs:processor>
</wlevs:listener>
</wlevs:channel>
</wlevs:listener>
</wlevs:adapter>
EPNエディタでは、プロジェクト全体が表示されるので、EPNエディタからOracle CEPアプリケーションを構成する様々なアーティファクトにナビゲートできます。Oracle CEP IDE for Eclipseでは、EPNエディタをナビゲートするのに役立つ次の機能が用意されています。
水平スクロール・バーおよび垂直スクロール・バーを使用しないでEPNキャンバスを移動するには、次のいずれかのオプションを使用できます。
キャンバス上にカーソルを置いて、マウスの中ボタンを押しながらマウスをドラッグします。
「Space」キーを押しながらキャンバスをクリックしてドラッグします。
「概要」ビューで、強調表示されるボックスをクリックしてドラッグします。
ノードに関連付けられた構成オブジェクトがある場合、その「ノード」ノードをダブルクリックすると、ノードの動作が定義されているコンポーネント構成ファイルが開きます。
または、「ノード」をダブルクリックすると、そのノードが定義されるEPNアセンブリ・ファイル(Springコンテキスト・ファイル)が開きます。
図5-19に示すように、関連付けられた構成オブジェクトがあるノードの上に構成バッジが表示されます。
詳細は、次を参照してください:
コンポーネント構成ファイル、EPNアセンブリ・ファイル、またはOracle CQL文を編集するときに、「Ctrl」キーを押してハイパーリンクを有効にします。ハイパーリンクを使用すると、アセンブリ・ファイルと構成ファイルの間を移動し、参照IDに従ってBeanの実装クラスに簡単に移動できます。
この項では次について説明します:
EPNエディタの各ノードには、ノード固有の機能に簡便にアクセスできるようにするコンテキスト・メニュー項目のグループがあります。「ノード」を右クリックして、そのコンテキスト・メニューを表示します。
ノード・タイプによっては、EPNエディタのコンテキスト・メニューを使用して次のオプションから選択できます。
「構成のソースに移動」: 対応するコンポーネント構成ファイルを開いて適切な要素にカーソルを置きます。ハイパーリンクを使用すると、このファイルから対応するEPNアセンブリ・ファイルに素早く移動できます。詳細は、5.3.3項「ハイパーリンク」を参照してください。
「アセンブリのソースに移動」: 対応するEPNアセンブリ・ファイルを開いて適切な要素にカーソルを置きます。ハイパーリンクを使用すると、このファイルから対応するコンポーネント構成ファイルに素早く移動できます。詳細は、5.3.3項「ハイパーリンク」を参照してください。
「Javaのソースに移動」: このコンポーネントに対応するJavaソース・ファイルを開きます。
「削除」: EPNアセンブリ・ファイルとコンポーネント構成ファイル(該当する場合)の両方からコンポーネントを削除します。
「名前の変更」: コンポーネントの名前を変更できるようにします。名前がEPNアセンブリ・ファイルとコンポーネント構成ファイル(該当する場合)の両方で更新されます。
「ヘルプ」: コンポーネントの文脈に応じたヘルプを表示します。
これらのナビゲーション・オプションは、対応するソース・アーティファクトが見つからない場合は無効になります。たとえば、構成XMLファイルに対応するエントリがないアダプタの場合は、そのアダプタのメニューの「構成のソースに移動」項目がグレー表示になります。
EPNエディタを使用すると、エディタの表面でアクションを使用してアプリケーションのEPNを作成および編集できます。EPNエディタで実行したほとんどのアクションによって、そのアプリケーションのアセンブリ・ファイルが編集されます。単一EPNアセンブリ・ファイルを使用するか、または複数のEPNアセンブリ・ファイルを使用できます(詳細は、5.2.2項「フィルタ処理」を参照)。
次の項では、EPNエディタの編集タスクについて説明します。次のタスクが含まれます。
詳細は、次を参照してください:
EPNエディタを使用してEPNに新しいノードを追加する場合、新規ノードは、EPNエディタでコンテキスト・メニューを表示するためにクリックした場所に表示されます。表5-1にリストされるノードのいずれかを作成できます。
表5-1 EPNエディタのアイコン
| ノード | 説明 |
|---|---|
 |
「アダプタ」: イベント・データ・ソースとEPNの間のインタフェースとなる、またイベント・データ・シンクとEPNの間のインタフェースとなるノード。 詳細は、次を参照してください: |
|
|
「Bean」: イベントを使用するPlain Old Java Object (POJO)ノードです。BeanはSpringフレームワークで管理されます。 詳細は、第13章「カスタム・アダプタ、イベントBeanおよびSpring Beanの構成」を参照してください。 |
|
|
「キャッシュ」: イベントを格納する一時記憶域を提供するノード。このノードは、Oracle CEPアプリケーションの全体的なパフォーマンスを改善することを目的として作成されます。 詳細は第11章「キャッシュの構成」を参照してください。 |
|
|
「チャネル」: イベント・データ・ソースとイベント・データ・シンクの間にイベントを伝達するノードです。 詳細は、第8章「チャネルの構成」を参照してください。 |
|
|
「イベントBean」: このノードは、Oracle CEP管理フレームワークで管理でき、Oracle CEPサーバー・コンテナの機能を使用できることを除き、標準Spring Beanと同じです。 詳細は、第13章「カスタム・アダプタ、イベントBeanおよびSpring Beanの構成」を参照してください。 |
|
|
「表」: リレーショナル・データベース表をイベント・データ・ソースとしてEPNに接続するノード。 詳細は、9.3項「Oracle CQLプロセッサ表ソースの構成」を参照してください。 |
|
|
「プロセッサ」: 1つ以上のチャネルによって提供されるイベント・データでOracle CQLルールまたはEPLルールを実行するノード。 詳細は、次を参照してください: |
ユーザーは、EPNエディタでノードを再配置できない場合があります。EPNエディタのノードのレイアウトをリフレッシュするには、EPNエディタ・ツールバーの「EPNのレイアウト」ボタンをクリックします。詳細は、5.4.3項「ノードのレイアウト」を参照してください。
子ノードが親ノード内にネストされている場合、そのアイコンがボックス内に表示されます。詳細は、5.2.9項「ネストされたステージ」を参照してください。
この項では次について説明します:
基本ノードには、アダプタ、Bean、キャッシュ、チャネル、イベントBean、および表が含まれます。プロセッサ・ノードの作成方法の詳細は、5.4.1.2項「プロセッサ・ノードの作成方法」を参照してください。
基本ノードを作成するには:
EPNエディタを開きます(5.1項「EPNエディタを開く」を参照)。
図5-22に示すように、EPNエディタの表面の空の部分を右クリックして、コンテキスト・メニューから「新規」を選択します。
作成するノードのタイプを選択します。
EPNエディタでは、EPNエディタのフィルタに示されるソース・ファイルを編集し、新規EPNノードを表示します。ほとんどのノードの場合は、図5-23に示すように、デフォルトのIDが使用され、名前を変更するように新規ノードがすぐに開かれます。
ノード名を変更するには、5.4.4項「ノード名の変更」を参照してください。
ノードを再配置して、EPNエディタのレイアウトを更新するには、5.4.3項「ノードのレイアウト」を参照してください。
オプションで、追加のノード・オプションを構成します。
参照:
この項では、EPNエディタを使用してプロセッサ・ノードを作成する方法について説明します。他のタイプのノードの作成の詳細は、5.4.1.1項「基本ノードの作成方法」を参照してください。
wlevs:processorノードを使用してOracle CEPアプリケーションをデプロイする場合、プロセッサ構成が存在する場合のみEPNの他のノードがそのプロセッサを参照できます。プロセッサ構成がOracle CEPアプリケーションの構成ファイルで定義されています。CEP構成ファイルの詳細は、1.1.5項「コンポーネント構成ファイル」を参照してください。
プロセッサ・ノードを作成するには:
EPNエディタを開きます(5.1項「EPNエディタを開く」を参照)。
図5-24に示すように、EPNエディタの表面の空の部分を右クリックして、コンテキスト・メニューから「新規」を選択します。
ノード・タイプとして「プロセッサ」を選択します。
図5-25に示すように、「新規プロセッサ」ダイアログが表示されます。
表5-2の説明に従って、「新規プロセッサ」ダイアログを構成します。
「OK」をクリックします。
EPNエディタでは、「新規プロセッサ」ダイアログで指定したファイルにプロセッサ構成を作成し、エディタのフィルタで示されているソース・ファイルを編集して、図5-26に示すように新規EPNノードを表示します。
ノード名を変更するには、5.4.4項「ノード名の変更」を参照してください。
ノードを再配置して、EPNエディタのレイアウトを更新するには、5.4.3項「ノードのレイアウト」を参照してください。
|
注意: Oracle CEPでは、プッシュ・イベント・ソースをOracle CQLプロセッサに接続して、Oracle CQLプロセッサをイベント・シンクに接続するためにチャネルを使用する必要があります。詳細は、8.1.2項「ストリームおよび関連を表すチャネル」を参照してください。 |
オプションで、追加のプロセッサ・オプションを構成します。
参照:
EPNのノードは、Oracle CEPアプリケーションのイベント処理ネットワークを介したイベントのフローを表します。ノードがEPNの他のノードにイベントを転送する可能性がある場合、EPNエディタではソース・ノードから宛先ノードへ線を引くことで、そのノードを視覚的に接続できます。
この項では、EPNエディタにおいてノードを接続する方法を説明します。
ノードを接続するには:
EPNエディタを開きます(5.1項「EPNエディタを開く」を参照)。
イベントのソースを選択して、イベント・フローのターゲットにドラッグします。
接続が許可されている場合、図5-27に示すように、ターゲットの最後にプラグ・アイコンが表示されます。
接続が許可されていない場合、図5-28に示すように、ターゲットの最後に禁止アイコンが表示されます。
すべてのノードがイベント・フローのターゲットになるとはかぎりません。たとえば、次の場合は接続が禁止されます:
ノードが有効な識別子を定義していません。
ノードがネストされています(詳細は、5.2.9項「ネストされたステージ」を参照)。
接続を完了するには、マウスのボタンを解放します。
接続の作成時には、EPNエディタによってEPNアセンブリ・ファイルが更新されます。例:
アダプタをチャネルに接続するか、またはチャネルをプロセッサやイベントBeanに接続する場合、EPNエディタでは、ターゲット・ノードのIDを参照してソース・ノードにwlevs:listener要素が追加されます。
表をプロセッサに接続する場合、EPNエディタでは、ソース表を参照するターゲット・プロセッサ・ノードにwlevs:table-source要素が追加されます。
たとえば、図5-29に示すように、アダプタをチャネルに接続して、チャネルをプロセッサに接続する場合を仮定します。
図5-30では、接続前のEPNアセンブリ・ファイルを示します。
図5-31では、接続後のEPNアセンブリ・ファイルを示します。
EPNエディタのいくつかのアクションでは、アクションの同じ場所に結果が表示されます。たとえば、EPNエディタを使用してEPNに新規ノードを追加する場合、新規ノードは、EPNエディタでコンテキスト・メニューを表示するためにクリックした場所に表示されます。ユーザーがEPNエディタでノードを再配置できない場合があります。EPNエディタで、ノードのレイアウトをリフレッシュするには、図5-32に示すように、EPNエディタ・ツールバーの「EPNのレイアウト」ボタンをクリックします。
詳細は、5.2.4項「レイアウト」を参照してください。
ほとんどのノード・タイプでは、名前の変更操作がサポートされます。この操作では、アセンブリと構成XMLファイルの両方においてノードへの参照がすべて変更されます。図5-33に示すように、ノードのコンテキスト・メニューから「名前の変更」を選択します。
ノードのコンテキスト・メニューを使用するか、または「削除」キーを使用して、EPNエディタに表示されるほとんどのノードと接続を削除できます。
キーボードを使用して削除するオブジェクトを選択して、「削除」キーを押します。
コンテキスト・メニューを使用する場合は、図5-34に示すように、オブジェクトを右クリックしてコンテキスト・メニューを表示してから「削除」を選択します。
ノードを削除すると、着信接続および送信接続も削除されます。たとえば、図5-35および図5-37は、それぞれstreamという名前のチャネル・ノードを削除する前のEPNおよびアセンブリ・ファイルを示します。
図5-37では、このチャネル・ノードの削除後のEPNを示し、図5-38では、チャネル・ノードの削除後のアセンブリ・ファイルを示します。
|
注意: beanまたは他の匿名要素を削除すると、そのオブジェクトを含むオブジェクトも削除されます。たとえば、beanがwlevs:listener要素内にある場合、beanを削除すると、listener要素も削除されます。 |
