Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 Servlet Overview

• Introduction to Servlets
• Review of Servlet Technology
• Advantages of Servlets
• The Servlet Interface and Request and Response Objects
• Servlets and the Servlet Container
• Introduction to Servlet Sessions
• Introduction to Session Tracking
• Introduction to the HttpSession Interface
• Introduction to Servlet Contexts
• Servlet Context Basics
• How to Obtain a Servlet Context
• Servlet Context Methods
• Introduction to Servlet Configuration Objects
• Introduction to Servlet Filters
• Introduction to Event Listeners
• JSP Pages and Other J2EE Component Types
• A First Servlet Example
• Hello World Code
• Compiling and Deploying the Servlet
• Running the Servlet

2 Servlet Development

• OC4J Standalone for Development
• Overview: Using OC4J Standalone
• Key OC4J Flags for Development
• Removal of tools.jar from OC4J Standalone
• Servlet Development Basics and Key Considerations
• Sample Code Template
• Servlet Lifecycle
• Servlet Preloading
• Servlet Classloading and Application Redeployment
• OC4J Web Application Redeployment and Class Reloading Features
• Loading WAR File Classes Before System Classes in OC4J
• Sharing Cached Java Objects Across OC4J Servlets in Oracle Application Server
• Servlet Information Exchange
• Servlet Includes and Forwards
• Servlet Thread Models and Related Considerations
• Servlet Performance and Monitoring
• General Performance Considerations
• Oracle Application Server Dynamic Monitoring Service
• JDK 1.4 Considerations: Cannot Invoke Classes Not in Packages
• Additional Oracle Features
• OC4J Logging
• OC4J Logs
• Oracle Diagnostic Logging Versus Text-Based Logging
• Additional Oracle Application Server Log Files
• Servlet Debugging
• OC4J Debugging Flags
• Setting OC4J Debugging Flags
• Timing Considerations for Debugging in Oracle Application Server
• Debugging Through JDeveloper and Other IDEs
• Oracle JDeveloper Support for Servlet Development
• Introduction to OC4J Support for Open Source Frameworks
• Servlet Invocation
• Summary of URL Components
• Servlet Invocation by Class Name During OC4J Development
• Servlet Invocation in an Oracle Application Server Production Environment
• Key Features for Invocation in Oracle Application Server
• Use of Perceived Front-End Hosts by OC4J
• Servlet Invocation in an OC4J Standalone Environment
• Servlet Sessions
• Session Tracking
• Overview of Session Tracking
• Cookies
• URL Rewriting
• Other Session Tracking Methods
• Session Tracking in OC4J
• Features of the HttpSession Interface
• Session Cancellation
• Cancellation Through a Timeout
• Cancellation by the Servlet
• Session Replication in a Distributable Application
• Overview of Session Replication and Requirements
• Possible Clustering Error Conditions and Related Environment Flags
• Session Replication Details and Logistics
• Session Servlet Example
• SessionServlet Code
• Deploying and Testing
• Servlet Security
• Use of Security Features
• Using Certificates with OC4J and Oracle HTTP Server
• Requesting Client Authentication
• Configuration of Oracle HTTP Server and OC4J for SSL
• Oracle HTTP Server Configuration Steps for SSL
• OC4J Configuration Steps for SSL
• SSL Common Problems and Solutions
• SSL Common Errors
• General SSL Debugging
• Additional Security Considerations
• Summary of Servlet Best Practices
• Best Practices: General Coding
• Best Practices: Sessions
• Best Practices: Configuration

3 Servlet Filters and Event Listeners

• Servlet Filters
• Overview of Servlet Filters
• How the Servlet Container Invokes Filters
• Filtering of Forward or Include Targets
• Filter Examples
• Filter Example 1
• Filter Example 2
• Filter Example 3
• Event Listeners
• Event Categories and Listener Interfaces
• Typical Event Listener Scenario
• Event Listener Declaration and Invocation
• Event Listener Coding and Deployment Guidelines
• Event Listener Methods and Related Classes
• ServletContextListener Methods, ServletContextEvent Class
• ServletContextAttributeListener Methods, ServletContextAttributeEvent Class
• HttpSessionListener Methods, HttpSessionEvent Class
• HttpSessionAttributeListener Methods, HttpSessionBindingEvent Class
• Event Listener Sample
• Welcome Page: index.jsp
• Deployment Descriptor: web.xml
• Listener Class: SessionLifeCycleEventExample
• Session Creation Servlet: SessionCreateServlet.java
• Session Destruction Servlet: SessionDestroyServlet.java

4 JDBC and EJB Calls from Servlets

• Use of JDBC in Servlets
• Database Query Servlet
• HTML Form
• Servlet Code: GetEmpInfo
• Deployment and Testing of the Database Query Servlet
• EJB Calls from Servlets
• Servlet-EJB Overview
• Servlet-EJB Scenarios
• EJB Local Interfaces Versus Remote Interfaces
• EJB Local Lookup
• Servlet-EJB Application Code for Local Lookup
• Configuration and Deployment for Local Lookup
• Invocation of the Servlet-EJB Application
• EJB Remote Lookup within the Same Application
• Use of the Remote Flag
• Servlet-EJB Application Code for Remote Lookup in the Same Application
• Configuration for Remote Lookup in the Same Application
• EJB Remote Lookup outside the Application
• Servlet-EJB Application Code for Remote Lookup outside the Application
• Configuration and Deployment for Remote Lookup outside the Application

5 Deployment and Configuration Overview

• General Overview of OC4J Deployment and Configuration
• Overview: OC4J Standalone Versus the Oracle Application Server Environment
• Overview of OC4J Deployment Scenarios
• Using Oracle Deployment Tools Versus Expert Modes
• Overview of Configuration Files
• Introduction to OC4J and J2EE Configuration Files
• Summary of Server, Global, and Web Site Configuration Files
• Summary of Application-Level Configuration Files
• OC4J Top-Level Server Configuration File: server.xml
• OC4J and J2EE Application Descriptors
• Standard J2EE Application Descriptors
• OC4J Global Application Descriptor
• OC4J-Specific Application Descriptors
• Summary of Relationships Between Application Descriptors
• OC4J and J2EE Web Descriptors
• Standard J2EE Web Descriptors
• OC4J Global Web Application Descriptor
• OC4J-Specific Web Descriptors
• Summary of Relationships Between Web Descriptors
• OC4J Web Site Descriptors
• Example: Mappings to and from Web Site Descriptors
• Application Packaging
• J2EE Application Structure
• EAR File and WAR File Structures
• Sample EAR and WAR File
• Deployment Scenarios to OC4J Standalone
• Setting Up an Administrative User and Password
• Starting and Stopping OC4J Standalone
• OC4J Default Application and Default Web Application
• Use of the Default Application and Default Web Application
• Configuration of the Default Application and Default Web Application
• Deploying an EAR File to OC4J Standalone
• Using admin.jar to Deploy the EAR File
• Using admin.jar to Bind the Web Application
• Sample Deployment
• Descriptors for Sample Deployment
• Invoking the Sample Application
• Deploying Files into a J2EE Application Structure on OC4J Standalone
• Deploying an Independent WAR File to OC4J Standalone
• Deploying Files into a Web Application Directory Structure on OC4J Standalone
• Using a Web Application Directory Structure in the Default Web Application
• Using a Web Application Directory Structure in an Alternative Web Application
• Application Undeployment or Redeployment in OC4J Standalone
• Using admin.jar to Undeploy an Application
• Using admin.jar to Redeploy an Application
• Manually Redeploying a WAR File
• Triggering Application Redeployment after File Manipulation
• OC4J Deployment in Oracle Application Server
• Overview of OC4J Deployment and Configuration in Oracle Application Server
• OC4J Default Web Application in Oracle Application Server
• Application Undeployment and Redeployment in Oracle Application Server
• Using Enterprise Manager to Undeploy an Application
• Using Enterprise Manager to Redeploy an Application

6 Configuration File Descriptions

• Configuration for global-web-application.xml and orion-web.xml
• Element Descriptions for global-web-application.xml and orion-web.xml
• DTD for global-web-application.xml and orion-web.xml
• Hierarchical Representation of global-web-application.xml and orion-web.xml
• Sample global-web-application.xml Settings
• Configuration for Web Site XML Files
• Element Descriptions for Web Site XML Files
• DTD for Web Site XML Files
• Hierarchical Representation of Web Site XML Files
• Sample default-web-site.xml File

7 Configuration with Enterprise Manager

• Web Module Configuration in Oracle Enterprise Manager 10g
• Application Server Control Console Page Descriptions
• Application Server Control Console OC4J Home Page
• Application Server Control Console OC4J Applications Page
• Application Server Control Console Deploy Application (EAR) Page
• Application Server Control Console Deploy Web Application (WAR) Page
• Application Server Control Console OC4J Administration Page
• Application Server Control Console Website Properties Page
• Application Server Control Console Web Module Page
• Application Server Control Console Web Module Properties Page
• Application Server Control Console Web Module Mappings Page
• Application Server Control Console Web Module Filtering and Chaining Page
• Application Server Control Console Web Module Environment Page
• Application Server Control Console Web Module Advanced Properties Page

A Open Source Frameworks and Utilities

• Configuration and Use of Jakarta Struts in OC4J
• Overview of Jakarta Struts
• Downloading the Struts Binary Distribution
• Unpacking the Struts Binary Distribution
• Installing and Accessing Struts Documentation
• Installing the Struts Sample Web Application
• Deploying Your Own Application with the Struts Framework
• Configuration and Use of Jakarta log4j in OC4J
• Overview of Jakarta log4j
• Downloading the log4j Binary Distribution
• Unpacking the log4j Binary Distribution
• Installing the log4j Library
• Use the log4j Library at a Global Application Level
• Package the log4j Library as a Web Application Library
• Package the log4j Library as a Shared Library for EJB and Web Applications
• Using log4j Configuration Files
• Use the Default Files for Automatic log4j Configuration
• Use Alternative Files for Automatic log4j Configuration
• Programmatically Specify External Configuration Files
• Enabling log4j Debug Mode

B Third-Party Licenses

• Apache HTTP Server
• The Apache Software License

Index