user manual

Chapter 27: Using VisiConnect 305
Deploying the Resource Adapter
■
The Resource Adapter is required to support the security contract by
implementing the ManagedConnectionFactory.createManagedConnection()
method.
■
The Resource Adapter is not required to support re-authentication as part
of its ManagedConnection.getConnection() method implementation.
■
The Resource Adapter is required to specify its support for the security
contract as part of its deployment descriptor. The relevant deployment
descriptor elements are:
■
<authentication-mechanism></authentication-mechanism>
■
<authentication-mechanism-type></authentication-mechanism-type>
■
<reauthentication-support></reauthentication-support>
■
<credential-interface></credential-interface>:
Refer to section 10.3.1 of the Connectors 1.0 specification for more details on
these descriptor elements.
Packaging and Deployment
The file format for a packaged Resource Adapter module defines the contract
between a Resource Adapter provider and a Resource Adapter deployer. A
packaged Resource Adapter includes the following elements:
■
Java classes and interfaces that are required for the implementation of both
the Connectors system-level contracts and the functionality of the
Resource Adapter
■
Utility Java classes for the Resource Adapter
■
Platform-dependent native libraries required by the Resource Adapter
■
Help files and documentation
■
Descriptive meta information that ties the above elements together
For more information on packaging requirements, refer to Section 10.3 and
10.5 of the Connectors 1.0 specification, which discuss deployment
requirements and supporting JNDI configuration and lookup, respectively.
Deploying the Resource Adapter
Deployment of Resource Adapters is similar to deployment of EJBs,
Enterprise Applications and Web Applications. As with these modules, a
Resource Adapter can be deployed as an archive file or as an expanded
directory. A Resource Adapter can be deployed either dynamically using the
Borland Enterprise Server Console or the iastool utilities, or as a part of an
EAR. See the Borland Enterprise Server User's Guide for deployment details.
When a Resource Adapter is deployed, a name must be specified for the
module. This name provides a logical reference to the Resource Adapter
deployment that, among other things, can be used to update or remove the