Skip Headers

Oracle Application Server Containers for J2EE Servlet Developer's Guide
10g (9.0.4)

Part Number B10321-01
Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page


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

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:

Also available from the Oracle Java Platform group:

Available from the Oracle Application Server group:

Available from the Oracle JDeveloper group:

Available from the Oracle Server Technologies group:

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:

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.


Go to previous page Go to next page
Oracle
Copyright © 2002, 2003 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index