2 Overview of the Oracle CEP IDE for Eclipse

Oracle CEP IDE for Eclipse is an IDE targeted specifically to programmers that want to develop Oracle CEP applications.

This chapter describes:

2.1 Overview of Oracle CEP IDE for Eclipse

Oracle CEP IDE for Eclipse is a set of plugins for the Eclipse IDE designed to help develop, deploy, and debug applications for Oracle CEP.

The key features of the Oracle CEP IDE for Eclipse are as follows:

  • Project creation wizards and templates to quickly get started building event driven applications.

  • Advanced editors for source files including Java and XML files common to Oracle CEP applications.

  • Integrated server management to seamlessly start, stop, and deploy to Oracle CEP server instances all from within the IDE.

  • Integrated debugging.

  • Event Processing Network (EPN) visual design views for orienting and navigating in event processing applications and visually creating and editing EPN components.

  • Oracle CEP application source file validation including Oracle Continuous Query Language (Oracle CQL) syntax highlighting and component configuration and assembly files.

  • Ability to build and export deployable Oracle CEP applications.

  • Integrated support for the Oracle CEP Visualizer so you can use the Oracle CEP Visualizer from within the IDE.

In Release 11gR1 (11.1.1), Oracle CEP IDE for Eclipse requires JDK 6.0. For more information, see:

For more information about Oracle CEP IDE for Eclipse, see http://www.oracle.com/technology/products/event-driven-architecture/cep-ide/11/.

2.2 Installing the Latest Oracle CEP IDE for Eclipse

New versions of the IDE will be made available via the Oracle Technology Network Web site. Oracle recommends that you install the IDE from this Eclipse update site.

To install the latest Oracle CEP IDE for Eclipse:

  1. Obtain the required versions of Eclipse (3.3.2) and WTP (2.0). We recommend you take the entire Europa installation available at the following Web sites:

    Windows: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-win32.zip

    Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-linux-gtk.tar.gz

    Note:

    Check the Oracle CEP Web site (http://www.oracle.com/technologies/soa/complex-event-processing.html) for the latest requirements on the Eclipse tools.
  2. Open your Eclipse IDE and select the menu item Help > Software Updates > Find and Install.

    The Install/Update dialog appears as Figure 2-1 shows.

    Figure 2-1 Install/Update Dialog

    Description of Figure 2-1 follows
    Description of "Figure 2-1 Install/Update Dialog"

  3. Select the Search for New Features option.

  4. Click Next.

    The Update Sites to Visit dialog appears as Figure 2-2 shows.

    Figure 2-2 Update Sites to Visit Dialog

    Description of Figure 2-2 follows
    Description of "Figure 2-2 Update Sites to Visit Dialog"

  5. Click New Remote Site.

    The New Update Site dialog appears as Figure 2-3 shows.

    Figure 2-3 New Update Site Dialog

    Description of Figure 2-3 follows
    Description of "Figure 2-3 New Update Site Dialog"

  6. Configure this dialog as Table 2-1 describes.

    Table 2-1 New Update Site Dialog Attributes

    Attribute Description

    Name

    The name for this remote update site. For example: Oracle CEP Tools Update.

    URL

    The URL to the remote update site. Valid value:

    http://download.oracle.com/technology/software/cep-ide/11/
    

  7. Click OK.

  8. Complete the Update Manager, selecting to install the Oracle CEP tools.

  9. When prompted restart, Eclipse. If you skip this, unreliable behavior can occur.

  10. To confirm the installation, select Help > About Eclipse Platform.

    The About Eclipse Platform dialog appears as Figure 2-4 shows.

    Figure 2-4 About Eclipse Platform

    Description of Figure 2-4 follows
    Description of "Figure 2-4 About Eclipse Platform"

  11. Click Plug-In Details.

    The About Eclipse Platform Plug-ins dialog appears as Figure 2-5 shows.

    Figure 2-5 About Eclipse Platform Plug-ins Dialog

    Description of Figure 2-5 follows
    Description of "Figure 2-5 About Eclipse Platform Plug-ins Dialog"

  12. Scroll down in the list and confirm that the plug-ins that Table 2-2 lists are shown.

    Table 2-2 Oracle CEP IDE for Eclipse Plug-Ins

    Provider Plug-in Name Plug-in Id

    Oracle

    Oracle CEP Tools Core

    com.bea.wlevs.eclipse.tools.core

    Oracle

    Oracle CEP Tools UI

    com.bea.wlevs.eclipse.tools.ui

    Oracle

    Oracle CEP Tools Documentation

    com.bea.wlevs.eclipse.tools.doc


  13. After installing Oracle CEP IDE for Eclipse, consider the following configuration topics:

2.3 Installing the Oracle CEP IDE for Eclipse Distributed With Oracle CEP

A version of the Oracle CEP IDE for Eclipse is shipped with the Oracle CEP product, although this version might be older than the one on the Oracle Technology Network site.

To install the Oracle CEP IDE for Eclipse distributed with Oracle CEP:

  1. Obtain the required versions of Eclipse (3.3.2) and WTP (2.0). We recommend you take the entire Europa installation available at the following Web sites:

    Windows: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-win32.zip

    Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-linux-gtk.tar.gz

  2. Open your Eclipse IDE and select the menu item Help > Software Updates > Find and Install.

    The Install/Update dialog appears as Figure 2-1 shows.

    Figure 2-6 Install/Update Dialog

    Description of Figure 2-6 follows
    Description of "Figure 2-6 Install/Update Dialog"

  3. Select the Search for New Features option.

  4. Click Next.

    The Update Sites to Visit dialog appears as Figure 2-2 shows.

    Figure 2-7 Update Sites to Visit Dialog

    Description of Figure 2-7 follows
    Description of "Figure 2-7 Update Sites to Visit Dialog"

  5. Click New Archived Site.

    The Select Local Site Archive dialog appears as Figure 2-8 shows.

    Figure 2-8 Select Local Site Archive Dialog

    Description of Figure 2-8 follows
    Description of "Figure 2-8 Select Local Site Archive Dialog"

  6. Navigate to the ORACLE_CEP_HOME/ocep_11.1/eclipse-update-site directory and select the cep-tools-11.1.0.DATE-BUILD.zip file.

    Where ORACLE_CEP_HOME refers to the main directory into which you installed Oracle CEP, such as /oracle_cep, and DATE is the build date and BUILD is the build number.

  7. Click Open.

  8. Complete the Update Manager, selecting to install the Oracle CEP tools.

  9. When prompted restart, Eclipse. If you skip this, unreliable behavior can occur.

  10. To confirm the installation, select Help > About Eclipse Platform.

    The About Eclipse Platform dialog appears as Figure 2-4 shows.

    Figure 2-9 About Eclipse Platform

    Description of Figure 2-9 follows
    Description of "Figure 2-9 About Eclipse Platform"

  11. Click Plug-In Details.

    The About Eclipse Platform Plug-ins dialog appears as Figure 2-5 shows.

    Figure 2-10 About Eclipse Platform Plug-ins Dialog

    Description of Figure 2-10 follows
    Description of "Figure 2-10 About Eclipse Platform Plug-ins Dialog"

  12. Scroll down in the list and confirm that the plug-ins that Table 2-2 lists are shown.

    Table 2-3 Oracle CEP IDE for Eclipse Plug-Ins

    Provider Plug-in Name Plug-in Id

    Oracle

    Oracle CEP Tools Core

    com.bea.wlevs.eclipse.tools.core

    Oracle

    Oracle CEP Tools UI

    com.bea.wlevs.eclipse.tools.ui

    Oracle

    Oracle CEP Tools Documentation

    com.bea.wlevs.eclipse.tools.doc


  13. After installing Oracle CEP IDE for Eclipse, consider the following configuration topics:

2.4 Configuring Eclipse

This section describes how to configure Eclipse to work with the Oracle CEP.

To configure Eclipse:

  1. Exit out of Eclipse if it is running.

  2. Install a Java 6 JRE on your computer.

    The JRockit Java 6.0 JRE is installed with Oracle CEP in your Oracle CEP home directory. For example:

    C:\OracleCEP\jrockit-R27.6.0-50-1.6.0_05\jre
    
  3. Using the editor of your choice, open your eclipse.ini file located in your Eclipse install directory, for example, C:\eclipse as Example 2-1 shows.

    Example 2-1 Default eclipse.ini File

    -showsplash
    org.eclipse.platform
    --launcher.XXMaxPermSize
    256M
    

    Note:

    When making changes to the eclipse.ini file, add arguments one argument per line, as http://wiki.eclipse.org/Eclipse.ini describes.

    For more information about configuring Eclipse, see http://wiki.eclipse.org/FAQ_How_do_I_run_Eclipse.

  4. Add the following lines to the eclipse.ini file as Example 2-2 shows.

    Example 2-2 Memory Resources

    -showsplash
    org.eclipse.platform
    --launcher.XXMaxPermSize
    256M
    -vmargs
    -Xmx512m
    -XX:MaxPermSize=256M
    
  5. Add the following to the eclipse.ini file as Example 2-3 shows.

    Example 2-3 Virtual Machine Path

    -vm
    PATH-TO-JRE-6.0-JAVAW
    

    Where PATH-TO-JRE-6.0-JAVAW is the fully qualified path to your Java 6.0 JRE javaw executable. For example:

    -vm
    C:\OracleCEP\jrockit-R27.6.0-50-1.6.0_05\jre\bin\javaw.exe
    

    Note:

    Do not put both the -vm and the path on the same line. Each must be on a separate line as Example 2-3 shows.
  6. Save and close the eclipse.ini file.

  7. Start Eclipse.

  8. Select Help > About Eclipse Platform and click Configuration Details.

    The Configuration Details dialog appears as shown in Figure 2-11.

    Figure 2-11 Configuration Details for Java 6

    Description of Figure 2-11 follows
    Description of "Figure 2-11 Configuration Details for Java 6"

  9. Confirm that the eclipse.vm property points to the Java 6.0 JRE you configured in the eclipse.ini file.

  10. Open the Oracle CEP project you originally created using Java 5.

  11. Select Window > Preferences.

    The Preferences dialog appears as shown in Figure 2-12.

    Figure 2-12 Preferences Dialog

    Description of Figure 2-12 follows
    Description of "Figure 2-12 Preferences Dialog"

  12. Expand the Server option and select Installed Runtimes.

  13. Select a runtime that uses the Java 6 JRE.

  14. Click OK.

  15. Right-click your project and select Properties.

    The Project Properties dialog appears as shown in Figure 2-13.

    Figure 2-13 Project Properties Dialog: Java Build Path

    Description of Figure 2-13 follows
    Description of "Figure 2-13 Project Properties Dialog: Java Build Path"

  16. Select the Java Build Path option and click on the Libraries tab.

  17. Select the existing JRE System Library [jre1.5.0_XX] Java 5.0 library and click Remove.

  18. Create a new JRE System Library for Java 6.0 by clicking Add Library and choosing the Java 6.0 JRE.

  19. Select the Project Facets option.

    The Project Facet properties are displayed as Figure 2-14 shows.

    Figure 2-14 Project Properties Dialog: Project Facets

    Description of Figure 2-14 follows
    Description of "Figure 2-14 Project Properties Dialog: Project Facets"

  20. Click Modify Project.

    The Modify Faceted Project dialog appears shown in Figure 2-15.

    Figure 2-15 Modify Faceted Project

    Description of Figure 2-15 follows
    Description of "Figure 2-15 Modify Faceted Project"

  21. For the Java facet, select 6.0 from the Version pull-down menu.

  22. Click Finish.

  23. Click OK.

    Your project will now build and run using Java 6.0.