Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Structure

Related Documents

Conventions

1 Introduction to OC4J Services

Java Naming and Directory Interface (JNDI)

Java Message Service (JMS)

Remote Method Invocation (RMI)

Data Sources

Java Transaction API (JTA)

J2EE Connector Architecture (J2CA)

Java Object Cache

2 Java Naming and Directory Interface

Introduction

Initial Context

Constructing a JNDI Context

The JNDI Environment

Creating the Initial Context in OC4J

From J2EE Application Clients

From J2EE Application Components

JNDI State Replication

Enabling JNDI State Replication

JNDI State Replication Limitations

3 Java Message Service (JMS)

Overview

Oracle Application Server JMS

Configuring OracleAS JMS Ports

Configuring OracleAS JMS Destination Objects

Steps for Sending a Message

Steps for Receiving a Message

OracleAS JMS Utilities

OracleAS JMS File-Based Persistence

Abnormal Termination

Predefined OracleAS JMS Exception Queue

Message Paging

OracleAS JMS Configuration File Elements for jms.xml

OracleAS JMS System Properties

Resource Providers

Configuring a Custom Resource Provider

Oracle JMS

Using OJMS as a Resource Provider

Using OJMS with Oracle Application Server and the Oracle Database

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

Using SonicMQ as a Resource Provider

Using SwiftMQ as a Resource Provider

Using Message-Driven Beans

High Availability and Clustering for JMS

OracleAS JMS High Availability Configuration

OJMS High Availability Configuration

Failover Scenarios When Using a RAC Database With OJMS

Server Side Sample Code for Failover for Both JMS Providers

Clustering Best Practices

4 Data Sources

Introduction

Types of Data Sources

Mixing Data Sources

Defining Data Sources

Configuration Files

Data Source Attributes

Defining Data Sources in Oracle Enterprise Manager 10g

Defining Data Sources in the XML Configuration File

Password Indirection

Associating a Database Schema with a Data Source

Using Data Sources

Portable Data Source Lookup

Retrieving a Connection from a Data Source

Retrieving Connections with a Nonemulated Data Source

Connection Retrieval Error Conditions

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

High Availability Support for Data Sources

Oracle Maximum Availability Architecture (MAA)

High Availability (HA) 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

5 Oracle Remote Method Invocation

Introduction to RMI/ORMI

ORMI Enhancements

Client-Side Requirements

Configuring OC4J for RMI

Configuring RMI Using Oracle Enterprise Manager 10g

Configuring RMI Manually

RMI Configuration Files

JNDI Properties for RMI

Example Lookups

Configuring ORMI Tunneling through HTTP

Configuring an OC4J Mount Point

6 J2EE Interoperability

Introduction to RMI/IIOP

Transport

Naming

Security

Transactions

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

Advanced Interoperability in Oracle Application Server Environment

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)

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

EJB Client Security Properties (ejb_sec.properties)

JNDI Properties for Interoperability (jndi.properties)

7 Java Transaction API

Introduction

Demarcating Transactions

Enlisting Resources

Single-Phase Commit

Enlisting a Single Resource

Demarcating the Transaction

JDBC Transactions

Two-Phase Commit

Configuring Two-Phase Commit Engine

Limitations of Two-Phase Commit Engine

Configuring Timeouts

Recovery for CMP Beans when a 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

8 J2EE Connector Architecture (J2CA)

Introduction

Resource Adapters

Application Interface

Quality of Service Contracts

Deploying and Undeploying Resource Adapters

Deployment Descriptors

Standalone Resource Adapters

Embedded Resource Adapters

Locations of Relevant Files

Specifying Quality of Service Contracts

Configuring Connection Pooling

Managing EIS Sign-On

Declarative Container-Managed Sign-On

Programmatic Container-Managed Sign-On

9 Java Object Cache

Java Object Cache Concepts

Java Object Cache Basic Architecture

How the Java Object Cache Works

Cache Organization

Java Object Cache Features

Java Object Cache Object Types

Memory Objects

Disk Objects

StreamAccess Objects

Pool Objects

Java Object Cache Environment

Cache Regions

Cache Subregions

Cache Groups

Region and Group Size Control

Cache Object Attributes

Developing Applications Using Java Object Cache

Importing Java Object Cache

Defining a Cache Region

Defining a Cache Group

Defining a Cache Subregion

Defining and Using Cache Objects

Implementing a CacheLoader Object

Invalidating Cache Objects

Destroying Cache Objects

Multiple Object Loading and Invalidation

Java Object Cache Configuration

Declarative Cache

Capacity Control

Implementing a Cache Event Listener

Restrictions and Programming Pointers

Working with Disk Objects

Local and Distributed Disk Cache Objects

Adding Objects to the 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

Using Distributed Objects, Regions, Subregions, and Groups

Cached Object Consistency Levels

Sharing Cached Objects in an OC4J Servlet

Using User-Defined Class Loaders

HTTP and Security for Distributed Cache

Monitoring and Debugging

XML Schema for Cache Configuration

XML schema for attribute declaration

Index