Customize tolvenEJB Plugin

From DOC

Overview

Customization of tolvenEJB currently consists of adding classes to the tolvenEJB.jar. It is also possible for a given class to access a properties file as a resource, which has been dynamically assembled during configPhase1 of the Tolven Plugin Framework assembly process.

Add Classes To tolvenEJB

You are adding classes to the tolvenEJB plugin, so add the following extension to your plugin:

<extension id="ejbclasses" plugin-id="org.tolven.component.tolvenejb" point-id="classes">
     <parameter id="dir" value="ejb/classes" />
</extension>

The extension id need only be a unique id within this plugin. The org.tolven.component.tolvenejb plugin is looking for classes using its point-id called "classes". The parameter id="dir" indicates that it expects to find your classes in a directory given by the value, which in this example is called ejb/classes.

When using another plugin, you need to add an import tag to your plugin. There should be only on <requires> tag (which can contain many <import> tags) and it should appear before any <extension> tags.

<requires>
     <import plugin-id="org.tolven.component.tolvenejb" />
</requires>

Finally, you need to add your classes to the ejbclasses directory, which in this case must be located at the same level as the manifest within the plugin zip.

Add A Properties File Resource To A Class In tolvenEJB

In the following extension, the plugin org.tolven.component.tolvenejb provides the functionality to add a properties file using the point-id called property. This extension will create a properties file called com/myorg/SomeClass.properties in the tolvenEJB.jar file. That properties file, will contain a property whose name is myProperty1 with a value myProperty1Value. If more properties are required, they can be added as extra extensions, referring to the same class.

<extension id="property" plugin-id="org.tolven.component.tolvenejb" point-id="property">
     <parameter id="class" value="com.myorg.SomeClass" />
     <parameter id="name" value="myProperty1" />
     <parameter id="value" value="myProperty1Value" />
</extension>

The class SomeClass mentioned above must also be supplied for inclusion in the tolvenEJB.jar. This is done by adding classes to the tolvenEJB.jar as described in Adding Classes To tolvenEJB. You can also add the extension described there to your custom plugin.

When using another plugin, you need to add an import tag to your plugin. There should be only on <requires> tag (which can contain many <import> tags) and it should appear before any <extension> tags.

<requires>
     <import plugin-id="org.tolven.component.tolvenejb" />
</requires>

Finally, you need to add your classes to the ejbclasses directory, which in this case must be located at the same level as the manifest within the plugin zip.