Skip Headers

Oracle Application Server Containers for J2EE Servlet Developer's Guide 10g (9.0.4) Part Number B10321-01 |
Home | Contents | Index

#
Preface

This document introduces and explains the Oracle implementation of Java servlet technology, specified by an industry consortium led by Sun Microsystems. It summarizes standard features and covers Oracle implementation details and value-added features. The discussion includes basic servlets, data-access servlets, and servlet filters and event listeners.

Servlet technology is a component of the standard Java 2 Enterprise Edition (J2EE). The J2EE component of the Oracle Application Server is known as the Oracle Application Server Containers for J2EE (OC4J).

The OC4J servlet container in Oracle Application Server 10g (9.0.4) is a complete implementation of the Sun Microsystems Java Servlet Specification, Version 2.3.

This document also provides an overview of OC4J deployment and configuration, with detailed descriptions of key configuration files.

Because this manual is intended for developers, its content is largely targeted for users of the OC4J standalone development environment; however, there is ample consideration of OC4J within an Oracle Application Server production environment.

This preface contains the following sections:

- Audience

- Documentation Accessibility

- Organization

- Related Documentation

- Conventions

## Audience

The guide is intended for J2EE developers who are writing Web applications that use servlets and possibly JavaServer Pages (JSP). It provides the basic information you will need regarding the OC4J servlet container. It does not attempt to teach servlet programming in general, nor does it document the Java Servlet API in detail.

You should be familiar with the current version of the Java Servlet Specification, produced by Sun Microsystems. This is especially true if you are developing a distributable Web application, in which sessions can be replicated to servers running under more than one Java virtual machine (JVM).

Because this is a developer's guide, and development and testing are more convenient in an OC4J standalone environment, key aspects of OC4J standalone are discussed, and the assumption is that most developers will be using a standalone environment at some point in their development.

If you are developing applications that primarily use JavaServer Pages, refer to the Oracle Application Server Containers for J2EE Support for JavaServer Pages Developer's Guide.

## Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

    http://www.oracle.com/accessibility/

##### Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

##### Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

## Organization

This document contains:

##### Chapter 1, "Servlet Overview"

Summarizes servlet technology and servlet development in general, introduces the OC4J servlet container, and provides a simple "Hello World" example.

##### Chapter 2, "Servlet Development"

Describes how the OC4J servlet container supports servlet development and invocation, including a discussion of key development considerations, a summary of servlet SSL features, and related examples. This chapter also introduces the OC4J standalone environment for the development stages.

##### Chapter 3, "Servlet Filters and Event Listeners"

Explains the use of filters to affect servlet input or output, and event listeners to track session and application events and manage resources accordingly. These features were introduced in the servlet 2.3 specification.

##### Chapter 4, "JDBC and EJB Calls from Servlets"

Provides examples for using JDBC calls and EJB calls from servlets.

##### Chapter 5, "Deployment and Configuration Overview"

Discusses how to build and deploy a Web application in OC4J, and provides an overview of files for servlet and Web site configuration. This chapter is primarily useful for OC4J standalone users but also considers Oracle Application Server.

##### Chapter 6, "Configuration File Descriptions"

Documents all the elements and attributes of the `global-web-application.xml` and `orion-web.xml` files for servlet configuration, and the `default-web-site.xml` file (or other Web site XML files) for Web site configuration. This level of detail is primarily useful for OC4J standalone users.

##### Chapter 7, "Configuration with Enterprise Manager"

Shows and describes Oracle Enterprise Manager pages for servlet and Web site configuration for deployment to an Oracle Application Server environment.

##### Appendix A, "Open Source Frameworks and Utilities"

This appendix has instructions for an OC4J standalone environment for installing and running open source framework utilities you can use with OC4J. For the OC4J 9.0.4 implementation, this consists of Struts and log4j from the Apache Jakarta Project.

##### Appendix B, "Third Party Licenses"

This appendix includes the Third Party License for third party products included with Oracle Application Server and discussed in this document.

## Related Documentation

For more information, see the following Oracle resources.

Additional OC4J documents available from the Oracle Java Platform Group:

- Oracle Application Server Containers for J2EE User's Guide

  This book provides some overview and general information for OC4J; primer chapters for servlets, JSP pages, and EJBs; and general configuration and deployment instructions.

- Oracle Application Server Containers for J2EE Stand Alone User's Guide

  This version of the user's guide is specifically for the standalone version of OC4J, and is available when you download the standalone version from OTN. OC4J standalone is used in development environments, but not typically in production environments. (Because a servlet developer will often find it useful to use OC4J standalone during development, considerations for the standalone version are discussed throughout the Oracle Application Server Containers for J2EE Servlet Developer's Guide.)

- Oracle Application Server Containers for J2EE Support for JavaServer Pages Developer's Guide

  This book provides information for JSP developers who want to run their pages in OC4J. It includes a general overview of JSP standards and programming considerations, as well as discussion of Oracle value-added features and steps for getting started in the OC4J environment.

- Oracle Application Server Containers for J2EE JSP Tag Libraries and Utilities Reference

  This book provides conceptual information and detailed syntax and usage information for tag libraries, JavaBeans, and other Java utilities provided with OC4J. There is also a summary of tag libraries from other Oracle product groups.

- Oracle Application Server Containers for J2EE Services Guide

  This book provides information about standards-based Java services supplied with OC4J, such as JTA, JNDI, JMS, JAAS, and the Oracle Application Server Java Object Cache.

- Oracle Application Server Containers for J2EE Security Guide

  This document (not to be confused with the Oracle Application Server 10g Security Guide), describes security features and implementations particular to OC4J. This includes information about using JAAS, the Java Authentication and Authorization Service, as well as other Java security technologies.

- Oracle Application Server Containers for J2EE Enterprise JavaBeans Developer's Guide

  This book provides information about the EJB implementation and EJB container in OC4J.

Also available from the Oracle Java Platform group:

- Oracle9i Java Developer's Guide

- Oracle9i Java Stored Procedures Developer's Guide

- Oracle9i JDBC Developer's Guide and Reference

- Oracle9i SQLJ Developer's Guide and Reference

- Oracle9i JPublisher User's Guide

Available from the Oracle Application Server group:

- Oracle Application Server 10g Administrator's Guide

- Oracle Application Server 10g Security Guide

- Oracle Application Server Certificate Authority Administrator's Guide

- Oracle Application Server 10g Performance Guide

- Oracle Enterprise Manager Concepts

- Oracle HTTP Server Administrator's Guide

- Oracle Application Server 10g Globalization Guide

- Oracle Application Server Web Cache Administrator's Guide

- Oracle Application Server Web Services Developer's Guide

- Oracle Application Server 10g Upgrading to 10g (9.0.4)

Available from the Oracle JDeveloper group:

- Oracle JDeveloper online help

- Oracle JDeveloper documentation on the Oracle Technology Network:

      http://otn.oracle.com/products/jdev/content.html

Available from the Oracle Server Technologies group:

- Oracle XML Developer's Kit Programmer's Guide

- Oracle XML Reference

- Oracle9i Application Developer's Guide - Fundamentals

- Oracle9i Supplied PL/SQL Packages and Types Reference

- PL/SQL User's Guide and Reference

- Oracle9i SQL Reference

- Oracle9i Net Services Administrator's Guide

- Oracle Advanced Security Administrator's Guide

- Oracle9i Database Reference

Printed documentation is available for sale in the Oracle Store at

    http://oraclestore.oracle.com/

To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

    http://otn.oracle.com/membership/

If you already have a user name and password for OTN, then you can go directly to the documentation section of the OTN Web site at

    http://otn.oracle.com/documentation

The following OTN Web site for Java servlets and JavaServer Pages is also available:

    http://otn.oracle.com/tech/java/servlets/

For further servlet information, refer to the Java Servlet Specification, Version 2.3 at the following location:

    http://jcp.org/aboutJava/communityprocess/first/jsr053/index.html

Resources from Sun Microsystems:

- Web site for Java servlet technology, including the latest specifications:

      http://java.sun.com/products/servlet/index.html

- Web site for JavaServer Pages, including the latest specifications:

      http://java.sun.com/products/jsp/index.html

- The servlet API Javadoc:

      http://java.sun.com/products/servlet/2.3/javadoc/index.html

## Conventions

The following conventions are used in this manual:

Convention | Meaning
--- | ---
. . . | Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.
Boldface text | Boldface type in text indicates a GUI component such as a link or button to click.
Italics | Italic typeface indicates book titles or emphasis, or terms that are defined in the text.
`Monospace (fixed-width) font` | Monospace typeface within text indicates items such as executables, file names, directory names, Java class names, Java method names, variable names, other programmatic elements (such as JSP tags or attributes, or XML elements or attributes), or database SQL commands or elements (such as schema names, table names, or column names).
`Italic monospace (fixed-width) font` | Italic monospace font represents placeholders or variables.
[ ] | Brackets enclose optional clauses from which you can choose one or none.
| | A vertical bar represents a choice of two or more options. Enter one of the options. Do not enter the vertical bar.

| Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
Home | Contents | Index