Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

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 Oracle Application Server Personalization Tag Library
• Summary of Web Services Tag Library
• 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 Reports 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 JmlNumber
• Type JmlFPNumber
• Type JmlString
• 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
• JML remove Tag
• Logic and Flow Control Tag Descriptions
• JML if Tag
• JML choose...when...[otherwise] Tags
• JML for Tag
• JML foreach Tag
• JML return Tag
• JML flush 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 dbOpen Tag
• 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
• JESI param 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 Tags
• 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
• Display Tags
• Utility displayCurrency Tag
• Utility displayDate Tag
• Utility displayNumber Tag
• Miscellaneous Utility Tags
• Utility iterate Tag
• Utility ifInRole Tag
• Utility lastModified Tag

10 Personalization Tags

• Overview of Personalization
• General Overview of Personalization
• Personalization Concepts
• Personalization Versus Customization
• Introduction to Oracle Application Server Personalization
• Basis for Recommendations
• Key Components
• Introduction to Mining Table Repository
• Introduction to Models
• Introduction to Mining Object Repository
• Introduction to Recommendation Engines
• Introduction to Recommendation Engine Farms
• Overview of Recommendation Engine API Concepts and Features
• Visitors Versus Customers
• Items, Recommendations, Taxonomies, and Categories
• Ratings and Rankings
• Stateful Versus Stateless Recommendation Engine Sessions
• Requests for Recommendations
• Overview of Personalization Tag Functionality
• Recommendation Engine Session Management
• Starting a Recommendation Engine Session
• Using a Stateful Application
• Using a Stateless Application
• Ending a Recommendation Engine Session
• Use of Items in Personalization Tags
• Overview of Item Recording and Removal Tags
• Overview of Recommendation and Evaluation Tags
• Use of Tag-Extra-Info Scripting Variables for Returned Items
• Specification of Input Items
• Inputting Item Arrays
• Demographic Items
• Mode of Use for Item Recording Tags
• Use of Tuning, Filtering, and Sorting for Recommendation and Evaluation Tags
• Tuning Settings
• Recommendation Filtering
• Sorting Order
• Personalization Tag and Class Descriptions
• Session Management Tag Descriptions
• Personalization startRESession Tag
• Personalization endRESession Tag
• Personalization setVisitorToCustomer Tag
• Recommendation and Evaluation Tag Descriptions
• Personalization getRecommendations Tag
• Personalization getCrossSellRecommendations Tag
• Personalization selectFromHotPicks Tag
• Personalization evaluateItems Tag
• Personalization forItem Tag
• Personalization getNextItem Tag
• Item Recording and Removal Tag Descriptions
• Personalization recordNavigation Tag
• Personalization recordPurchase Tag
• Personalization recordRating Tag
• Personalization recordDemographic Tag
• Personalization removeNavigationRecord Tag
• Personalization removePurchaseRecord Tag
• Personalization removeRatingRecord Tag
• Personalization removeDemographicRecord Tag
• Item Class Description
• Personalization Tag Constraints
• Personalization Tag Library Configuration Files
• The personalization.xml Files
• Element Descriptions for personalization.xml
• RecommendationSettings Element
• RE Element
• Tuning Element
• DefaultTuning Element
• Filtering Element and Category Elements
• DefaultFiltering Element
• Sample personalization.xml File

11 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 set Tag
• JML call Tag
• JML lock Tag
• JML include Tag
• JML forward Tag
• JML print Tag
• JML plugin Tag

B Third Party Licenses

• Apache HTTP Server
• The Apache Software License
• Jaxen
• The Jaxen Software License
• SAXPath
• The SAXPath License

Index