The following sections describe the contents and organization of this guide—Developing Resource Adapters for Oracle WebLogic Server.
Document Scope and Audience
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 Java EE and resource adapter concepts. The foundation document for resource adapter development is the JSR 322: Java EE Connector Architecture 1.7. See
http://jcp.org/aboutJava/communityprocess/final/jsr322/index.html. Resource adapter developers should become familiar with the Java EE Connector Architecture 1.7 specification. This document, Developing Resource Adapters for Oracle WebLogic Server, 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.
Guide to This Document
This section, Introduction and Roadmap, introduces the organization of this guide.
Understanding Resource Adapters introduces you to the Oracle WebLogic Server implementation of the Java EE Connector Architecture as well as the resource adapter types and XML schema.
Creating and Configuring Resource Adapters describes how to create resource adapters using the Oracle WebLogic Server implementation of the Java EE Connector Architecture.
Programming Tasks describes programming tasks for resource adapters.
Using Contexts and Dependency Injection in Resource Adapters describes WebLogic Server support for Contexts and Dependency Injection (CDI) in resource adapter beans.
Connection Management introduces you to resource adapter connection management.
Transaction Management introduces you to the resource adapter transaction management.
Message and Transactional Inflow describes resource adapter messaging inflow and transactional inflow.
Security describes how to configure security for resource adapters.
Packaging and Deploying Resource Adapters discusses packaging and deploying requirements for resource adapters and provides instructions for performing these tasks.
weblogic-ra.xml Schema provides a complete reference for the schema for the WebLogic Server-specific deployment descriptor,
Resource Adapter Best Practices provides best practices for resource adapter developers.
The foundation document for resource adapter development is JSR 322: Java EE Connector Architecture 1.7. Developing Resource Adapters for Oracle WebLogic Server document assumes you are familiar with the Java EE Connector Architecture specification, which contains design and development information that is specific to developing WebLogic Server resource adapters.
For comprehensive guidelines for developing, deploying, and monitoring WebLogic Server applications, see the following documents:
Developing Applications for Oracle WebLogic Server is a guide to developing WebLogic Server applications.
Deploying Applications to Oracle WebLogic Server is the primary source of information about deploying WebLogic Server applications.
Tuning Performance of Oracle WebLogic Server contains information on monitoring and improving the performance of WebLogic Server applications.
Examples for the Resource Adapter Developer
In addition to this document, Oracle provides resource adapter examples for software developers. WebLogic Server optionally installs API code examples in the
/wlserver/samples/server/examples/src/examples directory. For more information about the WebLogic Server code examples, see Sample Applications and Code Examples in Understanding Oracle WebLogic Server.
The resource adapter example provided with this release of WebLogic Server is compliant with the 1.7 Connector Architecture. Oracle recommends that you examine, run, and understand these resource adapter examples before developing your own resource adapters.
New and Changed Features in This Release
For a comprehensive listing of the new WebLogic Server features introduced in this release, see What's New in Oracle WebLogic Server220.127.116.11.0.