Oracle® Application Server Containers for J2EE Servlet Developer's Guide
10g Release 2 (10.1.2) Part No. B14017-01 |
|
Previous |
Next |
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:
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.
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 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 does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
This document contains:
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 version 2.3 of the servlet 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 10g pages for servlet and Web site configuration for deployment to an Oracle Application Server environment.
Appendix A, "Open Source Frameworks and Utilities"
Provides instructions for an OC4J standalone environment for installing and running open source framework utilities you can employ with OC4J. For the OC4J 10.1.2 implementation, this consists of Struts and log4j from the Apache Jakarta Project.
Appendix B, "Third-Party Licenses"
Contains the Third-Party License for third-party products included with Oracle Application Server and discussed in this document.
For more information, see the following Oracle resources.
Additional OC4J documents:
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 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 Certificate Authority Administrator's Guide
Oracle Application Server Upgrading to 10g Release 2 (10.1.2)
Oracle JDeveloper documentation:
Oracle JDeveloper online help
Oracle JDeveloper documentation on the Oracle Technology Network:
http://www.oracle.com/technology/products/jdev/content.html
Additional Oracle Database documents:
Oracle XML Developer's Kit Programmer's Guide
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
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, visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and of charge can be done at:
http://www.oracle.com/technology/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://www.oracle.com/technology/documentation
The following OTN Web site for Java servlets and JavaServer Pages is also available:
http://www.oracle.com/technology/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
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. |