Preface

This guide describes how to use Oracle Visual Information Retrieval Java Classes release 8.1.7. This product requires Oracle Enterprise Edition.

Audience

This guide is for anyone who is interested in storing, retrieving, and manipulating image data in an Oracle8i database using Oracle Visual Information Retrieval and a Java client interface, including developers of image specialization services. Users of this guide should have experience with Java and Java Database Connectivity (JDBC).

Organization

This guide contains the following chapters:

Chapter 1	Contains a general introduction.
Chapter 2	Contains information on the examples included with the Java Classes installation.
Chapter 3	Contains reference information on the ORDVir class.
Appendix A	Contains information on running the sample files included with the Java Classes.
Appendix B	Contains information on possible exceptions and errors.
Appendix C	Contains information on methods that have been deprecated since the previous release.

Related Documents

This guide is not intended as a standalone document. It is a supplement to Oracle Visual Information Retreival User's Guide and Reference. This guide describes the specifics of the Java client interface for Visual Information Retrieval. You need both guides to successfully perform visual information retrieval using the Java interface to this product.

In addition, the ORDVir Java class library described in this guide contains many inherited methods that are documented in Oracle8i interMedia Audio, Image, and Video Java Classes User's Guide and Reference. This guide should also be considered essential to understanding and using the Java interface to this product.

For more information about using this product in a development environment, see the following documents in the Oracle8i documentation set:

• Oracle Call Interface Programmer's Guide

• Oracle8i Application Developer's Guide - Large Objects (LOBs)

• Oracle8i Concepts

• Oracle8i interMedia Audio, Image, and Video Java Classes User's Guide and Reference

• PL/SQL User's Guide and Reference

For information about basic image storage and retrieval, see Oracle8i interMedia Audio, Image, and Video User's Guide and Reference.

For more information on using JDBC, see Oracle8i JDBC Developer's Guide and Reference.

Visual Information Retrieval is based on technology licensed from Virage, Inc. Visit the Virage Web site for additional information at

http://www.virage.com.

Conventions

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 following conventions are also used in this guide:

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 text indicates a term defined in the text, the glossary, or in both locations. In code examples, a boldface number surrounded by brackets (for example, [1]) indicates that the following code will be described in more detail in the given-numbered step in the subsequent numbered list.
italic text	Italic text is used for emphasis, for user-supplied variables, and for book titles.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.