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