Skip Headers

Oracle Application Server Containers for J2EE JSP Tag Libraries and Utilities Reference 10g (9.0.4) Part Number B10319-01 |
Home | Contents | Index

#
Preface

JavaServer Pages (JSP) technology, as specified by an industry consortium led by Sun Microsystems, is a component of the standard Java 2 Enterprise Edition (J2EE). The J2EE component of the Oracle Application Server is known as the Oracle Application Server Containers for J2EE (OC4J). This document provides reference information as well as some conceptual material for JSP tag libraries and utilities included with OC4J in Oracle Application Server 10g (9.0.4). These libraries generally conform to the JSP specification.

For general information about the OC4J JSP implementation, including the JSP tag library framework, refer to the Oracle Application Server Containers for J2EE Support for JavaServer Pages Developer's Guide.

This preface contains the following sections:

- Audience

- Documentation Accessibility

- Organization

- Related Documentation

- Conventions

## Audience

This document is intended for Web application developers using servlet and JavaServer Pages technology. It assumes that working Web, servlet, and JSP environments already exist, and that readers are already familiar with the following:

- General Web technology

- Java

- HTML

- Java servlets

- JavaServer Pages

- Configuration of their Web server and servlet environments

- Oracle JDBC (for JSP applications accessing Oracle Database)

You can refer to the Oracle Application Server Containers for J2EE Support for JavaServer Pages Developer's Guide for background information about standard JavaServer Pages technology, the Oracle JSP implementation, and tag library support.

## Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

    http://www.oracle.com/accessibility/

##### Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

##### Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

## Organization

This document contains:

##### Chapter 1, "Overview of Tag Libraries and Utilities"

This chapter provides an overview of the tag libraries documented in the remainder of the manual, as well as overviews of tag libraries provided with other Oracle components, outside of OC4J.

##### Chapter 2, "JavaBeans for Extended Types"

This chapter discusses JavaBeans provided with the JSP Markup Language (JML) library that can be used as extended Java types.

##### Chapter 3, "JSP Markup Language Tags"

This provides JML syntax and tag descriptions, as well as an overview of the philosophy behind the JML tag library.

##### Chapter 4, "Data-Access JavaBeans and Tags"

This documents JavaBeans and tags for database access.

##### Chapter 5, "XML and XSL Tag Support"

This chapter describes tags to use in handling XML documents and outputting or transforming their data.

##### Chapter 6, "JESI Tags for Edge Side Includes"

This chapter describes the Oracle implementation of JESI tags to support Edge Side Includes technology for Web caching.

##### Chapter 7, "Web Object Cache Tags and API"

This describes concepts, custom tags, the Java API, and XML descriptor files for the Web Object Cache, an application-level Java caching interface provided with OC4J.

##### Chapter 8, "File Access and Mail Beans and Tags"

This chapter covers tags and JavaBeans for file access (uploading and downloading) and e-mail.

##### Chapter 9, "JSP Utilities and Utility Tags"

This chapter discusses miscellaneous utility features included with OC4J: `JspScopeListener` for event-handling, tags for using EJBs, and general utility tags.

##### Chapter 10, "Personalization Tags"

This chapter describes a set of tags to support use of Oracle Application Server Personalization, a mechanism to tailor recommendations to application users based on behavioral, purchasing, rating, and demographic data.

##### Chapter 11, "Web Services Tags"

This chapter describes the Web services tag library, which allows developers to create JSP pages for use as client programs for Web services.

##### Appendix A, "JML Compile-Time Syntax and Tags"

This chapter provides an overview of the compile-time implementation of the Oracle JML sample tag library (the only way the library was supported in pre-JSP 1.1 releases), and documents tags not supported in the runtime implementation that is documented in Chapter 3.

##### Appendix B, "Third Party Licenses"

This appendix includes the Third Party License for third party products included with Oracle Application Server and discussed in this document.

## Related Documentation

For more information, see these Oracle resources:

Additional OC4J documents available from the Oracle Java Platform Group:

- Oracle Application Server Containers for J2EE User's Guide

  This book provides some overview and general information for OC4J; primer chapters for servlets, JSP pages, and EJBs; and general configuration and deployment instructions.

- Oracle Application Server Containers for J2EE Stand Alone User's Guide

  This version of the user's guide is specifically for the standalone version of OC4J, and is available when you download the standalone version from OTN. OC4J standalone is used in development environments, but not typically in production environments.

- Oracle Application Server Containers for J2EE Servlet Developer's Guide

  This book provides information for servlet developers regarding use of servlets and the servlet container in OC4J, including basic servlet development, use of JDBC and EJBs, building and deploying applications, and servlet and Web site configuration.

- Oracle Application Server Containers for J2EE Support for JavaServer Pages Developer's Guide

  This book provides information for JSP developers who want to run their pages in OC4J. It includes a general overview of JSP standards and programming considerations, as well as discussion of Oracle value-added features and steps for getting started in the OC4J environment.

- Oracle Application Server Containers for J2EE Services Guide

  This book provides information about standards-based Java services supplied with OC4J, such as JTA, JNDI, JMS, JAAS, and the Oracle Application Server Java Object Cache.

- Oracle Application Server Containers for J2EE Security Guide

  This document (not to be confused with the Oracle Application Server 10g Security Guide), describes security features and implementations particular to OC4J. This includes information about using JAAS, the Java Authentication and Authorization Service, as well as other Java security technologies.

- Oracle Application Server Containers for J2EE Enterprise JavaBeans Developer's Guide

  This book provides information about the EJB implementation and EJB container in OC4J.

Also available from the Oracle Java Platform group:

- Oracle9i Java Developer's Guide

- Oracle9i Java Stored Procedures Developer's Guide

- Oracle9i JDBC Developer's Guide and Reference

- Oracle9i SQLJ Developer's Guide and Reference

- Oracle9i JPublisher User's Guide

Available from the Oracle Application Server group:

- Oracle Application Server 10g Administrator's Guide

- Oracle Application Server 10g Security Guide

- Oracle Application Server 10g Performance Guide

- Oracle Enterprise Manager Concepts

- Oracle HTTP Server Administrator's Guide

- Oracle Application Server 10g Globalization Guide

- Oracle Application Server Web Cache Administrator's Guide

- Oracle Application Server Web Services Developer's Guide

- Oracle Application Server 10g Upgrading to 10g (9.0.4)

Available from the Oracle JDeveloper group:

- Oracle JDeveloper online help

- Oracle JDeveloper documentation on the Oracle Technology Network:

      http://otn.oracle.com/products/jdev/content.html

Available from the Oracle Server Technologies group:

- Oracle XML Developer's Kit Programmer's Guide

- Oracle XML Reference

- Oracle9i Application Developer's Guide - Fundamentals

- Oracle9i Supplied PL/SQL Packages and Types Reference

- PL/SQL User's Guide and Reference

- Oracle9i SQL Reference

- Oracle9i Net Services Administrator's Guide

- Oracle Advanced Security Administrator's Guide

- Oracle9i Database Reference

For information about OracleAS Personalization, which is the foundation of the Personalization tag library, you can refer to the following documents from the OracleAS Personalization group:

- Oracle Application Server Personalization Administrator's Guide

- Oracle Application Server Personalization Programmer's Guide

Printed documentation is available for sale in the Oracle Store at

    http://oraclestore.oracle.com/

To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

    http://otn.oracle.com/membership/

If you already have a user name and password for OTN, then you can go directly to the documentation section of the OTN Web site at

    http://otn.oracle.com/documentation

The following OTN Web site for Java servlets and JavaServer Pages is also available:

    http://otn.oracle.com/tech/java/servlets/

The following resources are available from Sun Microsystems.

- Web site for JavaServer Pages, including the latest specifications:

      http://java.sun.com/products/jsp/index.html

- Web site for Java Servlet technology, including the latest specifications:

      http://java.sun.com/products/servlet/index.html

- `jsp-interest` discussion group for JavaServer Pages

  To subscribe, send an e-mail to `listserv@java.sun.com` with the following line in the body of the message:

      subscribe jsp-interest yourlastname yourfirstname

  It is recommended, however, that you request only the daily digest of the posted e-mails. To do this add the following line to the message body as well:

      set jsp-interest digest

## Conventions

The following conventions are used in this manual:

Convention | Meaning
--- | ---
. . . | Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.
Boldface text | Boldface type in text indicates a GUI component such as a link or button to click.
Italics | Italic typeface indicates book titles or emphasis, or terms that are defined in the text.
`Monospace (fixed-width) font` | Monospace typeface within text indicates items such as executables, file names, directory names, Java class names, Java method names, variable names, other programmatic elements (such as JSP tags or attributes, or XML elements or attributes), or database SQL commands or elements (such as schema names, table names, or column names).
`Italic monospace (fixed-width) font` | Italic monospace font represents placeholders or variables.
[ ] | Brackets enclose optional clauses from which you can choose one or none.
| | A vertical bar represents a choice of two or more options. Enter one of the options. Do not enter the vertical bar.

| Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
Home | Contents | Index