Programming WebLogic Resource Adapters
This document is written for resource adapter users, deployers, and software developers who develop applications that include J2EE resource adapters to be deployed to WebLogic Server. This document also contains information that is useful for business analysts and system architects who are evaluating WebLogic Server or considering the use of WebLogic Server resource adapters for a particular application.
The topics in this document are relevant during the design and development phases of a software project. The document also includes topics that are useful in solving application problems that are discovered during test and pre-production phases of a project.
This document does not address production phase administration, monitoring, or performance tuning topics. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.
It is assumed that the reader is familiar with J2EE and resource adapter concepts. The foundation document for resource adapter development is Sun Microsystems J2EE Connector Architecture Specification, Version 1.5 Final Release (referred to in this guide as the J2CA 1.5 Specification): http://java.sun.com/j2ee/connector/ . Resource adapter developers should become familiar with the J2CA 1.5 Specification. This document emphasizes the value-added features provided by WebLogic Server resource adapters and key information about how to use WebLogic Server features and facilities to get a resource adapter up and running.
The foundation document for resource adapter development is Sun Microsystems J2EE Connector Architecture Specification, Version 1.5 Final Release (referred to in this guide as the J2CA 1.5 Specification): http://java.sun.com/j2ee/connector/ . This document assumes you are familiar with the J2CA 1.5 Specification and contains design and development information that is specific to developing WebLogic Server resource adapters.
In addition to this document, BEA Systems provides resource adapter examples for software developers. WebLogic Server optionally installs API code examples in
WL_HOME is the top-level directory of your WebLogic Server installation. You can start the examples server, and obtain information about the samples and how to run them from the WebLogic Server Start menu.
The resource adapter examples provided with this release of WebLogic Server are compliant with the J2CA 1.5 Specification. BEA recommends that you examine, run, and understand these resource adapter examples before developing your own resource adapters.
For information about new, changed, and deprecated features in this release of WebLogic Server, see WebLogic Server Features and Changes in WebLogic Server Release Notes.
For information about known problems by general release, as well as service pack, for all WebLogic Server APIs, including resource adapters, see WebLogic Server Known and Resolved Issues.
The Link-Ref mechanism was introduced in the 8.1 release of WebLogic Server to enable the deployment of a single base adapter whose code could be shared by multiple logical adapters with various configuration properties. For resource adapters developed under the J2CA 1.5 Specification in the current release of WebLogic Server, the Link-Ref mechanism is deprecated and is replaced by the new J2EE libraries feature. However, the Link-Ref mechanism is still supported in this release for resource adapters developed under the J2CA 1.0 Specification. For more information on J2EE libraries, see Creating Shared J2EE Libraries and Optional Packages in Developing Applications with WebLogic Server. For information about using the Link-Ref mechanism with 1.0 resource adapters, see (Deprecated) Configuring the Link-Ref Mechanism.