Contents

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Overview of Tag Libraries and Utilities

• 1.1 Overview of Tag Libraries and Utilities Provided with OC4J
• 1.1.1 Tag Syntax Symbology and Notes
• 1.1.2 Overview of Extended Type JavaBeans
• 1.1.3 Overview of JspScopeListener for Event-Handling
• 1.1.4 Overview of Integration with XML and XSL
• 1.1.5 Summary of Data-Access JavaBeans and Tag Library
• 1.1.6 Summary of Oracle Application Server Personalization Tag Library
• 1.1.7 Summary of Web Services Tags
• 1.1.8 Summary of File Access and Mail Tags
• 1.1.9 Summary of EJB Tags
• 1.1.10 Summary of JSP Utility Tags
• 1.2 Summary of Oracle Caching Support for Web Applications
• 1.2.1 Oracle Application Server and JSP Caching Features
• 1.2.2 Role of the JSP Web Object Cache
• 1.2.2.1 Web Object Cache Versus OracleAS Web Cache
• 1.2.2.2 Web Object Cache Versus Oracle Application Server Java Object Cache
• 1.2.3 Summary of Tag Libraries for Caching
• 1.2.3.1 Summary of JESI Tag Library
• 1.2.3.2 Summary of Web Object Cache Tag Library

2 Support for the JavaServer Pages Standard Tag Library

• 2.1 Overview of the JSTL
• 2.1.1 Philosophy of the JSTL
• 2.1.2 Summary of the JSTL Tags
• 2.1.3 Overview of Additional JSTL Features
• 2.1.3.1 Scoped Variables
• 2.1.3.2 Configuration Data and the Config Class
• 2.1.4 JSTL Usage Notes and Future Considerations

3 Data-Access JavaBeans and Tags

• 3.1 JavaBeans for Data Access
• 3.1.1 Introduction to Data-Access JavaBeans
• 3.1.2 Data-Access Support for Data Sources and Pooled Connections
• 3.1.3 Data-Access JavaBean Descriptions
• 3.1.3.1 ConnBean for a Database Connection
• 3.1.3.2 CursorBean for DML and Stored Procedures
• 3.1.3.3 Example: Using ConnBean and CursorBean with a Data Source
• 3.2 SQL Tags for Data Access
• 3.2.1 Introduction to Data-Access Tags
• 3.2.2 Data-Access Tag Descriptions
• 3.2.2.1 SQL dbOpen Tag
• 3.2.2.2 SQL dbClose Tag
• 3.2.2.3 SQL dbQuery Tag
• 3.2.2.4 SQL dbCloseQuery Tag
• 3.2.2.5 SQL dbNextRow Tag
• 3.2.2.6 SQL dbExecute Tag
• 3.2.2.7 SQL dbSetParam Tag
• 3.2.2.8 SQL dbSetCookie Tag
• 3.2.2.9 Example: Using dbOpen and dbQuery with a Data Source

4 Tag Libraries from Other Oracle Components

• 4.1 Summary of Oracle Tag Libraries
• 4.1.1 Oracle Business Components for Java Tag Library
• 4.1.2 Oracle JDeveloper User Interface Extension (UIX) Tag Library
• 4.1.3 Oracle JDeveloper BC4J UIX JSP Tag Library
• 4.1.4 Oracle Reports Tag Library
• 4.1.5 Oracle Application Server Wireless Location Tag Library
• 4.1.6 Oracle Application Server MapViewer Tag Library
• 4.1.7 Oracle Ultra Search Tag Library
• 4.1.8 Oracle Application Server Portal Tag Library
• 4.1.9 Oracle Business Intelligence Beans Tag Library
• 4.1.10 Oracle Application Server Multimedia Tag Library

5 XML and XSL Tag Support

• 5.1 Overview of Oracle Tags for XML Support
• 5.1.1 XML Producers and XML Consumers
• 5.1.2 Summary of OC4J Tags with XML Functionality
• 5.2 XML Utility Tags
• 5.2.1 XML Utility Tag Descriptions
• 5.2.1.1 XML transform and styleSheet Tags for XML/XSL Data Transformation
• 5.2.1.2 XML parsexml Tag to Convert from Input Stream
• 5.2.2 XML Utility Tag Examples
• 5.2.2.1 Example Using the transform Tag
• 5.2.2.2 Example Using the transform and dbQuery Tags
• 5.2.2.3 Examples Using the transform and parsexml Tags

6 JESI Tags for Edge Side Includes

• 6.1 Overview of Edge Side Includes Technology and Processing
• 6.1.1 Edge Side Includes Technology
• 6.1.1.1 Introduction to ESI
• 6.1.1.2 More About Surrogates
• 6.1.1.3 Key ESI Features
• 6.1.2 Oracle Application Server Web Cache and ESI Processor
• 6.1.2.1 Introduction to Oracle Application Server Web Cache
• 6.1.2.2 Steps in Oracle Application Server Web Cache Usage
• 6.1.2.3 Oracle Application Server Web Cache ESI Processor
• 6.2 Overview of JESI Functionality
• 6.2.1 Advantages of JESI Tags
• 6.2.2 Overview of JESI Tags Implemented by Oracle
• 6.2.3 JESI Usage Models
• 6.2.3.1 Control/Include Model
• 6.2.3.2 Template/Fragment Model
• 6.2.3.3 Notes About JESI and JSP Includes
• 6.2.4 Invalidation of Cached Objects
• 6.2.5 Personalization of Cached Pages
• 6.2.6 JESI Fallback Execution
• 6.3 Oracle JESI Tag Descriptions
• 6.3.1 Descriptions of Tags for Dynamic Caching
• 6.3.1.1 JESI control Tag
• 6.3.1.2 JESI include Tag
• 6.3.1.3 JESI param Tag
• 6.3.1.4 Examples: Control/Include Model
• 6.3.1.5 JESI template Tag
• 6.3.1.6 JESI fragment Tag
• 6.3.1.7 JESI codeblock Tag
• 6.3.1.8 Examples: Template/Fragment Model
• 6.3.2 Descriptions of Tags and Subtags for Invalidation of Cached Objects
• 6.3.2.1 JESI invalidate Tag
• 6.3.2.2 JESI Configuration File
• 6.3.2.3 JESI object Subtag
• 6.3.2.4 JESI cookie Subtag
• 6.3.2.5 JESI header Subtag
• 6.3.2.6 Examples: Page Invalidation
• 6.3.3 Description of Tag for Page Personalization
• 6.3.3.1 JESI personalize Tag
• 6.3.3.2 Example: Page Personalization
• 6.4 JESI Tag Handling and JESI-to-ESI Conversion
• 6.4.1 Example: JESI-to-ESI Conversion for Included Pages
• 6.4.2 Example: JESI-to-ESI Conversion for a Template and Fragment

7 Web Object Cache Tags and API

• 7.1 Overview of the Web Object Cache
• 7.1.1 Benefits of the Web Object Cache
• 7.1.2 Web Object Cache Components
• 7.1.2.1 Cache Repository
• 7.1.2.2 Cache Programming Interfaces
• 7.1.3 Cache Policy and Scope
• 7.2 Key Functionality of the Web Object Cache
• 7.2.1 Cache Block Naming: Implicit Versus Explicit
• 7.2.2 Cloneable Cache Objects
• 7.2.2.1 Memory-Oriented Repositories Versus Secondary Storage Repositories
• 7.2.2.2 Advantages in Cloning Copies of Cache Objects
• 7.2.2.3 Use of the CloneableCacheObject Interface
• 7.2.3 Cache Block Runtime Functionality
• 7.2.4 Data Invalidation and Expiration
• 7.2.4.1 Cache Block Expiration
• 7.2.4.2 Cache Block Invalidation
• 7.3 Attributes for Policy Specification and Use
• 7.3.1 Cache Policy Attributes
• 7.3.1.1 Cache Policy Attribute Descriptions
• 7.3.1.2 More About Cache Block Naming and the autoType Attribute
• 7.3.1.3 More About reusableTimeStamp and reusableDeltaTime
• 7.3.2 Expiration Policy Attributes
• 7.4 Web Object Cache Tag Descriptions
• 7.4.1 Cache Tag Descriptions
• 7.4.1.1 Web Object Cache cache Tag
• 7.4.1.2 Web Object Cache cacheXMLObj Tag
• 7.4.1.3 Web Object Cache useCacheObj Tag
• 7.4.1.4 Conditional Execution of Code Inside the Cache Tags
• 7.4.1.5 Web Object Cache cacheInclude Tag
• 7.4.2 Cache Invalidation Tag Description
• 7.4.2.1 Web Object Cache invalidateCache Tag
• 7.4.2.2 Example: Use of Cache Invalidation Tag
• 7.5 Web Object Cache API Descriptions
• 7.5.1 Cache Policy Object Creation
• 7.5.1.1 Using the lookupPolicy() Method
• 7.5.1.2 Using a CachePolicy Constructor
• 7.5.2 CachePolicy Methods
• 7.5.2.1 CachePolicy Method Signatures and Common Parameters
• 7.5.2.2 CachePolicy Method Descriptions
• 7.5.2.3 CachePolicy Getter and Setter Methods
• 7.5.3 Expiration Policy Object Retrieval
• 7.5.4 ExpirationPolicy Methods
• 7.5.5 CacheBlock Methods
• 7.5.6 Tag Code Versus API Code
• 7.5.6.1 Simple JSP Page: tagcode.jsp
• 7.5.6.2 Scriptlet JSP Page: servletcode.jsp
• 7.5.6.3 Servlet Page: DemoCacheServlet.java
• 7.5.6.4 Cache Policy Descriptor: test-policy.cpd
• 7.6 Cache Policy Descriptor
• 7.6.1 Cache Policy Descriptor DTD
• 7.6.2 Sample Cache Policy Descriptor
• 7.6.3 Cache Policy Descriptor Loading and Refreshing
• 7.7 Cache Repository Descriptor
• 7.7.1 Cache Repository Descriptor DTD
• 7.7.2 Sample Cache Repository Descriptor
• 7.8 Configuration for Back-End Repository
• 7.8.1 Configuration Notes for Oracle Application Server Java Object Cache
• 7.8.2 Configuration Notes for File System Cache

8 File Access and Mail Beans and Tags

• 8.1 File-Access JavaBeans and Tags
• 8.1.1 Overview of OC4J File-Access Functionality
• 8.1.1.1 Overview of File Uploading
• 8.1.1.2 Overview of File Downloading
• 8.1.2 File Upload and Download JavaBean and Class Descriptions
• 8.1.2.1 The HttpUploadBean
• 8.1.2.2 The HttpDownloadBean
• 8.1.2.3 The Download Servlet
• 8.1.2.4 FileAccessException Class
• 8.1.3 File Upload and Download Tag Descriptions
• 8.1.3.1 The httpUploadForm Tag
• 8.1.3.2 The httpUpload Tag
• 8.1.3.3 The httpDownload Tag
• 8.2 Mail JavaBean and Tag
• 8.2.1 General Considerations for the Mail JavaBean and Tag
• 8.2.2 Mail Attachments
• 8.2.2.1 Enabling Attachments
• 8.2.2.2 Sending Attachments
• 8.2.2.3 Attachment Usage Notes
• 8.2.3 SendMailBean Description
• 8.2.3.1 SendMailBean Requirements
• 8.2.3.2 SendMailBean Method Descriptions
• 8.2.4 The sendMail Tag Description
• 8.2.4.1 The sendMail Tag Syntax
• 8.2.4.2 The sendMail Tag Attribute Descriptions
• 8.2.4.3 Sample Application for sendMail Tag

9 JSP Utilities and Utility Tags

• 9.1 JSP Event-Handling with JspScopeListener
• 9.1.1 General Use of JspScopeListener
• 9.1.2 Use of JspScopeListener in OC4J
• 9.1.2.1 Requirements for JspScopeListener
• 9.1.2.2 Servlet Filter Implementation to Support Request Scope
• 9.1.2.3 Listener Class Implementation to Support Application Scope
• 9.1.2.4 Integration with HttpSessionBindingListener to Support Session Scope
• 9.2 EJB Tags
• 9.2.1 EJB Tag Configuration
• 9.2.2 EJB Tag Descriptions
• 9.2.2.1 EJB useHome Tag
• 9.2.2.2 EJB useBean Tag
• 9.2.2.3 EJB createBean Tag
• 9.2.2.4 EJB iterate Tag
• 9.2.3 EJB Tag Examples
• 9.2.3.1 EJB Tag Session Bean Example
• 9.2.3.2 EJB Tag Entity Bean Example
• 9.3 General Utility Tags
• 9.3.1 Display Tags
• 9.3.1.1 Utility displayCurrency Tag
• 9.3.1.2 Utility displayDate Tag
• 9.3.1.3 Utility displayNumber Tag
• 9.3.2 Miscellaneous Utility Tags
• 9.3.2.1 Utility iterate Tag
• 9.3.2.2 Utility ifInRole Tag
• 9.3.2.3 Utility lastModified Tag

10 Personalization Tags

• 10.1 Overview of Personalization
• 10.1.1 General Overview of Personalization
• 10.1.1.1 Personalization Concepts
• 10.1.1.2 Personalization Versus Customization
• 10.1.2 Introduction to Oracle Application Server Personalization
• 10.1.2.1 Basis for Recommendations
• 10.1.2.2 Key Components
• 10.1.2.3 Introduction to Mining Table Repository
• 10.1.2.4 Introduction to Models
• 10.1.2.5 Introduction to Mining Object Repository
• 10.1.2.6 Introduction to Recommendation Engines
• 10.1.2.7 Introduction to Recommendation Engine Farms
• 10.1.3 Overview of Recommendation Engine API Concepts and Features
• 10.1.3.1 Visitors Versus Customers
• 10.1.3.2 Items, Recommendations, Taxonomies, and Categories
• 10.1.3.3 Ratings and Rankings
• 10.1.3.4 Stateful Versus Stateless Recommendation Engine Sessions
• 10.1.3.5 Requests for Recommendations
• 10.2 Overview of Personalization Tag Functionality
• 10.2.1 Recommendation Engine Session Management
• 10.2.1.1 Starting a Recommendation Engine Session
• 10.2.1.2 Using a Stateful Application
• 10.2.1.3 Using a Stateless Application
• 10.2.1.4 Ending a Recommendation Engine Session
• 10.2.2 Use of Items in Personalization Tags
• 10.2.2.1 Overview of Item Recording and Removal Tags
• 10.2.2.2 Overview of Recommendation and Evaluation Tags
• 10.2.2.3 Use of Tag-Extra-Info Scripting Variables for Returned Items
• 10.2.2.4 Specification of Input Items
• 10.2.2.5 Inputting Item Arrays
• 10.2.2.6 Demographic Items
• 10.2.3 Mode of Use for Item Recording Tags
• 10.2.4 Use of Tuning, Filtering, and Sorting for Recommendation and Evaluation Tags
• 10.2.4.1 Tuning Settings
• 10.2.4.2 Recommendation Filtering
• 10.2.4.3 Sorting Order
• 10.3 Personalization Tag and Class Descriptions
• 10.3.1 Session Management Tag Descriptions
• 10.3.1.1 Personalization startRESession Tag
• 10.3.1.2 Personalization endRESession Tag
• 10.3.1.3 Personalization setVisitorToCustomer Tag
• 10.3.2 Recommendation and Evaluation Tag Descriptions
• 10.3.2.1 Personalization getRecommendations Tag
• 10.3.2.2 Personalization getCrossSellRecommendations Tag
• 10.3.2.3 Personalization selectFromHotPicks Tag
• 10.3.2.4 Personalization evaluateItems Tag
• 10.3.2.5 Personalization forItem Tag
• 10.3.2.6 Personalization getNextItem Tag
• 10.3.3 Item Recording and Removal Tag Descriptions
• 10.3.3.1 Personalization recordNavigation Tag
• 10.3.3.2 Personalization recordPurchase Tag
• 10.3.3.3 Personalization recordRating Tag
• 10.3.3.4 Personalization recordDemographic Tag
• 10.3.3.5 Personalization removeNavigationRecord Tag
• 10.3.3.6 Personalization removePurchaseRecord Tag
• 10.3.3.7 Personalization removeRatingRecord Tag
• 10.3.3.8 Personalization removeDemographicRecord Tag
• 10.3.4 Item Class Description
• 10.3.5 Personalization Tag Constraints
• 10.4 Personalization Tag Library Configuration Files
• 10.4.1 The personalization.xml Files
• 10.4.2 Element Descriptions for personalization.xml
• 10.4.2.1 RecommendationSettings Element
• 10.4.2.2 RE Element
• 10.4.2.3 Tuning Element
• 10.4.2.4 DefaultTuning Element
• 10.4.2.5 Filtering Element and Category Elements
• 10.4.2.6 DefaultFiltering Element
• 10.4.3 Sample personalization.xml File

11 Web Services Tags

• 11.1 Overview of Web Services
• 11.1.1 General Web Services Overview
• 11.1.2 Overview of SOAP and Related Features
• 11.1.3 Overview of Web Services Description Language Key Elements
• 11.1.4 Overview of Web Service Messages and XML Schema Definitions
• 11.1.5 Web Service Example
• 11.1.5.1 Example: WSDL Definition
• 11.1.5.2 Example: SOAP Messages Embedded in HTTP Request and Response
• 11.2 OC4J Web Services Tags
• 11.2.1 Overview of OracleAS Web Services and the Tag Library Implementation
• 11.2.2 Overview of Functionality of Web Services Tags
• 11.2.3 Web Services Tag Descriptions
• 11.2.3.1 Web Services webservice Tag
• 11.2.3.2 Web Services map Tag
• 11.2.3.3 Web Services property Tag
• 11.2.3.4 Web Services invoke Tag
• 11.2.3.5 Web Services part Tag
• 11.2.4 Web Services Tag Examples
• 11.2.4.1 Web Services Example: Usage Template
• 11.2.4.2 Web Services Example: Sample JSP Page for RPC-Style Web Service
• 11.2.4.3 Web Services Example: Sample JSP Page for Document-Style Web Service

A JML Extended Types

• A.1 Overview of JML Extended Types
• A.2 JML Extended Type Descriptions
• A.2.1 Type JmlBoolean
• A.2.2 Type JmlNumber
• A.2.3 Type JmlFPNumber
• A.2.4 Type JmlString
• A.2.5 JML Extended Types Example

B Deprecated JavaBeans for Data Access

• B.1 Data Access JavaBeans
• B.1.1 Data-Access JavaBean Descriptions
• B.1.1.1 ConnCacheBean for Connection Caching
• B.1.1.2 DBBean for Queries Only

C Third Party Licenses

• C.1 Apache
• C.1.1 The Apache Software License
• C.1.1.1 License
• C.1.1.2 Notice
• C.2 Jaxen
• C.2.1 The Jaxen Software License
• C.3 SAXPath
• C.3.1 The SAXPath License

Index