J Oracle CEP IDE for Eclipse Tutorial
This appendix provides a simple tutorial that illustrates the basics of creating, deploying, and debugging a simple Oracle CEP application.
This tutorial includes the following steps:
J.1 Before You Begin
This tutorial assumes that you have installed an Oracle CEP server and Oracle CEP IDE for Eclipse on the local computer. For more information, see: http://www.oracle.com/technologies/soa/complex-event-processing.html.
Before beginning this tutorial it is a good idea to switch to the Java or the Java EE perspective: both of which are good starting points for using Oracle CEP IDE for Eclipse to develop Oracle CEP applications. Although Oracle CEP applications are not Java EE applications, many of the same views are useful between the two.
To change the perspective, select Window > Open Perspective menu, or use the perspective shortcut menu as shown in Figure J-1.
If you are in the Java perspective, you will want to open the Servers view by selecting Window > Show View > Servers.
Your Oracle CEP IDE for Eclipse should look like Figure J-2.
J.2 Step 1: Create an Oracle CEP Definition
The first step is to tell the Oracle CEP IDE for Eclipse where your Oracle CEP server is installed on the local machine. To do this, follow the steps in the Section 5.2.1, "How to Create a Local Oracle CEP Server and Server Runtime".
For this tutorial, enable automatic publishing on the server by selecting Use Workspace Default for the Automatic Publishing options on the second wizard page as Figure J-3 shows.
Figure J-3 Configuring the Oracle CEP Server for Automatic Publishing
Description of "Figure J-3 Configuring the Oracle CEP Server for Automatic Publishing"
When finished, your Servers view should look as Figure J-4 shows.
Figure J-4 Oracle CEP IDE for Eclipse Server View
Description of "Figure J-4 Oracle CEP IDE for Eclipse Server View"
J.3 Step 2: Create an Oracle CEP Application
Next, create an Oracle CEP application. The basic the steps are described in Section 5.2.1, "How to Create a Local Oracle CEP Server and Server Runtime".
In this tutorial, select the File > New > Other, expand the Oracle CEP option and select Oracle CEP Application Project.
In the New Oracle CEP Application Project dialog, enter a project name of Hello and select the Oracle CEP v10.3.0 the Target Runtime (created in Appendix J, "Step 1: Create an Oracle CEP Definition") as Figure J-9 shows.
Figure J-5 New Oracle CEP Application Project Dialog
Description of "Figure J-5 New Oracle CEP Application Project Dialog"
Click Next. Leave the Bundle Properties at their defaults and click Next again. The Templates dialog appears as Figure J-6 shows.
This page allows you to select what initial application files should be placed in the project. Check Create an Oracle CEP Application using one of these templates and select the Hello World template.
Click Finish.
The Project Explorer should contain the files shown in Figure J-7.
J.4 Step 3: Start the Oracle CEP Server and Deploy the Project
Now that the project is created and includes example content, it's time to start the server and deploy the project.
To start the server, click the Debug button on the Servers view as shown in Figure J-8. The debug icon looks like a bug on the view toolbar.
Figure J-8 Starting the Oracle CEP Server
Description of "Figure J-8 Starting the Oracle CEP Server"
In the Console view, some Oracle CEP server log messages will scroll by, followed by the server indicating that it has started, such as:
<Jan 22, 2009 4:59:41 PM EST> <Notice> <Server> <BEA-2046000> <Server STARTED>
Next, deploy the project to the server. In the Servers view, right-click the server and select Add/Remove Projects. The Add and Remove Projects dialog appears as shown in Figure J-9.
Figure J-9 Add and Remove Projects Dialog
Description of "Figure J-9 Add and Remove Projects Dialog"
Select the Hello project from the Available projects list on the left and click Add to move the project to the Configured projects list on the right.
Click Finish. The Oracle CEP IDE for Eclipse deploys the project to the server.
In the Console view, the Oracle CEP server indicates that the application is deployed, such as (lines are broken for readability):
<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>
Because the application is now deployed and running, you should see messages from your application being logged to the Console view
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 ...
J.5 Step 4: Change Code and Redeploy
Next, we will change some code and redeploy the project to demonstrate the iterative development cycle.
Open the EPN (see Section 6.1, "Opening the EPN Editor").
In the EPN Editor, right click on helloworldAdapter and select Go to Java Source as shown in Figure J-10.
Figure J-10 Editing Java Source for an Adapter
Description of "Figure J-10 Editing Java Source for an Adapter"
The Java editor opens as Figure J-11 shows.
Figure J-11 Java Editor for helloworldAdapter
Description of "Figure J-11 Java Editor for helloworldAdapter"
Using the Java editor, change the value of the SLEEP_MILLIS field to 3000 so that events only fire every 3 seconds. Select File > Save.
Because the default setting is to automatically redeploy projects, no further action is required. Oracle CEP IDE for Eclipse will redeploy the project after a few seconds and the rate of HelloWorld messages in the Console view will slow down to every 3 seconds as shown below (lines are broken for readability).
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
If automatic publishing is disabled, to republish the project, right-click on the server in the Servers view and select Publish as Figure J-12 shows.
Figure J-12 Manually Publishing a Project
Description of "Figure J-12 Manually Publishing a Project"
J.6 Step 5: Debug the Deployed Application
Next, we will debug some code now that the application is up and running.
Open the EPN (see Section 6.1, "Opening the EPN Editor").
In the EPN Editor, right click on HelloWorldBean and select Go to Java Source as shown in Figure J-13.
Figure J-13 Java Editor for HelloWorldBean
Description of "Figure J-13 Java Editor for HelloWorldBean"
Right-click in the gutter on line 10 (to the left of the line number), and select Toggle Breakpoint.
The next time this StreamSink receives a message, it will stop at line 10 where the breakpoint was set and enter the Debug view as Figure J-14 shows.
Figure J-14 HelloWorldBean in the Debugger
Description of "Figure J-14 HelloWorldBean in the Debugger"
In the Variables view, you can expand the event variable and view the values of its attributes.
J.7 Next Steps
Examine the Oracle CEP examples available in the Oracle CEP server installer.
For more information, see "Oracle CEP Samples" in the Oracle Complex Event Processing Getting Started