Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Organization

Related Documentation

Conventions

1 General JSP Overview

Introduction to JavaServer Pages

What a JSP Page Looks Like

Convenience of JSP Coding Versus Servlet Coding

Separation of Business Logic from Page Presentation--Calling JavaBeans

JSP Pages and Alternative Markup Languages

Overview of JSP Syntax Elements

Directives

Scripting Elements

JSP Objects and Scopes

JSP Actions and the <jsp: > Tag Set

Tag Libraries

JSP Execution

JSP Containers in a Nutshell

JSP Execution Models

JSP Pages and On-Demand Translation

Requesting a JSP Page

2 Overview of the Oracle JSP Implementation

Overview of the Oracle9i Application Server and JSP Support

Overview of the Oracle9i Application Server

Overview of OC4J

Overview of the JSP Implementation in OC4J

Role of the Oracle HTTP Server and mod_oc4j

Oracle JDeveloper JSP Support

Overview of Oracle Value-Added Features

Overview of Tag Libraries and Utilities Provided with OC4J

Overview of Oracle-Specific Features

Overview of Tags and API for Caching Support

3 Getting Started

Key Support Files Provided with OC4J

JSP Configuration in OC4J

JSP Container Setup

JSP Configuration Parameters

Key OC4J Configuration Files

Some Initial Considerations

Application Root Functionality

Classpath Functionality

4 Basic Programming Issues

JSP-Servlet Interaction

Invoking a Servlet from a JSP Page

Passing Data to a Servlet Invoked from a JSP Page

Invoking a JSP Page from a Servlet

Passing Data Between a JSP Page and a Servlet

JSP-Servlet Interaction Samples

JSP Resource Management

Standard Session Resource Management--HttpSessionBindingListener

Overview of Oracle Value-Added Features for Resource Management

JSP Runtime Error Processing

Using JSP Error Pages

JSP Error Page Example

JSP Starter Sample for Data Access

Introduction to JSP Support for Data Access

Data Access Sample

5 Key Considerations

General JSP Programming Strategies, Tips, and Traps

JavaBeans Versus Scriptlets

Static Includes Versus Dynamic Includes

When to Consider Creating and Using JSP Tag Libraries

Use of a Central Checker Page

Workarounds for Large Static Content in JSP Pages

Method Variable Declarations Versus Member Variable Declarations

Page Directive Characteristics

JSP Preservation of White Space and Use with Binary Data

JSP Data-Access Considerations and Features

Use of JDBC Performance Enhancement Features

EJB Calls from JSP Pages

JSP Support for Oracle SQLJ

Oracle XML Support

JSP Runtime Considerations and Optimization

Dynamic Page Retranslation and Class Reloading

Additional Optimization Considerations

6 JSP Translation and Deployment

Functionality of the JSP Translator

Generated Code Features

General Conventions for Output Names

Generated Package and Class Names

Generated Files and Locations

Oracle JSP Global Includes

The ojspc Pre-Translation Utility

Overview of ojspc Functionality

Option Summary Table for ojspc

Command-Line Syntax for ojspc

Option Descriptions for ojspc

Summary of ojspc Output Files, Locations, and Related Options

JSP Deployment Considerations

Overview of EAR/WAR Deployment

Application Deployment with Oracle9i JDeveloper

JSP Pre-Translation

Deployment of Binary Files Only

7 JSP Tag Libraries

Standard Tag Library Framework

Overview of a Custom Tag Library Implementation

Tag Handlers

Scripting Variables and Tag-Extra-Info Classes

Access to Outer Tag Handler Instances

Tag Library Description Files

Use of web.xml for Tag Libraries

The taglib Directive

End-to-End Example: Defining and Using a Custom Tag

OC4J JSP Tag Handler Features

Disabling or Enabling Tag Handler Instance Pooling

Tag Handler Code Generation

Compile-Time Tags

General Compile-Time Versus Runtime Considerations

JSP Compile-Time Versus Runtime JML Library

8 JSP Globalization Support

Content Type Settings

Content Type Settings in the page Directive

Dynamic Content Type Settings

Oracle Extension for the Character Set of the JSP Writer Object

JSP Support for Multibyte Parameter Encoding

Standard setCharacterEncoding() Method

Overview of Oracle Extensions for Older Servlet Environments

A Servlet and JSP Technical Background

Background on Servlets

Review of Servlet Technology

The Servlet Interface

Servlet Containers

Servlet Sessions

Servlet Contexts

Application Lifecycle Management Through Event Listeners

Servlet Invocation

Web Application Hierarchy

Standard JSP Interfaces and Methods

B The Apache JServ Environment

Getting Started in a JServ Environment

Adding Files to the Apache JServ Web Server Classpath

Mapping JSP File Name Extensions for JServ

JSP Configuration Parameters for JServ

Setting JSP Parameters in JServ

Using ojspc for JServ

Considerations for the JServ Environment

The mod_jserv Apache Mod

JSP Container Features for Application Root Support in JServ

Overview of Application and Session Framework for JServ

JSP and Servlet Session Sharing in JServ

Dynamic Includes and Forwards in JServ

JServ Directory Alias Translation

Multibyte Parameter Encoding in JServ

JSP Application and Session Support for JServ

Overview of globals.jsa Functionality

Overview of globals.jsa Syntax and Semantics

The globals.jsa Event-Handlers

Global Declarations and Directives

Migration from globals.jsa

Samples Using globals.jsa for Servlet 2.0 Environments

A globals.jsa Example for Application Events--lotto.jsp

A globals.jsa Example for Application and Session Events--index1.jsp

A globals.jsa Example for Global Declarations--index2.jsp

C Third Party Licenses

Apache HTTP Server

The Apache Software License

Apache JServ

Apache JServ Public License

Index