Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Related Documents

1 Overview of Tag Libraries and Utilities

Overview of Tag Libraries and Utilities Provided with OC4J

Tag Syntax Symbology and Notes

Overview of Extended Type JavaBeans

Overview of JspScopeListener for Event-Handling

Overview of Integration with XML and XSL

Summary of Data-Access JavaBeans and Tag Library

Summary of JSP Markup Language (JML) Custom Tag Library

Summary of Web Services Tags

Summary of File Access and Mail Tags

Summary of EJB Tags

Summary of JSP Utility Tags

Summary of Oracle Caching Support for Web Applications

Oracle Application Server and JSP Caching Features

Role of the JSP Web Object Cache

Web Object Cache Versus OracleAS Web Cache

Web Object Cache Versus Oracle Application Server Java Object Cache

Summary of Tag Libraries for Caching

Summary of JESI Tag Library

Summary of Web Object Cache Tag Library

Support for the JavaServer Pages Standard Tag Library

Overview and Philosophy of JSTL

Summary of JSTL Expression Language

JSTL Expression Language Syntax

JSTL Expression Language Implicit Objects

JSTL Expression Language Additional Features

Overview of JSTL Tags and Additional Features

Scoped Variables

Configuration Data and the Config Class

JSTL Tag Summary

JSTL Usage Notes and Future Considerations

Overview of Tag Libraries from Other Oracle Components

Oracle ADF Business Components Tag Library

Oracle JDeveloper User Interface Extension (UIX) Tag Library

Oracle ADF Business Components UIX Tag Library

Oracle Application Server Wireless Location Tag Library

Oracle Application Server MapViewer Tag Library

Oracle Ultra Search Tag Library

Oracle Application Server Portal Tag Library

Oracle Business Intelligence Beans Tag Library

Oracle Application Server Multimedia Tag Library

2 JavaBeans for Extended Types

Overview of JML Extended Types

JML Extended Type Descriptions

Type JmlBoolean

Type JmlFPNumber

JML Extended Types Example

3 JSP Markup Language Tags

Overview of the JSP Markup Language (JML) Tag Library

JML Tag Library Philosophy

JML Tag Categories

JSP Markup Language (JML) Tag Descriptions

Bean Binding Tag Descriptions

JML useVariable Tag

JML useForm Tag

JML useCookie Tag

Logic and Flow Control Tag Descriptions

JML choose...when...[otherwise] Tags

JML foreach Tag

4 Data-Access JavaBeans and Tags

JavaBeans for Data Access

Introduction to Data-Access JavaBeans

Data-Access Support for Data Sources and Pooled Connections

Data-Access JavaBean Descriptions

ConnBean for a Database Connection

ConnCacheBean for Connection Caching

DBBean for Queries Only

CursorBean for DML and Stored Procedures

Example: Using ConnBean and CursorBean with a Data Source

SQL Tags for Data Access

Introduction to Data-Access Tags

Data-Access Tag Descriptions

SQL dbClose Tag

SQL dbQuery Tag

SQL dbCloseQuery Tag

SQL dbNextRow Tag

SQL dbExecute Tag

SQL dbSetParam Tag

SQL dbSetCookie Tag

Example: Using dbOpen and dbQuery with a Data Source

5 XML and XSL Tag Support

Overview of Oracle Tags for XML Support

XML Producers and XML Consumers

Summary of OC4J Tags with XML Functionality

XML Utility Tags

XML Utility Tag Descriptions

XML transform and styleSheet Tags for XML/XSL Data Transformation

XML parsexml Tag to Convert from Input Stream

XML Utility Tag Examples

Example Using the transform Tag

Example Using the transform and dbQuery Tags

Examples Using the transform and parsexml Tags

6 JESI Tags for Edge Side Includes

Overview of Edge Side Includes Technology and Processing

Edge Side Includes Technology

Introduction to ESI

More About Surrogates

Key ESI Features

Oracle Application Server Web Cache and ESI Processor

Introduction to Oracle Application Server Web Cache

Steps in Oracle Application Server Web Cache Usage

Oracle Application Server Web Cache ESI Processor

Overview of JESI Functionality

Advantages of JESI Tags

Overview of JESI Tags Implemented by Oracle

JESI Usage Models

Control/Include Model

Template/Fragment Model

Notes About JESI and JSP Includes

Invalidation of Cached Objects

Personalization of Cached Pages

JESI Fallback Execution

Oracle JESI Tag Descriptions

Descriptions of Tags for Dynamic Caching

JESI control Tag

JESI include Tag

Examples: Control/Include Model

JESI template Tag

JESI fragment Tag

JESI codeblock Tag

Examples: Template/Fragment Model

Descriptions of Tags and Subtags for Invalidation of Cached Objects

JESI invalidate Tag

JESI Configuration File

JESI object Subtag

JESI cookie Subtag

JESI header Subtag

Examples: Page Invalidation

Description of Tag for Page Personalization

JESI personalize Tag

Example: Page Personalization

JESI Tag Handling and JESI-to-ESI Conversion

Example: JESI-to-ESI Conversion for Included Pages

Example: JESI-to-ESI Conversion for a Template and Fragment

7 Web Object Cache Tags and API

Overview of the Web Object Cache

Benefits of the Web Object Cache

Web Object Cache Components

Cache Repository

Cache Programming Interfaces

Cache Policy and Scope

Key Functionality of the Web Object Cache

Cache Block Naming: Implicit Versus Explicit

Cloneable Cache Objects

Memory-Oriented Repositories Versus Secondary Storage Repositories

Advantages in Cloning Copies of Cache Objects

Use of the CloneableCacheObject Interface

Cache Block Runtime Functionality

Data Invalidation and Expiration

Cache Block Expiration

Cache Block Invalidation

Attributes for Policy Specification and Use

Cache Policy Attributes

Cache Policy Attribute Descriptions

More About Cache Block Naming and the autoType Attribute

More About reusableTimeStamp and reusableDeltaTime

Expiration Policy Attributes

Web Object Cache Tag Descriptions

Cache Tag Descriptions

Web Object Cache cache Tag

Web Object Cache cacheXMLObj Tag

Web Object Cache useCacheObj Tag

Conditional Execution of Code Inside the Cache Tags

Web Object Cache cacheInclude Tag

Cache Invalidation Tag Description

Web Object Cache invalidateCache Tag

Example: Use of Cache Invalidation Tag

Web Object Cache API Descriptions

Cache Policy Object Creation

Using the lookupPolicy() Method

Using a CachePolicy Constructor

CachePolicy Methods

CachePolicy Method Signatures and Common Parameters

CachePolicy Method Descriptions

CachePolicy Getter and Setter Methods

Expiration Policy Object Retrieval

ExpirationPolicy Methods

CacheBlock Methods

Tag Code Versus API Code

Simple JSP Page: tagcode.jsp

Scriptlet JSP Page: servletcode.jsp

Servlet Page: DemoCacheServlet.java

Cache Policy Descriptor: test-policy.cpd

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

Configuration for Back-End Repository

Configuration Notes for Oracle Application Server Java Object Cache

Configuration Notes for File System Cache

8 File Access and Mail Beans and Tags

File-Access JavaBeans and Tags

Overview of OC4J File-Access Functionality

Overview of File Uploading

Overview of File Downloading

File Upload and Download JavaBean and Class Descriptions

The HttpUploadBean

The HttpDownloadBean

The Download Servlet

FileAccessException Class

File Upload and Download Tag Descriptions

The httpUploadForm Tag

The httpUpload Tag

The httpDownload Tag

Mail JavaBean and Tag

General Considerations for the Mail JavaBean and Tag

Mail Attachments

Enabling Attachments

Sending Attachments

Attachment Usage Notes

SendMailBean Description

SendMailBean Requirements

SendMailBean Method Descriptions

The sendMail Tag Description

The sendMail Tag Syntax

The sendMail Tag Attribute Descriptions

Sample Application for sendMail Tag

9 JSP Utilities and Utility Tags

JSP Event-Handling with JspScopeListener

General Use of JspScopeListener

Use of JspScopeListener in OC4J and Other Servlet 2.3 Environments

Requirements for JspScopeListener

Runtime and Tag Implementations to Support Page Scope

Servlet Filter Implementation to Support Request Scope

Listener Class Implementation to Support Application Scope

Integration with HttpSessionBindingListener to Support Session Scope

Examples Using JspScopeListener

Example: JSP Page Using JspScopeListener

Example: Servlet Using JspScopeListener

EJB Tag Configuration

EJB Tag Descriptions

EJB useHome Tag

EJB useBean Tag

EJB createBean Tag

EJB iterate Tag

EJB Tag Examples

EJB Tag Session Bean Example

EJB Tag Entity Bean Example

General Utility Tags

Utility displayCurrency Tag

Utility displayDate Tag

Utility displayNumber Tag

Miscellaneous Utility Tags

Utility iterate Tag

Utility ifInRole Tag

Utility lastModified Tag

10 Web Services Tags

Overview of Web Services

General Web Services Overview

Overview of SOAP and Related Features

Overview of Web Services Description Language Key Elements

Overview of Web Service Messages and XML Schema Definitions

Web Service Example

Example: WSDL Definition

Example: SOAP Messages Embedded in HTTP Request and Response

OC4J Web Services Tags

Overview of OracleAS Web Services and the Tag Library Implementation

Overview of Functionality of Web Services Tags

Web Services Tag Descriptions

Web Services webservice Tag

Web Services map Tag

Web Services property Tag

Web Services invoke Tag

Web Services part Tag

Web Services Tag Examples

Web Services Example: Usage Template

Web Services Example: Sample JSP Page for RPC-Style Web Service

Web Services Example: Sample JSP Page for Document-Style Web Service

A JML Compile-Time Syntax and Tags

JML Compile-Time Syntax Support

JML Bean References and Expressions, Compile-Time Implementation

JML Bean References

JML Expressions

Attribute Settings with JML Expressions

JML Compile-Time Tag Support

The taglib Directive for Compile-Time JML Support

JML Tag Summary, Compile-Time Versus Runtime

Descriptions of Additional JML Tags, Compile-Time Implementation

JML useBean Tag

JML getProperty Tag

JML setProperty Tag

JML include Tag

JML forward Tag

B Third Party Licenses

Apache HTTP Server

The Apache Software License

The Jaxen Software License

The SAXPath License

Index