Oracle JCA Adapters Component Lifecycle

5-62 Oracle Fusion Middleware High Availability Guide

5.10.1.1 Oracle JCA Adapters Component Lifecycle

The lifecycle of an adapter is controlled by the Oracle SOA Service Infrastructure. There are three high-level steps in the initialization of an Oracle JCA Adapter: ■ Deployment : Oracle JCA Adapters are deployed during installation as J2CA 1.5 resource adapters RAR files within the same Oracle WebLogic Server container as Oracle Fusion Middleware. The physical deployment of adapters involves using the RAR file and registering the adapters as connectors with the underlying Oracle WebLogic Server, or the middle tier platform. The RAR file contains the ra.xml file, which contains declarative information about the contract between Oracle WebLogic Server and the resource adapter. In addition, the RAR file contains weblogic-ra.xml which is the deployment descriptor file containing deployment-specific information about the resource adapter. ■ Loading : Loading refers to the process of creating in-memory resources and creating connections to the configured end-point. Although Oracle JCA Adapters are physically deployed as J2CA 1.5 resource adapters, their logical deployment involves creating the Connection Factory entries for the J2CA 1.5 resource adapter by editing the weblogic-ra.xml file. This file is Oracle WebLogic Server-specific deployment descriptor for a resource adapter. It contains configurations for deploying resource adapters to Oracle WebLogic Server, which includes the back-end application connection information as specified in the deployment descriptor of the resource adapter, Java Naming and Directory Interface JNDI name to be used, connection pooling parameters, resource principal mapping mechanism, and configurations. ■ Activation : Activation refers to initiation of a JCA binding component Service and Reference within a Composite. Listeners are started for the endpoint referenced by the Adapter configuration within the Composite. Property Changes During Oracle JCA Adapters Runtime Oracle JCA Adapters expose the underlying back-end operation-specific properties as header properties and allow the manipulation of these elements within a business process.The underlying properties are as follows: ■ interactionspec or activationspec Properties - These properties require the adapter endpoint to be recycled re-activated. ■ Endpoint Properties - Changes to these properties are notified to the adapter without requiring the endpoint to be restarted.

5.10.1.2 Oracle JCA Adapters Reliability and Transactional Behavior