Contents

List of Figures

List of Tables

Title and Copyright Information

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?
  • Deploying Resource Adapters
  • Importing Standalone Resource Adapters
  • Deploying Multiple Versions of a Standalone Resource Adapter
• 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