JBoss.orgCommunity Documentation
EclipSLEE provides means to create, edit and delete JAIN SLEE Resource Adaptors.
To create a component it may be easier (but not mandatory) to first create a package to contain it. This package should be created as a child of the <ra-module>/src/main/java folder. To do this right-click on the src folder and select
→ . Give the new package a name using the popup dialog (shown below).
In case a new package is not created at this point, it can still be created in the Component wizard, but no validation is performed at that time, regarding the package naming conventions.
To create a new JAIN SLEE Resource Adaptor, right-click on the created package (or the module entry if the package is not yet created) and choose
→ as shown below.
A dialog should appear. Expand the JAIN SLEE item and choose JAIN SLEE Resource Adaptor. The dialog should now look like the following:
Click to get the following dialog:
The source folder and package dialogs will be completed if → has been selected from right-clicking on a package. Otherwise it may need to be chosen by selecting and selecting the desired locations or typing it's name in the appropriate field and it will be created in the end.
Name the Resource Adaptor; the name must end with "ResourceAdaptor.java
". Then click to go to the component identity dialog, pictured below:
The Name, Vendor and Version fields are mandatory and are used by the SLEE to identify the Resource Adaptor. The description field is optional, but strongly recommended to be completed to allow easy identification of the Resource Adaptor in future.
After completing these fields click
to specify the RA Types the Resource Adaptor implements.
This dialog allows you to specify which RA Types this Resource Adaptor will implement. Select them from the top list (Available RA Types) by clicking . To remove them, select them from the bottom list (Selected RA Types) and click . When done, click to edit the Resource Adaptor Config Properties.
Here, the Resource Adaptor's Config Properties can be set. Add a Config Property field by clicking on and writing it's name on the Name column, selecting the appropriate Java Type in the Type column and, this is optional, type a default value (if no value is to be set, delete the default ?
which is inserted) in the Default Value column.
In this same wizard page, it is possible to define whether this Resource Adaptor supports reconfiguration when in ACTIVE state by checking or leaving unchecked the
checkbox.Once finished, click
to create the Resource Adaptor Type.can be clicked at any point after setting the Resource Adaptor's identity if a skeleton Resource Adaptor is required. It is not necessary to complete each wizard page first.
The Resource Adaptor Java file, MobicentsDemoResourceAdaptor.java
(plus the remaining interfaces and classes which were selected at the wizard) is created in the specified package and opened for editing in the workspace. The ra-jar.xml
deployment descriptor is updated to reflect the new ratype or created if not already present. The resulting workspace can be seen below.
It is possible with EclipSLEE to edit existing components. When right-clicking in one of the JAIN SLEE Resource Adaptor classes a similar menu should be shown:
It is also possible to edit by right-clicking on the resource-adaptor-jar.xml descriptor. In that case a sub-menu allowing to pick which Resource Adaptor to edit is shown:
After selecting the desired Resource Adaptor, the menu shown should be similar to the one presented when using the class file to edit.
The following actions are available for a JAIN SLEE Resource Adaptor:
This operation can be accessed by selecting Identity.... With this operation it is possible to change the JAIN SLEE Resource Adaptor identity (name, vendor, version) and it's description. The following dialog is presented:
EclipSLEE does not automatically update other component descriptors in order to reflect such identity change, so it should be made manually.
This operation can be accessed by selecting Resource Adaptor Types..., which allows to change the Resource Adaptor Types being implemented by this RA. The following dialog is presented:
This operation can be accessed by selecting Config Properties..., allowing to add new Config Properties to the Resource Adaptor or modify or remove the existing ones. The following dialog is presented:
It is possible with EclipSLEE to delete existing components. Right-clicking in one of the JAIN SLEE Resource Adaptor classes or XML descriptor file (see Section 9.2, “Editing a JAIN SLEE Resource Adaptor”) and selecting the Delete option.
A confirmation dialog similar to the following should be presented:
Deleting a component is an irreversible operation, so it should be used carefully.