Oracle JavaServer Pages Developer's Guide and Reference
Release 8.1.7
Part Number A83726-01

Contents

Title and Copyright Information

Send Us Your Comments

Preface

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

Scripting Elements

JSP Objects and Scopes

JSP Actions and the <jsp: > Tag Set

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 Oracle Servlet Engine (OSE)

Overview of the Oracle Internet Application Server

Role of the Oracle HTTP Server, Powered by Apache

Oracle Web Application Database 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

Summary of OracleJSP Releases and Feature Sets

OracleJSP Releases Provided with Oracle Platforms

OracleJSP Feature Notes for Release 1.0.0.6.x

OracleJSP Execution Models

On-Demand Translation Model

Oracle 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 Database 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 Considerations (Non-OSE Only)

Dynamic Page Retranslation

Dynamic Page Reloading

Dynamic Class Reloading

Considerations for the Oracle Servlet Engine

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

JServer Connections

Use of JNDI by the Oracle Servlet Engine

Equivalent Code for OracleJSP Runtime Configuration Parameters

Considerations for Apache/JServ Servlet Environments

Use of Apache/JServ in the Oracle Internet 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 Database-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

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 Oracle8i

Database Schema Objects for Java

Oracle HTTP Server as a Front-End Web Server

URLs for the Oracle Servlet Engine

Static Files for JSP Applications in the Oracle Servlet Engine

Server-Side Versus Client-Side Translation

Overview of Hotloaded Classes in Oracle8i

Tools and Commands for Translation and Deployment to Oracle8i

The ojspc Pre-Translation Tool

Overview of the loadjava Tool

Overview of the sess_sh Session Shell Tool

Deployment to Oracle8i with Server-Side Translation

Loading Untranslated JSP Pages into Oracle8i (loadjava)

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

Deployment to Oracle8i with Client-Side Translation

Pre-Translating JSP Pages (ojspc)

Loading Translated JSP Pages into Oracle8i (loadjava)

Hotloading Page Implementation Classes in Oracle8i

Publishing Translated JSP Pages in Oracle8i (Session Shell publishservlet)

Additional JSP Deployment Considerations

Doc Root for Oracle Internet Application Server Versus Oracle Servlet Engine

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

General JSP Pre-Translation Without Execution

Deployment of Binary Files Only

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

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 OracleJSP NLS Support

Content Type Settings in the page Directive

Dynamic Content Type Settings

OracleJSP Extended Support for Multibyte Parameter Encoding

Effect of translate_params in Overriding Non-Multibyte Servlet Containers

Code Equivalent to the translate_params Configuration Parameter

NLS Sample Depending on translate_params

NLS Sample Not Depending on translate_params

9 Sample Applications

Basic Samples

Hello Page--hellouser.jsp

Usebean Page--usebean.jsp

Shopping Cart Page--cart.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

Database-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

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.0.0.0/Runtime

Descriptions of Additional JML Tags, Compile-Time Implementation

Index

Oracle

Copyright © 1996-2000, Oracle Corporation.
All Rights Reserved.