Apama 10.15.0 | Developing Apama Applications | Developing EPL Plug-ins | Writing EPL Plug-ins in Java | Steps for developing EPL plug-ins written in Java in Software AG Designer
 
Steps for developing EPL plug-ins written in Java in Software AG Designer
*To develop EPL plug-ins written in Java in Software AG Designer
1. Add Java support to a project. See also Adding the Java nature to an Apama project.
2. Create the source files.
In the Project Explorer view, right-click your project and select New > Java EPL Plugin.
A wizard appears that lets you specify the plug-in name, a description, the Apama package name, the Java source folder and the Java package. See also Adding an EPL Plug-in written in Java.
Software AG Designer automatically adds an entry for the EPL plug-in to the jmon-jar.xml deployment descriptor file and regenerates the JAR file to include the new plug-in.
If you want to build your JAR files manually, right-click your project and select Apama > Build JAR Files. This is useful if you unselected the Build jar files automatically option in the apama_java.xml file, which is in the config directory of your project. One reason you might not want to build the JAR files automatically is that the build takes too long. When Build jar files automatically is selected, Software AG Designer builds the JAR files every time you modify the EPL plug-in.
3. Create your plug-in's launch configuration.
Software AG Designer adds all JAR files for your plug-in to the correlator initialization list and all non-plug-in JAR files to the correlator class path.
If you want to build your project's files outside Software AG Designer and Eclipse, right-click your project and select Apama > Generate Ant Buildfiles. Software AG Designer generates an Ant build file (with the name build-project_name.xml), which you can use only to build your project's plug-in JAR files outside of the Eclipse environment. Note that this is unrelated to the Software AG Designer feature for exporting an Ant build file that you can use for deployment. See also Defining custom launch configurations.
4. Run and test your plug-in. See Launching Projects.
5. Debug your plug-in. See Debugging EPL Applications.
6. Deploy your plug-in. See Deploying EPL plug-ins written in Java.
Software AG Designer generates your plug-in's JAR file in the config_name java application files folder of your project's directory. By default, config_name is the project name.
You can manage the content of the plug-in JAR file and jmon-jar.xml file by using the editor in Software AG Designer to update the apama_java.xml file, which is located in the project's config folder. You can use this editor to do the following:
*Set the metadata.
*Set the injection order.
*Add non-plug-in Java classes to the plug-in JAR files.
*Add Java classes that were not created by the Apama wizards in Software AG Designer to the plug-in JAR file.