Oracle Application Server Containers for J2EE Services Guide -- Contents

Java Naming and Directory Interface (JNDI)

Java Message Service (JMS)

Remote Method Invocation (RMI)

Data Sources

Java Transaction API (JTA)

J2EE Connector Architecture (JCA)

Java Object Cache

Introduction

Initial Context

Constructing a JNDI Context

The JNDI Environment

Creating the Initial Context in OC4J

From J2EE Application Clients

Environment Properties

Application Client Example

From J2EE Application Components

Objects in the Same Application

Objects Not in the Same Application

JNDI Clustering

Enabling JNDI Clustering

JNDI Clustering Limitations

Multiple Islands on a Given Subnet

Propagating Changes Across the Cluster

Binding a Remote Object

Overview

Oracle Application Server JMS

Configuring OracleAS JMS Ports

Configuring OracleAS JMS Destination Objects

Default Destination Objects

Default Connection Factories

Steps for Sending and Receiving a Message

OracleAS JMS Utilities

OracleAS JMS File-Based Persistence

Predefined OracleAS JMS Exception Queue

Message Expiration

Message Paging

OracleAS JMS Configuration File Elements for jms.xml

Examples

OracleAS JMS System Properties

Resource Providers

Configuring a Custom Resource Provider

Oracle JMS

Using OJMS as a Resource Provider

Install and Configure the JMS Provider

Create User and Assign Privileges

Create JMS Destination Objects

Define the OJMS Resource Provider

Access the OJMS Resources

Using OJMS with Oracle Application Server and the Oracle Database

Error When Copying aqapi.jar

OJMS Certification Matrix

Map Logical Names in Resource References to JNDI Names

JNDI Naming for OracleAS JMS

JNDI Naming for OJMS

JNDI Naming Property Setup for Java Application Clients

Client Sends JMS Message Using Logical Names

Third-Party JMS Providers

Using WebSphere MQ as a Resource Provider

Configuring WebSphere MQ

Using SonicMQ as a Resource Provider

Configuring SonicMQ

Using SwiftMQ as a Resource Provider

Configuring SwiftMQ

Using Message-Driven Beans

High Availability and Clustering for JMS

Oracle Application Server JMS High Availability Configuration

Terminology

OracleAS JMS Server Distributed Destinations

OracleAS Dedicated JMS Server

Modifying the OPMN Configuration

Configuring OracleAS JMS

Queue Connection Factory Definition Example

Deploying Applications

High Availability

OJMS High Availability Configuration

Failover Scenarios When Using a RAC Database With OJMS

Using JMS with RAC Network Failover

Using OJMS With Transparent Application Failover (TAF)

Server Side Sample Code for Failover for Both JMS Providers

Clustering Best Practices

Introduction

Types of Data Sources

Emulated Data Sources

Non-emulated Data Sources

Native Data Sources

Mixing Data Sources

Defining Data Sources

Configuration Files

Defining Location of the Data Source XML Configuration File

Application-Specific Data Source XML Configuration File

Data Source Attributes

Defining Data Sources in Oracle Enterprise Manager

Defining Data Sources in the XML Configuration File

Password Indirection

Configuring an Indirect Password with Oracle Enterprise Manager

Configuring an Indirect Password Manually

Associating a Database Schema with a Data Source

The database-schema.xml File

Example Configuration

Using Data Sources

Portable Data Source Lookup

Retrieving a Connection from a Data Source

Retrieving Connections with a Non-emulated Data Source

Retrieving a Connection Outside a Global Transaction

Retrieving a Connection Within a Global Transaction

Connection Retrieval Error Conditions

Using Different User Names for Two Connections to a Single Data Source

Improperly configured OCI JDBC driver

Using Two-Phase Commits and Data Sources

Using Oracle JDBC Extensions

Using Connection Caching Schemes

Using the OCI JDBC Drivers

Using DataDirect JDBC Drivers

Installing and Setting Up DataDirect JDBC Drivers

Example DataDirect Data Source Entries

SQLServer

DB2

Sybase

High Availability Support for Data Sources

Introduction

Oracle Maximum Availability Architecture (MAA)

High Availability Support in OC4J

Configuring Network Failover with OC4J

Configuring Transparent Application Failover (TAF) with OC4J

Configuring a TAF Descriptor (tnsnames.ora)

Connection Pooling

Acknowledging TAF Exceptions

SQL Exception Handling

Introduction to RMI/ORMI

ORMI Enhancements

Increased RMI Message Throughput

Enhanced Threading Support

Co-located Object Support

Client-Side Requirements

Configuring OC4J for RMI

Configuring RMI Using Oracle Enterprise Manager

Configuring RMI Manually

Editing server.xml

Editing rmi.xml

Editing opmn.xml

RMI Configuration Files

JNDI Properties for RMI

Naming Provider URL

Context Factory Usage

Example Lookups

OC4J Standalone

OC4J in Oracle Application Server: Releases Before 10g (9.0.4)

OC4J in Oracle Application Server: 10g (9.0.4) Release

Configuring ORMI Tunneling through HTTP

Configuring an OC4J Mount Point

Introduction to RMI/IIOP

Client-Side Requirements

The rmic.jar Compiler

Switching to Interoperable Transport

Simple Interoperability in a Standalone Environment

Advanced Interoperability in a Standalone Environment

Simple Interoperability in Oracle Application Server Environment

Configuring for Interoperability Using Oracle Enterprise Manager

Configuring for Interoperability Manually

Advanced Interoperability in Oracle Application Server Environment

Configuring for Interoperability Using Oracle Enterprise Manager

Configuring for Interoperability Manually

The corbaname URL

The OPMN URL

Exception Mapping

Invoking OC4J-Hosted Beans from a Non-OC4J Container

Configuring OC4J for Interoperability

Interoperability OC4J Flags

Interoperability Configuration Files

EJB Server Security Properties (internal-settings.xml)

CSIv2 Security Properties

CSIv2 Security Properties (internal-settings.xml)

CSIv2 Security Properties (ejb_sec.properties)

Trust Relationships

CSIv2 Security Properties (orion-ejb-jar.xml)

The <transport-config> Element

The <as-context> element

The <sas-context> element

EJB Client Security Properties (ejb_sec.properties)

JNDI Properties for Interoperability (jndi.properties)

Context Factory Usage

Introduction

Demarcating Transactions

Enlisting Resources

Single-Phase Commit

Enlisting a Single Resource

Configure the Data Source

Retrieve the Data Source Connection

Perform JNDI Lookup

Retrieve a Connection

Demarcating the Transaction

Container-Managed Transactional Demarcation

Bean-Managed Transactions

JTA Transactions

JDBC Transactions

Two-Phase Commit

Configuring Two-Phase Commit Engine

Database Configuration Steps

OC4J Configuration Steps

Limitations of Two-Phase Commit Engine

Configuring Timeouts

Recovery for CMP Beans When Database Instance Fails

Connection Recovery for CMP Beans That Use Container-Managed Transactions

Connection Recovery for CMP Beans That Use Bean-Managed Transactions

Using Transactions With MDBs

Transaction Behavior for MDBs using OC4J JMS

Transaction Behavior for MDBs using Oracle JMS

MDBs that Use Container-Managed Transactions

MDBs that Use Bean-Managed Transactions and JMS Clients

Introduction

Resource Adapters

Standalone Resource Adapters

Embedded Resource Adapters

Example of RAR File Structure

The ra.xml Descriptor

Application Interface

Quality of Service Contracts

Deploying and Undeploying Resource Adapters

Deployment Descriptors

The oc4j-ra.xml Descriptor

The oc4j-connectors.xml Descriptor

Standalone Resource Adapters

Deployment

Embedded Resource Adapters

Deployment

Locations of Relevant Files

Specifying Quality of Service Contracts

Configuring Connection Pooling

Managing EIS Sign-On

Component-Managed Sign-On

Container-Managed Sign-On

Declarative Container-Managed Sign-On

Programmatic Container-Managed Sign-On

OC4J-Specific Authentication Classes

JAAS Pluggable Authentication Classes

Special Features Accessible Via Programmatic Interface

Java Object Cache Concepts

Java Object Cache Basic Architecture

Distributed Object Management

How the Java Object Cache Works

Cache Organization

Java Object Cache Features

Java Object Cache Object Types

Java Object Cache Environment

Cache Regions

Cache Subregions

Cache Groups

Region and Group Size Control

Cache Object Attributes

Using Attributes Defined Before Object Loading

Using Attributes Defined Before or After Object Loading

Developing Applications Using Java Object Cache

Working with Disk Objects

Local and Distributed Disk Cache Objects

Local Objects

Distributed Objects

Adding Objects to the Disk Cache

Automatically Adding Objects

Explicitly Adding Objects

Using Objects that Reside Only in Disk Cache

Working with StreamAccess Objects

Creating a StreamAccess Object

Working with Pool Objects

Creating Pool Objects

Using Objects from a Pool

Implementing a Pool Object Instance Factory

Pool Object Affinity

Running in Local Mode

Running in Distributed Mode

Configuring Properties for Distributed Mode

Setting the Distribute Configuration Property

Setting the discoveryAddress Configuration Property

Using Distributed Objects, Regions, Subregions, and Groups

Using the REPLY Attribute with Distributed Objects

Using SYNCHRONIZE and SYNCHRONIZE_DEFAULT

Cached Object Consistency Levels

Using Local Objects

Propagating Changes Without Waiting for a Reply

Propagating Changes and Waiting for a Reply

Serializing Changes Across Multiple Caches

Sharing Cached Objects in an OC4J Servlet

XML Schema for Cache Configuration

XML schema for attribute declaration

Contents

Title and Copyright Information

List of Examples

List of Figures

List of Tables

Send Us Your Comments

Preface

1 Introduction to OC4J Services

2 Java Naming and Directory Interface

3 Java Message Service

4 Data Sources

5 Oracle Remote Method Invocation

6 J2EE Interoperability

7 Java Transaction API

8 J2EE Connector Architecture

9 Java Object Cache

Index