Skip Headers
Oracle® Containers for J2EE Developer's Guide
10g (10.1.3.1.0)

Part Number B28952-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

1 Getting Started with OC4J

This chapter describes Oracle Containers for J2EE 10g (10.1.3.1.0), or OC4J, which is part of the Oracle Application Server 10g Release 3 (10.1.3.1.0) installation or a standalone server.

This chapter includes the following topics:

Introduction to OC4J

Oracle Containers for J2EE 10g (10.1.3.1.0) provides a complete Java 2 Enterprise Edition (J2EE) 1.4-compliant environment.

OC4J provides all the containers, APIs, and services that J2EE specifies. It is based on technology licensed from Ironflare Corporation, which develops the Orion server—one of the leading J2EE containers. As such, the product and some of the documentation still contains some reference to the Orion server.

OC4J is written entirely in Java and executes on the Java Virtual Machine (JVM) of the standard Java Development Kit (JDK). You can run OC4J on the standard JDK that exists on your operating system.

J2EE Support in OC4J

OC4J supports and is certified for the standard J2EE APIs, as listed in Table 1-1.

Table 1-1 OC4J J2EE Support

J2EE Standard APIs Version Supported By OC4J

JavaServer Pages (JSP)

2.0

Servlets

2.4

Enterprise JavaBeans (EJB)

2.1, 3.0 (Complete EJB 3.0 and JPA implementation)

Java Management Extensions (JMX)

1.2

J2EE Management

1.0

J2EE Application Deployment

1.1

Java Transaction API (JTA)

1.0

Java Message Service (JMS)

1.1

Java Naming and Directory Interface (JNDI)

1.2

Java Mail

1.2

Java Database Connectivity (JDBC)

3.0

Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider

1.0

J2EE Connector Architecture

1.5

Java API for XML-Based RPC (JAX-RPC)

1.1

SOAP with Attachments API for Java (SAAJ)

1.2

Java API for XML Processing (JAXP)

1.2

Java API for XML Registries (JAXR)

1.0.5


New Features in OC4J

Oracle Containers for J2EE 10g (10.1.3.x) includes a number of new features and enhancements, which are summarized in the following text.

Support for Web Services

OC4J provides full support for Web Services in accordance with the J2EE 1.4 standard, including JAX-RPC 1.1. Web Services interoperability is also supported.

  • EJB 2.1 Web services end point model

  • JSR 109 client and server deployment model

  • CORBA Web services: Support for wrapping existing basic CORBA Servants as Web services and auto-generating WSDL from IDL

  • Support for source code annotations to customize Web services behavior such as invocation and ending styles (RPC/literal, RPC/encoded, Doc/literal); customizing the Java to XML mapping; enforcing security.

  • Database and JMS Web services

Support for J2EE 1.4 Application Management and Deployment Specifications

OC4J supports the following specifications and JSRs which define new standards for deploying and managing applications in a J2EE environment.

  • The Java Management Extensions (JMX) 1.2 specification, which allows standard interfaces to be created for managing resources, such as services and applications, in a J2EE environment. The OC4J implementation of JMX provides a JMX client that can be used to completely manage an OC4J server and applications running within it.

  • The J2EE Management Specification (JSR-77), which enables standard interfaces to be created for managing applications in a J2EE environment.

  • The J2EE Application Deployment API (JSR-88), which defines a standard API for configuring and deploying J2EE applications and modules into a J2EE-compatible environment. The OC4J implementation includes the ability to create and/or edit a deployment plan containing the OC4J-specific configuration data needed to deploy a component into OC4J.

Support for Oracle Application Server TopLink

Oracle Application Server TopLink is an advanced, object persistence framework for use with a wide range of Java 2 Enterprise Edition (J2EE) and Java application architectures. OracleAS TopLink includes support for the OC4J Container Managed Persistence (CMP) container and base classes that simplify Bean Managed Persistence (BMP) development.

OracleAS Job Scheduler

The OracleAS Job Scheduler provides asynchronous scheduling services for J2EE applications. Its key features include capabilities for submitting, controlling and monitoring jobs, each job defined as a unit of work that executes when the work is performed.

Two-Phase Commit Transaction Coordinator Functionality

The new Distributed Transaction Manager in OC4J can coordinate two-phase transactions between any type of XA resource, including databases from Oracle as well as other vendors and JMS providers such as IBM WebsphereMQ. Automatic transaction recovery in the event of a failure is also supported.

Generic JMS Resource Adapter Enhancements

The Generic JMS Resource Adapter can now be used as an OC4J plug-in for OracleAS JMS that ships with the current version of OC4J as well as for IBM WebsphereMQ JMS version 5.3.

Support for lazy transaction enlistment has been added so that JMS connections can be cached and still be able to correctly participate in global transactions.

Finally, the Generic JMS Resource Adapter now has better error handling. Endpoints now automatically retry after provider or system failures, and onMessage errors are handled correctly.

Support for the Enterprise JavaBeans 3.0

OC4J 10g (10.1.3.1.0) provides complete support for the Enterprise JavaBeans 3.0 final specification, including support for EJB annotations and dependency injections. The final specification is available at the following Web site:

http://java.sun.com/products/ejb/


Note:

OC4J must use JDK 5.0 to enable EJB 3.0 support. This JDK is included with the current 10g (10.1.3.1.0) release, in which OC4J uses JDK 5.0 by default.

You can use following annotations and others in your EJBs:

  • MessageDrivenDeployment

  • StatefulDeployment

  • StatelessDeployment

The Oracle Containers for J2EE Enterprise JavaBeans Developer's Guide describes how to use EJB 3.0 annotations and EJB 3.0 JPA extensions. The Oracle Application Server Annotations Java API Reference provides reference information for EJB 3.0 annotations.

Support for the <library-directory> Element

The <library-directory> element of the application.xml file can be used to specify shared libraries for OC4J instances. Directories specified in this element are scanned for archives to include at OC4J startup.

Information in the OC4J Documentation Set

Most of the location of J2EE subject matter is obvious. For example, you can find out how to implement and use servlets within the Oracle Containers for J2EE Servlet Developer's Guide. Table 1-2 shows each J2EE subject matter and where you can find the information in the OC4J documentation set.

OC4J Installation

OC4J is a lightweight container that is J2EE-compliant. It is configured with powerful and practical defaults and is ready to execute after installation. OC4J is installed with Oracle Application Server; therefore, see the Oracle Application Server Installation Guide for Microsoft Windows for details on OC4J installation.