Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Organization

Related Documentation

Conventions

1 General 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

JSP Execution

JSP Containers in a Nutshell

JSP Pages and On-Demand Translation

Requesting a JSP Page

Overview of JSP Syntax Elements

Directives

Scripting Elements

JSP Objects and Scopes

JSP Actions and the <jsp: > Tag Set

Tag Libraries

2 Overview of the Oracle JSP Implementation

Overview of JSP and Servlet Containers and Web Server with Oracle9i

JSP Container and Servlet Environment Provided with Oracle9i

Other Servlet Environments

Role of the Oracle HTTP Server

Portability and Functionality Across Servlet Environments

Oracle JSP Portability

Oracle JSP Extended Functionality for Servlet 2.0 Environments

Oracle9i JDeveloper Support for the Oracle JSP Container

Support for the Oracle JSP Container in Non-Oracle Environments

Overview of Oracle JSP Programmatic Extensions

Overview of Oracle-Specific Extensions

Overview of JSP Tag Libraries and JavaBeans Provided with Oracle9i

JSP Execution Models

On-Demand Translation Model

Pre-Translation Model

3 Basics

Application Root and Doc Root Functionality

Application Roots in Servlet 2.2 Environments

Oracle Implementation of Application Root Functionality in Servlet 2.0 Environments

Overview of JSP Applications and Sessions

General Application and Session Support in the Oracle JSP Container

JSP Default Session Requests

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 with HttpSessionBindingListener

Overview of Oracle Extensions for Resource Management

JSP Runtime Error Processing

Using JSP Error Pages

JSP Error Page Example

JSP Starter Sample for Data Access

4 Key Considerations

General JSP Programming Strategies, Tips, and Traps

JavaBeans Versus Scriptlets

Use of JDBC Performance Enhancement Features

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

Oracle XML Support

Key JSP Configuration Issues

Optimization of JSP Execution

Classpath and Class Loader Issues

Oracle JSP Runtime Page and Class Reloading

Dynamic Page Retranslation

Dynamic Page Reloading

Dynamic Class Reloading

5 Oracle-Specific Programming Extensions

Oracle JSP Event Handling with JspScopeListener

Oracle JSP Support for Oracle SQLJ

SQLJ JSP Code Example

Triggering the SQLJ Translator

Setting Oracle SQLJ Options

6 JSP Translation and Deployment

Functionality of the Oracle JSP Translator

Generated Code Features

General Conventions for Output Names

Generated Package and Class Names (On-Demand Translation)

Generated Files and Locations (On-Demand Translation)

Sample Page Implementation Class Source

JSP Pre-Translation and the ojspc Utility

General Use of ojspc for Pre-Translation

Details of the ojspc Pre-Translation Tool

Additional JSP Deployment Considerations

General JSP Pre-Translation Without Execution

Deployment of Binary Files Only

Deployment of JSP Pages with Oracle9i JDeveloper

Doc Root for JServ

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

Compile-Time Tags

General Compile-Time Versus Runtime Considerations

Oracle JML Library: Compile-Time Versus Runtime

8 Oracle JSP Globalization Support

Content Type Settings in the page Directive

Dynamic Content Type Settings

Oracle JSP Extended Support for Multibyte Parameter Encoding

The setReqCharacterEncoding() Method

The translate_params Configuration Parameter

9 Oracle JSP in Apache JServ

Getting Started in a JServ Environment

Required and Optional Files for Oracle JSP

Adding Files to the JServ Web Server Classpath

Mapping JSP File Name Extensions for JServ

Oracle JSP Configuration Parameters

Setting JSP Parameters in JServ

Considerations for JServ Servlet Environments

Dynamic Includes and Forwards in JServ

Application Framework for JServ

JSP and Servlet Session Sharing

Directory Alias Translation

Oracle 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

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

A Getting Started in Alternative Environments

Configuration of Web Server and Servlet Environment for Oracle JSP

Adding Oracle JSP-Related JAR and ZIP Files to Web Server Classpath

Mapping JSP File Name Extensions to Oracle JspServlet

Oracle JSP Configuration Parameter Settings

Setting Oracle JSP Parameters in JSWDK

Setting Oracle JSP Parameters in Tomcat

B Third Party Licenses

Apache HTTP Server

The Apache Software License

Apache JServ

Apache JServ Public License

Index