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 Release 2 (10.1.2) is a complete implementation of the Sun Microsystems Java Servlet Specification, Version 2.3.

This preface contains the following sections:

• Audience

• Documentation Accessibility

• 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).

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. Accessibility standards will continue to evolve over time, and Oracle 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 more information, visit the Oracle Accessibility Program Web site at

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

Accessibility of Code Examples in Documentation

Screen readers 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, some screen readers 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 does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

Related Documentation

For more information, see the following Oracle resources.

Additional OC4J documents:

• 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.

• Oracle Application Server Containers for J2EE Servlet Developer's Guide

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

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

  This book provides information about JavaServer Pages development and the JSP implementation and container in OC4J. This includes discussion of Oracle features such as the command-line translator and OC4J-specific configuration parameters.

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

  This book provides conceptual information as well as 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 Enterprise JavaBeans development and the EJB implementation and container in OC4J.

Oracle Application Server TopLink documents:

• Oracle Application Server TopLink Getting Started Guide

• Oracle Application Server TopLink Mapping Workbench User's Guide

• Oracle Application Server TopLink Application Developer's Guide

Java-related documents for Oracle Database:

• Oracle Database Java Developer's Guide

• Oracle Database JDBC Developer's Guide and Reference

• Oracle Database JPublisher User's Guide

Additional Oracle Application Server documents:

• Oracle Application Server Administrator's Guide

• Oracle Application Server Security Guide

• Oracle Application Server Certificate Authority Administrator's Guide

• Oracle Application Server Performance Guide

• Oracle Enterprise Manager Concepts

• Oracle HTTP Server Administrator's Guide

• Oracle Application Server Globalization Guide

• Oracle Application Server Web Cache Administrator's Guide

• Oracle Application Server Web Services Developer's Guide

• Oracle Application Server High Availability Guide

• Oracle Application Server Upgrade and Compatibility Guide

Oracle JDeveloper documentation:

• Oracle JDeveloper online help

• Oracle JDeveloper documentation on the Oracle Technology Network:

  http://www.oracle.com/technology/products/jdev/index.html
  
  

Additional Oracle Database documents:

• Oracle XML Developer's Kit Programmer's Guide

• Oracle XML API Reference

• Oracle Database Application Developer's Guide - Fundamentals

• PL/SQL Packages and Types Reference

• PL/SQL User's Guide and Reference

• Oracle Database SQL Reference

• Oracle Database Net Services Administrator's Guide

• Oracle Advanced Security Administrator's Guide

• Oracle Database Reference

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

http://www.oracle.com/technology/tech/java/servlets/index.html

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.jsp
  
  

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

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

• The servlet API Javadoc:

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

Conventions

The following text conventions are used in this document: