This document is a resource for software developers who develop event driven real-time applications. It also contains information that is useful for business analysts and system architects who are evaluating Oracle Complex Event Processing (or Oracle CEP for short )or considering the use of Oracle CEP for a particular application.
The topics in this document are relevant during the design, development, configuration, deployment, and performance tuning phases of event driven applications. The document also includes topics that are useful in solving application problems that are discovered during test and pre-production phases of a project.
It is assumed that the reader is familiar with the Java programming language and Spring.
Oracle CEP Documentation Set
This document is part of a larger Oracle CEP documentation set that covers a comprehensive list of topics. The full documentation set includes the following documents:
Metadata Annotations, provides reference information for the metadata annotations you can use in your adapter Java file to access its configuration.
XSD Schema Reference for Oracle CEP Files, provides the XSD Schemas for the various Oracle CEP XML files, including component configuration files, EPN assembly file, deployments file, and server configuration file.
Samples for the Oracle CEP Application Developer
In addition to this document, Oracle provides a variety of code samples for Oracle CEP application developers. The examples illustrate Oracle CEP in action, and provide practical instructions on how to perform key development tasks.
Oracle recommends that you run some or all of the examples before programming and configuring your own event driven application.
When you initially install Oracle CEP, you must chose the Custom option to also install the examples. The Typical option does not include the examples.
If you previously installed Oracle CEP using the Typical option, and you now want to also install the examples, re-run the Oracle CEP installation process and specify the same Oracle CEP home directory; a later step in the installation process allows you to then install just the examples.
The examples are distributed in two ways:
Pre-packaged and compiled in their own domain so you can immediately run them after you install the product.
Separately in a Java source directory so you can see a typical development environment setup.
The following four examples are provided in both their own domain and as Java source in this release of Oracle CEP:
HelloWorld—Example that shows the basic elements of an Oracle CEP application. See Hello World Example for additional information.
The HelloWorld domain is located in ORACLE_CEP_HOME\ocep_10.3\samples\domains\helloworld_domain, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory, such as c:\oracle_cep.
The HelloWorld Java source code and configuration files are located in ORACLE_CEP_HOME\ocep_10.3\samples\source\applications\helloworld.
ForeignExchange (FX)—Example that includes multiple adapters, streams, and complex event processor with a variety of EPL rules, all packaged in the same Oracle CEP application. See Foreign Exchange (FX) Example for additional information.
The ForeignExchange domain is located in ORACLE_CEP_HOME\ocep_10.3\samples\domains\fx_domain, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory, such as c:\oracle_cep.
The ForeignExchange Java source code and configuration files are located in ORACLE_CEP_HOME\ocep_10.3\samples\source\applications\fx.
Signal Generation—Example that receives simulated market data and verifies if the price of a security has fluctuated more than two percent, and then detects if there is a trend occurring by keeping track of successive stock prices for a particular symbol.See Signal Generation Example for additional information.
The Signal Generation domain is located in ORACLE_CEP_HOME\ocep_10.3\samples\domains\signalgeneration_domain, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory, such as c:\oracle_cep.
The Signal Generation Java source code and configuration files are located in ORACLE_CEP_HOME\ocep_10.3\samples\source\applications\signalgeneration.
Record and Playback—Example that shows how to configure the recording and playback of events to a persistent event store, as well as how to use the built-in HTTP pub-sub adapter to publish messages to a channel. See Event Record and Playback Example for additional information.
The Record and Playback domain is located in ORACLE_CEP_HOME\ocep_10.3\samples\domains\recplay_domain, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory, such as c:\oracle_cep.
The Record and Playback Java source code and configuration files are located in ORACLE_CEP_HOME\ocep_10.3\samples\source\applications\recplay.