web server - Borland Technical Publications

Resource Adapter overview
7 Deploy the Resource Adapter Archive to the Borland Enterprise Server, or include it
in an Enterprise Application Archive (EAR) file to be deployed as part of a J2EE
application.
Editing existing Resource Adapters
If you have existing Resource Adapters you would like to deploy to the Borland
Enterprise Server, it may only be necessary to edit the Borland-specific deployment
descriptor described above and repackage the adapter. Doing so involves the following
steps, with illustrative example:
1 Create an empty staging directory for the RAR:
mkdir c:/temp/staging
2 Copy the Resource Adapter to be deployed into the staging directory:
cp shmeAdapter.rar c:/temp/staging
3 Extract the contents of the Resource Adapter Archive:
jar xvf shmeAdapter.rar
The staging directory should now contain the following:
■
■
a JAR containing Java classes that implement the Resource Adapter
a META-INF directory containing the files Manifest.mf and ra.xml
1 Create the ra-borland.xml file using the Borland Deployment Descriptor Editor
(DDEditor) and save it into the staging area's META-INF directory. See the User’s
Guide for information on using the DDEditor.
2 Create the new Resource Adapter Archive
jar cvf shmeAdapter.rar -C c:/temp/staging
3 You may now deploy the Resource Adapter to the Borland Enterprise Server.
Resource Adapter Packaging
The Resource Adapter is a J2EE component contained in a RAR. Resource Adapters
use a common directory format. The following is an example of a Resource Adapter's
directory structure:
Resource Adapter Directory Structure:
.META-INF/ra.xml
.META-INF/ra-borland.xml
./images/shmeAdapter.jpg
./readme.html
./shmeAdapter.jar
./shmeUtilities.jar
./shmeEisSdkWin32.dll
./shmeEisSdkUnix.so
As shown in the structure above, the Resource Adapter can include documentation
and related files not directly used by the Resource Adapter--for example, the image
and readme files. Packaging the Resource Adapter means packaging these files as
well.
Packaging a Resource Adapter includes the following steps:
1 Create a temporary staging directory.
2 Compile the Resource Adapter Java classes into the staging directory. (Or, as
above, simply copy pre-compiled classes into the staging directory.)
Chapter 27: Using VisiConnect 265