Document Scope and Audience Guide to This Document

1 Introduction and Roadmap 1-1 1 Introduction and Roadmap The following sections describe the contents and organization of this guide—Oracle Fusion Middleware Programming Resource Adapters for Oracle WebLogic Server. ■ Section 1.1, Document Scope and Audience ■ Section 1.2, Guide to This Document ■ Section 1.3, Related Documentation ■ Section 1.4, Examples for the Resource Adapter Developer ■ Section 1.5, New and Changed Features in This Release

1.1 Document Scope and Audience

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 Section 1.3, 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. See http:java.sun.comj2eeconnector . 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.

1.2 Guide to This Document

■ This section, Chapter 1, Introduction and Roadmap, introduces the organization of this guide. 1-2 Programming Resource Adapters for Oracle WebLogic Server ■ Chapter 2, Understanding Resource Adapters, introduces you to the Oracle WebLogic Server implementation of the J2EE Connector Architecture as well as the resource adapter types and XML schema. ■ Chapter 3, Creating and Configuring Resource Adapters, describes how to create resource adapters using the Oracle WebLogic Server implementation of the J2EE Connector Architecture. ■ Chapter 4, Programming Tasks, describes programming tasks for resource adapters. ■ Chapter 5, Connection Management, introduces you to resource adapter connection management. ■ Chapter 6, Transaction Management, introduces you to the resource adapter transaction management. ■ Chapter 7, Message and Transactional Inflow, describes resource adapter messaging inflow and transactional inflow. ■ Chapter 8, Security, describes how to configure security for resource adapters. ■ Chapter 9, Packaging and Deploying Resource Adapters, discusses packaging and deploying requirements for resource adapters and provides instructions for performing these tasks. ■ Appendix A, weblogic-ra.xml Schema, provides a complete reference for the schema for the WebLogic Server-specific deployment descriptor, weblogic-ra.xml . ■ Appendix B, Resource Adapter Best Practices, provides best practices for resource adapter developers.

1.3 Related Documentation