Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Structure

Related Documents

Additional Resources

Conventions

Documentation Accessibility

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 Oracle's JSP Implementation

Portability and Functionality Across Servlet Environments

OracleJSP Portability

OracleJSP Extended Functionality for Servlet 2.0 Environments

Support for OracleJSP in Oracle Environments

Overview of the Oracle9i Servlet Engine (OSE)

Overview of the Oracle9i Application Server

Role of the Oracle HTTP Server, Powered by Apache

Oracle Web Application Data-Access Strategies

Overview of Other Oracle JSP Environments

Support for OracleJSP in Non-Oracle Environments

Overview of OracleJSP Programmatic Extensions

Overview of Portable OracleJSP Extensions

Overview of Oracle-Specific Extensions

Use of OracleJSP with Oracle PL/SQL Server Pages

Overview of Oracle Caching Support for Web Applications

Oracle9i Application Server and OracleJSP Caching Features

Role of the OracleJSP Web Object Cache

Summary of OracleJSP Releases and Feature Sets

OracleJSP Releases Provided with Oracle Platforms

OracleJSP Feature Notes for Previous Releases

OracleJSP Execution Models

On-Demand Translation Model

Oracle9i Servlet Engine Pre-Translation Model

Oracle JDeveloper Support for OracleJSP

3 Basics

Preliminary Considerations

Installation and Configuration Overview

Development Environments Versus Deployment Environments

Client-Side Considerations

Application Root and Doc Root Functionality

Application Roots in Servlet 2.2 Environments

OracleJSP Application Root Functionality in Servlet 2.0 Environments

Overview of JSP Applications and Sessions

General OracleJSP Application and Session Support

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--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 Enterprise JavaBeans in JSP Pages

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

Key OracleJSP Configuration Issues

Optimization of JSP Execution

Classpath and Class Loader Issues (Non-OSE Only)

OracleJSP Runtime Page and Class Reloading (Non-OSE Only)

Dynamic Page Retranslation

Dynamic Page Reloading

Dynamic Class Reloading

Considerations for the Oracle9i Servlet Engine

Introduction to the Oracle JVM and JDBC Server-Side Internal Driver

Database Connections Through Java

Use of JNDI by the Oracle9i Servlet Engine

Equivalent Code for OracleJSP Runtime Configuration Parameters

Considerations for Apache/JServ Servlet Environments

Use of Apache/JServ in the Oracle9i Application Server

Dynamic Includes and Forwards in Apache/JServ

Application Framework for Apache/JServ

JSP and Servlet Session Sharing

Directory Alias Translation

5 OracleJSP Extensions

Portable OracleJSP Programming Extensions

JML Extended Datatypes

OracleJSP Support for XML and XSL

Oracle Data-Access JavaBeans

OracleJSP Tag Library for SQL

Oracle-Specific Programming Extensions

OracleJSP Event Handling--JspScopeListener

OracleJSP Support for Oracle SQLJ

OracleJSP Application and Session Support for Servlet 2.0

Overview of globals.jsa Functionality

Overview of globals.jsa Syntax and Semantics

The globals.jsa Event Handlers

Global Declarations and Directives

6 JSP Translation and Deployment

Functionality of the OracleJSP 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

Overview of Features and Logistics in Deployment to Oracle9i

Database Schema Objects for Java

Oracle HTTP Server as a Front-End Web Server

URLs for the Oracle9i Servlet Engine

Static Files for JSP Applications in the Oracle9i Servlet Engine

Server-Side Versus Client-Side Translation

Overview of Hotloaded Classes in Oracle9i

Tools and Commands for Translation and Deployment to Oracle9i

The ojspc Pre-Translation Tool

Overview of the loadjava Tool

Overview of the sess_sh Session Shell Tool

Deployment to Oracle9i with Server-Side Translation

Loading Untranslated JSP Pages into Oracle9i (loadjava)

Translating and Publishing JSP Pages in Oracle9i (Session Shell publishjsp)

Deployment to Oracle9i with Client-Side Translation

Pre-Translating JSP Pages (ojspc)

Loading Translated JSP Pages into Oracle9i (loadjava)

Hotloading Page Implementation Classes in Oracle9i

Publishing Translated JSP Pages in Oracle9i (Session Shell publishservlet)

Additional JSP Deployment Considerations

Doc Root for Oracle9i Application Server Versus Oracle9i Servlet Engine

Use of ojspc for Pre-Translation for Non-OSE Environments

General JSP Pre-Translation Without Execution

Deployment of Binary Files Only

WAR Deployment

Deployment of JSP Pages with JDeveloper

7 JSP Tag Libraries and the Oracle JML Tags

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

Overview of the JSP Markup Language (JML) Sample Tag Library

JML Tag Library Philosophy

JML Tag Categories

JML Tag Library Description File and taglib Directive

JSP Markup Language (JML) Tag Descriptions

Syntax Symbology and Notes

Bean Binding Tag Descriptions

Logic and Flow Control Tag Descriptions

8 JESI Tags for Edge Side Includes

Overview of Edge Side Includes Technology and Processing

Edge Side Includes Technology

Oracle Web Cache and ESI Processor

Overview of JESI Functionality

Motivation for JESI Tags

Overview of JESI Tags Implemented by OracleJSP

JESI Usage Models

Page Invalidation

Page Personalization

OracleJSP JESI Tag Descriptions

Syntax Symbology and Notes

Page Setup and Content Tag Descriptions

Page Invalidation Tag and Subtag Descriptions

Page Personalization Tag Description

JESI Tag Handling and JESI-to-ESI Conversion

OracleJSP JESI Tag Library Description File

9 Web Object Cache Tags and API

Overview of the Web Object Cache

Benefits of the Web Object Cache

Web Object Cache Components

Cache Policy and Scope

Key Functionality of the Web Object Cache

Cache Block Naming--Implicit Versus Explicit

Cloneable Cache Objects

Cache Block Runtime Functionality

Data Invalidation and Expiration

Attributes for Policy Specification and Use

Cache Policy Attributes

Expiration Policy Attributes

Web Object Cache Tag Descriptions

Syntax Symbology and Notes

Cache Tag Descriptions

Cache Invalidation Tag Description

Web Object Cache Tag Library Description File

Web Object Cache Servlet API Description

Cache Policy Object Creation

CachePolicy Methods

Expiration Policy Object Retrieval

ExpirationPolicy Methods

CacheBlock Methods

Sample Servlet Using the Web Object Cache API

Cache Policy Descriptor

Cache Policy Descriptor DTD

Sample Cache Policy Descriptor

Cache Policy Descriptor Loading and Refreshing

Cache Repository Descriptor

Cache Repository Descriptor DTD

Sample Cache Repository Descriptor

10 OracleJSP Globalization Support

Content Type Settings in the page Directive

Dynamic Content Type Settings

OracleJSP Extended Support for Multibyte Parameter Encoding

The setReqCharacterEncoding() Method

The translate_params Configuration Parameter

11 Sample Applications

Basic Samples

Hello Page--hellouser.jsp

Usebean Page--usebean.jsp

Shopping Cart Page--cart.jsp

Information Page--info.jsp

JDBC Samples

Simple Query--SimpleQuery.jsp

User-Specified Query--JDBCQuery.jsp

Query Using a Query Bean--UseHtmlQueryBean.jsp

Connection Caching--ConnCache3.jsp and ConnCache1.jsp

Data-Access JavaBean Samples

Page Using DBBean--DBBeanDemo.jsp

Page Using ConnBean--ConnBeanDemo.jsp

Page Using CursorBean--CursorBeanDemo.jsp

Page Using ConnCacheBean--ConnCacheBeanDemo.jsp

Custom Tag Samples

JML Tag Sample--hellouser_jml.jsp

Pointers to Additional Custom Tag Samples

Samples for Oracle-Specific Programming Extensions

Page Using JspScopeListener--scope.jsp

XML Query--XMLQuery.jsp

SQLJ Queries--SQLJSelectInto.sqljsp and SQLJIterator.sqljsp

JESI Tag Sample--Portal Demo

Portal Demo Explanation

Portal Demo Source Code

Samples for the Web Object Cache

Web Object Cache--Using Oracle9iAS Object Caching Service for Java

Web Object Cache--Using a File System Cache

Web Object Cache--Caching XML DOM Objects

Web Object Cache--Caching Generic Java Objects

Web Object Cache--Tag Code Versus API Code

Samples Using globals.jsa for Servlet 2.0 Environments

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

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

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

A General Installation and Configuration

System Requirements

OracleJSP Installation and Web Server Configuration

Required and Optional Files for OracleJSP

Configuration of Web Server and Servlet Environment to Run OracleJSP

OracleJSP Configuration

OracleJSP Configuration Parameters (Non-OSE)

OracleJSP Configuration Parameter Settings

B 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

C Compile-Time JML Tag Support

JML Compile-Time Versus Runtime Considerations and Logistics

General Compile-Time Versus Runtime Considerations

The taglib Directive for Compile-Time JML Support

JML Compile-Time/1.0.0.6.x Syntax Support

JML Bean References and Expressions, Compile-Time Implementation

Attribute Settings with JML Expressions

JML Compile-Time/1.0.0.6.x Tag Support

JML Tag Summary, 1.0.0.6.x/Compile-Time Versus 1.1.x.x/Runtime

Descriptions of Additional JML Tags, Compile-Time Implementation