Oracle JavaServer Pages Developer's Guide and Reference
Release 8.1.7

Part Number A83726-01




Go to next page


Title and Copyright Information

Send Us Your Comments


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
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 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
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
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 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/ Syntax Support
JML Bean References and Expressions, Compile-Time Implementation
Attribute Settings with JML Expressions
JML Compile-Time/ Tag Support
JML Tag Summary, Versus
Descriptions of Additional JML Tags, Compile-Time Implementation


Go to next page
Copyright © 1996-2000, Oracle Corporation.

All Rights Reserved.