Contents

List of Figures

List of Tables

Title and Copyright Information

Send Us Your Comments

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 What to Know About Connector Architecture

• Introduction to the J2EE Connector Architecture
• What Is an Enterprise Information System?
• Connecting to an EIS: What Is a Resource Adapter?
• New Resource Adapter Support Features in This OC4J Release
• New J2EE Connector Architecture Version 1.5 Features
• Additional New OC4J Resource Adapter Features
• What Are the J2EE Connector Architecture System Contracts?
• What Are the Scenarios for Communication Through Resource Adapters?
• Outbound Versus Inbound Communication Through Resource Adapters
• Message Provider Pluggability Using the J2EE Connector Architecture
• What Are the Security Features of the J2EE Connector Architecture?
• Summary of the Security Contract
• Security Permissions
• What Are the Interface Libraries of the J2EE Connector Architecture?
• What Are the Packaging and Deployment Features?
• Resource Adapters Provided with Oracle Application Server
• Introducing Oracle JMS Support and Generic JMS Resource Adapter
• Use of Third-Party Resource Adapters
• Roles and Target Audiences
• J2EE Connector Architecture Roles
• Primary and Secondary Audiences and Topics of Interest

2 Overview: Administering Resource Adapters

• A Brief Overview of OC4J Administration
• OC4J Deployment and Configuration Features
• OC4J and Oracle Application Server Administration Tools
• Summary of Application Server Control Pages for Resource Adapters
• How to Get to the Resource Adapter Home Page
• Contents of the Resource Adapter Home Page
• Summary of Pages You Can Reach from the Resource Adapter Home Page
• General Resource Adapter Administration Features
• Setting Properties of the Resource Adapter JavaBean
• Configuring the Use of Resource Adapter Native Libraries
• Summary of Resource Adapter MBeans and Administration
• General Overview of OC4J MBean Administration
• Summary of OC4J Resource Adapter MBeans
• Resource Adapter Lifecycle: Startup and Shutdown
• Key APIs of the Lifecycle Management Model
• Understanding the Resource Adapter Startup Process
• Understanding the Resource Adapter Shutdown Process
• Manually Shutting Down or Restarting a Resource Adapter in OC4J

3 Connection Management

• Introduction to How EIS Connections Are Obtained
• Binding and Configuring a Connection Factory: Basic Settings
• Create and Bind a Connection Factory
• Edit the Configuration Properties of an Existing Connection Factory
• Configuring Connection Pooling in OC4J
• Enable Connection Pooling for a Connection Factory
• Configure a Connection Pool
• Pooling Scheme, Minimum and Maximum Connections, Initial Capacity
• Checking for Expired or Invalid Connections
• OC4J Support for Runtime Configuration of Connection Pools
• Sharing Connection Pools
• Create and Configure a Shared Connection Pool
• Edit and Reconfigure a Shared Connection Pool
• Use a Shared Connection Pool
• Configuring OC4J Logging for Connection Factories
• Obtaining Resource Adapter Connections
• Summary of the Connection Management Contract
• Metrics for Resource Adapter Connections
• Viewing Resource Adapter Connection Pool Metrics
• Descriptions of Connection Pool Configuration Metrics
• Descriptions of Connection Factory Performance Metrics
• Descriptions of Connection Pool Performance Metrics
• Troubleshooting with Resource Adapter Connection Pool Metrics

4 Transaction Management

• Introduction to Transactions and Transaction Management
• Transaction Characteristics and Scopes
• Relationship with Enterprise JavaBeans Technology
• Relationship with Java Transaction API Technology
• Local Transaction Management
• Global Transaction Management
• Resource Adapter Configuration for Level of Transaction Support
• Overview of Key Interfaces Used in Transaction Management
• Implemented by Resource Adapters: XAResource and LocalTransaction
• Implemented by Transaction Managers: UserTransaction and TransactionManager
• Implemented by OC4J: ConnectionEventListener Interface
• Transaction Support in the OC4J Connector Implementation
• Highlights of Required Transaction Support
• Highlights of Optional Transaction Support
• OC4J Support for Lazy Enlistment of Connections in a Transaction
• OC4J Support for Last-Resource-Commit Optimization
• Unsupported Transaction Scenarios
• OC4J Checking for Illegal Transaction Demarcation
• OC4J Configuration for Transaction Recovery
• OC4J Transaction Setup and Cleanup
• Global Transaction Setup and Cleanup
• Local Transaction Setup and Cleanup
• Understanding Connection Sharing in OC4J
• Conditions for Connection Sharing
• General Conditions for Connection Sharing
• Restriction on Connection Sharing for NoTransaction Support Level
• Connection Sharing Scenario
• Understanding and Configuring Transaction Recovery
• Understanding XA Recovery in OC4J
• Configuring XA Recovery in OC4J
• Understanding J2CA Connection Wrapping
• Connection Association
• Transaction Enlistment
• J2CA Connection Handle Wrapping
• Connection Association Scenarios
• Scenario 1: Enlistment of a Connection Obtained Outside a Transaction
• Scenario 2: Transactional Context Switch
• Scenario 3: Handles for a Shared Connection in Different Transactional Contexts

5 Work Management

• Overview of the Work Management Contract
• Understanding the Need for the Work Management Contract
• Introducing the Work Management Model and Key APIs
• Using the OC4J Work Management Thread Pool
• Overview of the Work Management Thread Pool
• Configuring the Work Management Thread Pool
• Using Metrics for the Work Management Thread Pool

6 Using RAs for Inbound Communication

• Concepts: Using Resource Adapters for Inbound Communication
• Introduction to Using Resource Adapters for Inbound Communication
• Background and Use Case for Resource Adapters as Message Listeners for MDBs
• Overview of Related Contracts for Inbound Communication
• Introduction to the Message Inflow Contract
• Introduction to Imported Transactions and the Transaction Inflow Contract
• Relationship Between Imported Transactions and the Work Management Contract
• Configuration and Deployment to Use an RA as a Listener for an MDB
• Understanding the Resource Adapter Configuration
• Understanding the MDB Configuration for Deployment
• Understanding Configuration for Use of Transactions in Message Delivery
• Configuring the MDB
• Error Conditions for Deployment and Configuration
• Understanding the Message Listening Lifecycle
• MDB Activation
• Message Delivery
• Message Endpoint Proxy Objects
• Message Delivery Semantics
• MDB Deactivation
• Special Conditions in Message Delivery
• Concurrent Message Delivery
• Exceptions from MDB Listener Methods
• Failure During Transacted Message Delivery
• Message Redelivery for Transactions Managed by OC4J
• Message Redelivery for Imported Transactions

7 Managing Administered Objects

• Introduction to Administered Objects
• What Is an Administered Object?
• Example: What Is an Interaction Spec?
• Example: What Are JMS Topics and Queues?
• Understanding Deployment Configuration of Administered Objects
• Binding and Editing Administered Objects in OC4J
• Create and Bind an Administered Object
• View or Edit an Administered Object
• Looking Up Administered Objects

A OC4J Resource Adapter Configuration Files

• Overview of Resource Adapter Configuration Files
• Standard ra.xml Configuration File
• Oracle oc4j-ra.xml Configuration File
• Oracle oc4j-connectors.xml Configuration File
• Hierarchy of oc4j-ra.xml
• Elements and Attributes of oc4j-ra.xml
• <config-property>
• <connection-pool>
• <connection-pooling>
• <connectionfactory-interface>
• <connector-factory>
• <default-mapping>
• <description>
• <description>
• <file>
• <impl-class>
• <initiating-user>
• <jaas-application-name>
• <jaas-module>
• <log>
• <oc4j-connector-factories>
• <password>
• <password-credential>
• <principal-mapping-entries>
• <principal-mapping-entry>
• <principal-mapping-interface>
• <property>
• <property>
• <property>
• <res-password>
• <res-password>
• <res-user>
• <res-user>
• <security-config>
• <use-connection-pool>
• <username>
• <xa-recovery-config>
• Sample oc4j-ra.xml
• Hierarchy of oc4j-connectors.xml
• Elements and Attributes of oc4j-connectors.xml
• <adminobject-class>
• <adminobject-config>
• <config-property>
• <config-property>
• <connector>
• <native-library>
• <oc4j-connectors>
• <security-permission>
• <security-permission-spec>
• <start-order>
• Sample oc4j-connectors.xml

B Third Party Licenses

• ANTLR
• The ANTLR License
• Apache
• The Apache Software License
• Apache SOAP
• Apache SOAP License

Index