この付録は、簡単なOracle CEPアプリケーションの作成、デプロイメントおよびデバッグに関する基本的な情報を提供する簡単なチュートリアルです。
本チュートリアルは、次のステップからなっています。
このチュートリアルは、ローカル・コンピュータにOracle CEPサーバーおよびOracle CEP IDE for Eclipseがインストールされていることを前提とします。詳細は、http://www.oracle.com/technologies/soa/complex-event-processing.html
を参照してください。
はじめに、JavaまたはJava EE Perspectiveに切り替えることをお薦めします。CEPアプリケーションの開発にOracle CEP IDE for Eclipseを使用する場合、JavaとJava EE Perspectiveの両方が役立ちます。Oracle CEPアプリケーションはJava EEのアプリケーションではありませんが、両方に共通するビューがあり、便利です。
パースペクティブを変更するには、「ウィンドウ」>パースペクティブを開くメニューを選択するか、パースペクティブのショートカット・メニューを利用します。図H-1を参照してください。
Java Perspectiveを使用している場合、「ウィンドウ」>「ビューの表示」>「サーバー」を選択して、「サーバー」ビューを開きます。
Oracle CEP IDE for Eclipseが図H-2のようになっていることを確認します。
最初に、ローカル・マシンにOracle CEPサーバーをインストールしている場所をOracle CEP IDE for Eclipseに示します。4.2.1項「ローカルOracle CEPサーバーおよびサーバー・ランタイムの作成方法」の次のステップに従います。
このチュートリアルについては、ウィザードの2番目の画面で「ワークスペースのデフォルトを使用」の「自動パブリッシュ」オプションを選択し、サーバーへの自動パブリッシュを有効にします。図H-3を参照してください。
構成完了後に、サーバーのビューが図H-4のようになっていることを確認します。
次に、Oracle CEPアプリケーションを作成します。ステップの説明は、4.2.1項「ローカルOracle CEPサーバーおよびサーバー・ランタイムの作成方法」を参照してください。
このチュートリアルでは、「ファイル」>「新規」>「その他」と選択し、「Oracle CEP」オプションを展開して、「Oracle CEPアプリケーション・プロジェクト」を選択します。
「新規Oracle CEPアプリケーション・プロジェクト」ダイアログで、「プロジェクト名」にHello
を入力し、「ターゲット・ランタイム」でOracle CEP v10.3.0
(付録H「ステップ1: Oracle CEP定義の作成」で作成済)を選択します。図H-9を参照してください。
「次へ」をクリックします。「バンドル・プロパティ」はデフォルトのままにし、「次へ」をクリックします。図H-6のような「テンプレート」のダイアログが表示されます。
このページでは、プロジェクトに配置するアプリケーションの初期ファイルを選択することができます。次のテンプレートの中の1つを使用してOracle CEPアプリケーションを作成を選択し、「Hello World」テンプレートを選択します。
「終了」をクリックします。
「プロジェクト・エクスプローラ」に図H-7に示すファイルが表示されていることを確認します。
プロジェクトが作成され、サンプル・コンテンツもあり、サーバーを起動し、プロジェクトをデプロイします。
図H-8に示すように、サーバー・ビューの「デバッグ」ボタンをクリックしてサーバーを起動します。デバッグのアイコンは「ビュー」上にバグのような表示になっています。
コンソール・ビューで、Oracle CEPサーバーのログ・メッセージがスクロール表示され、最後に、次に示すように、サーバーが起動されたことを示すメッセージが表示されます。
<Jan 22, 2009 4:59:41 PM EST> <Notice> <Server> <BEA-2046000> <Server STARTED>
次に、プロジェクトをサーバーにデプロイします。「サーバー」ビューで、該当するサーバーを右クリックし、プロジェクトの追加/削除を選択します。図H-9に示すようなプロジェクトの追加と削除ダイアログが表示されます。
右ペインに表示される「使用可能なプロジェクト」のリストからHelloプロジェクトを選択し、「追加」をクリックして右側の構成済プロジェクトのリストにプロジェクトを追加します。
「終了」をクリックします。Oracle CEP IDE for Eclipseはプロジェクトをサーバーにデプロイします。
次のように、コンソール・ビューで、Oracle CEPサーバーはアプリケーションがデプロイされていることを示します:
<Jan 23, 2009 9:24:13 AM EST> <Notice> <Spring> <BEA-2047000> <The application context for "com.bea.wlevs.monitor" was deployed successfully> <Jan 23, 2009 9:24:17 AM EST> <Notice> <Spring> <BEA-2047000> <The application context for "com.bea.wlevs.dataservices" was deployed successfully> <Jan 23, 2009 9:26:06 AM EST> <Notice> <Server> <BEA-2045000> <The application bundle "Hello" was deployed successfully to file:/C:/OracleCEP/user_projects/domains/ocep_domain/defaultserver/applications/Hello/Hello.jar with version 1232720766696> <Jan 23, 2009 9:26:06 AM EST> <Notice> <Server> <BEA-2045000> <The application bundle "Hello" was deployed successfully to file [C:\OracleCEP\user_projects\domains\ocep_domain\defaultserver\applications\Hello\Hello.jar] with version 1232720766696> <Jan 23, 2009 9:26:22 AM EST> <Notice> <Spring> <BEA-2047000> <The application context for "Hello" was deployed successfully>
これでアプリケーションがデプロイされ、起動しました。コンソール・ビューにアプリケーションからのメッセージが表示されていることを確認します。
Message: HelloWorld - the current time is:9:26:22 AM Message: HelloWorld - the current time is:9:26:23 AM Message: HelloWorld - the current time is:9:26:23 AM ...
次に、コードの一部を変更し、反復開発サイクルを実演するためにプロジェクトを再デプロイします。
EPNを開きます(5.1項「EPNエディタを開く」を参照)。
EPNエディタで、helloworldAdapterを右クリックし、「Javaのソースに移動」を選択します。図H-10を参照してください。
図H-11に示すようなJavaエディタが開きます。
Javaエディタを使用して、イベントが3秒ごとに起動するようにSLEEP_MILLIS
フィールドの値を3000
に変更します。「File」>「Save」と選択します。
デフォルトでは、プロジェクトは自動的に再デプロイされるようになっているため、これ以上の処理は必要ありません。次に示すように、数秒後にOracle CEP IDE for Eclipseはプロジェクトを再デプロイし、コンソールでのHelloWorldメッセージの表示率が3秒ごとにまで下がります。
Message: HelloWorld - the current time is:9:37:41 AM Message: HelloWorld - the current time is:9:37:41 AM Message: HelloWorld - the current time is:9:37:41 AM <Jan 23, 2009 9:37:42 AM EST> <Notice> <Spring> <BEA-2047001> <The application context "Hello" was undeployed successfully> <Jan 23, 2009 9:37:42 AM EST> <Notice> <Server> <BEA-2045000> <The application bundle "Hello" was deployed successfully to file:/C:/OracleCEP/user_projects/domains/ocep_domain/defaultserver/applications/Hello/Hello.jar with version 1232721461898> <Jan 23, 2009 9:37:43 AM EST> <Notice> <Spring> <BEA-2047000> <The application context for "Hello" was deployed successfully> Message: HelloWorld - the current time is:9:37:43 AM Message: HelloWorld - the current time is:9:37:46 AM
「自動パブリッシュ」が無効になっている場合、プロジェクトを再パブリッシュするには、「サーバー」ビューで「サーバー」を右クリックし、「パブリッシュ」を選択します。図H-12を参照してください。
次に、アプリケーションは稼働しているため、コードの一部をデバッグします。
EPNを開きます。(5.1項「EPNエディタを開く」を参照)
EPNエディタで、HelloWorldBeanを右クリックし、「Javaのソースに移動」を選択します。図H-13を参照してください。
行10の左余白(行番号の左)を右クリックし、ブレークポイントの切替えを選択します。
StreamSink
が次回メッセージを受信すると、ブレークポイントを設定した行10で止まり、デバッグ・ビューが表示されます。図H-14を参照してください。
「変数」ビューで、event
変数を展開し、その属性の値を確認できます。
Oracle CEPサーバーのインストーラにあるOracle CEPのサンプルを確認します。
詳細は、『Oracle CEPスタート・ガイド』のOracle CEPのサンプルに関する項を参照してください。