Preface

This manual describes how a Java programmer can use Oracle9iAS Personalization (OP) Recommendation Engine API (REAPI) to collect data and obtain recommendations in real time.

Intended Audience

This manual is intended for Java programmers who create and maintain Web sites that use Oracle9iAS Personalization.

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.

Structure

This manual contains the following chapters and appendixes:

Chapter 1	Describes the OP APIs.
Chapter 2	Introduces REAPI.
Chapter 3	Describes the REAPI supporting classes.
Chapter 4	Describes the REAPI methods used to manage sessions, manage data, and request recommendations.
Chapter 5	Contains examples of how to perform common tasks with the REAPI.
Chapter 6	Introduces RE Batch API.
Chapter 7	Describes the RE Batch API supporting classes.
Chapter 8	Describes the RE Batch API methods used to request recommendations.
Chapter 9	Contains examples of how to perform common tasks with the RE Batch API.
Appendix A	Contains a complete example of REAPI use.
Appendix B	Contains a complete example of RE Batch API use.

Where to Find More Information

The documentation set for Oracle9iAS Personalization at the current release consists of the following documents:

• Oracle9i Application Server Installation Guide, Release 9.0.2 (the appropriate version for your operating system).

• Oracle9iAS Release Notes, Release 9.0.2.

• Oracle9iAS Personalization Administrator's Guide, Release 9.0.2.

• Oracle9iAS Personalization User's Guide, Release 9.0.2.

• Oracle9iAS Personalization Programmer's Guide, Release 9.0.2. Describes how to use OP's two APIs (this document).

Related Manuals

For more information about the database underlying OP, see

• Oracle9i Administrator's Guide

Documentation Formats

Documentation for Oracle9iAS Personalization is provided in PDF and HTML formats.

To view the PDF files, you will need

• Adobe Acrobat Reader 3.0 or later, which you can download from http://www.adobe.com.

To view the HTML files, you will need

• Netscape 4.x or later, or

• Internet Explorer 4.x or later

Conventions

In this manual, Windows refers to the Windows95, Windows98, and the Windows NT operating systems.

The SQL interface to Oracle9i is referred to as SQL. This interface is the Oracle9i implementation of the SQL standard ANSI X3.135-1992, ISO 9075:1992, commonly referred to as the ANSI/ISO SQL standard or SQL92.

In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the Return key at the end of a line of input.

The table below shows the conventions used in this manual and their meanings.

Convention	Meaning
. . .	Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.
. . .	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 term defined in the text, the glossary, or in both locations.
italic text	Text or syntax in italics specify user-supplied names or data.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.