|Oracle9i SQLJ Developer's Guide and Reference
Release 1 (9.0.1)
Part Number A90212-01
This preface introduces you to the Oracle9i SQLJ Developer's Guide and Reference, discussing the intended audience, structure, and conventions of this document. A list of related Oracle documents is also provided.
This manual is intended for anyone with an interest in SQLJ programming but assumes at least some prior knowledge of the following:
Although general knowledge of SQL and JDBC is sufficient, any knowledge of Oracle-specific SQL and JDBC features would be helpful as well.
See "Related Documents" below for the names of Oracle documents that discuss SQL and JDBC.
The two major aspects of using SQLJ are:
Chapters 3 through 7 provide information about programming features, with chapters 3 and 4 covering the most important aspects.
Chapter 8 provides information about translator options and features.
In all, this document consists of the following chapters and appendixes:
demodirectory on the product CD.
AuditorInstallerutility that is provided with Oracle SQLJ.
This section lists other documentation of interest.
See the following additional documents available from the Oracle Java Platform group:
This book covers programming syntax and features of Oracle's implementation of the JDBC standard (for Java Database Connectivity). This includes an overview of the Oracle JDBC drivers, details of Oracle's implementation of JDBC 1.22 and 2.0 features, and discussion of Oracle JDBC type extensions and performance extensions.
This book describes how to use the Oracle JPublisher utility to translate object types and other user-defined types to Java classes. If you are developing SQLJ or JDBC applications that use object types, VARRAY types, nested table types, or object reference types, then JPublisher can generate custom Java classes to map to them.
This book introduces the basic concepts of Java in Oracle9i and provides general information about server-side configuration and functionality. Information that pertains to the Oracle Java platform as a whole, rather than to a particular product (such as JDBC, SQLJ, or EJBs) is in this book.
This book documents use of the Oracle9i Servlet Engine, the servlet container in Oracle9i.
This book covers the use of JavaServer Pages technology to embed Java code and JavaBean invocations inside HTML pages. Both standard JSP features and Oracle-specific features are described.
This book documents Java-related tools and utilities for use with Oracle9i or in deploying applications to Oracle9i (such as the session shell and
This book discusses Java stored procedures--programs that run directly in Oracle9i. With stored procedures (functions, procedures, triggers, and SQL methods), Java developers can implement business logic at the server level, thereby improving application performance, scalability, and security.
This book describes Oracle's Enterprise JavaBeans implementation and extensions.
This book describes Oracle's CORBA implementation and extensions.
You can also refer to the following documents from the Oracle Server Technologies group.
This book contains information about the Oracle8 Connection Manager and Oracle Net network administration in general.
This book contains information about Oracle Globalization Support environment variables, character sets, and territory and locale settings. In addition, it contains an overview of common globalization issues, typical scenarios, and related considerations for OCI and SQL programmers.
This book describes features of the Oracle Advanced Security Option (formerly known as ANO or ASO).
This book introduces basic design concepts and programming features in using Oracle9i and creating data-access applications.
This book describes general functionality and features of "large objects" (LOBs) in Oracle9i.
This book contains general information about structured objects and other object-relational features in Oracle9i.
This book documents Java packages available as part of Oracle9i.
This book documents PL/SQL packages available as part of Oracle9i.
This book explains the concepts and features of PL/SQL, Oracle's procedural language extension to SQL.
This book contains a complete description of the content and syntax of the SQL commands and features used to manage information in an Oracle database.
This book contains general reference information about Oracle9i.
This book contains information about error messages that can be passed by Oracle9i.
Documentation from the following Oracle groups may also be of interest.
For documentation of SQLJ standard features and syntax, refer to ANSI specification X3.135.10-1998:
You can obtain this from ANSI through the following Web site:
(Click on "Electronic Standards Store" and search for the above specification number.)
This document uses UNIX syntax for file paths (for example:
/myroot/myfile.html). If you are using some other kind of operating system, then substitute the appropriate syntax.
This document uses
[Oracle Home] to indicate your Oracle home directory.
In addition, this document uses the following conventions:
italicized regular text
Italicized regular text is used for emphasis or to indicate a term that is being defined or will be defined shortly.
. . .
Horizontal ellipsis points in sample code indicate the omission of a statement or statements or part of a statement. This is done when you would normally expect additional statements or code to appear, but such statements or code would not be related to the example.
Code text within regular text indicates class names, object names, method names, variable names, Java types, Oracle datatypes, file names, and directory names.
Italicized code text in a program statement indicates something that must be provided by the user.
Angle brackets enclosing italicized code text in a program statement indicates something that can optionally be provided by the user.
In this document, it was not feasible to use more standard conventions, such as square brackets  to enclose optional items to be provided, because of the particulars of SQLJ coding syntax.
For example, in the following statement the square brackets and curly brackets are part of SQLJ coding syntax, but the angle brackets indicate that
results_exp are optional entries. You must provide a SQL operation, however.
And in the following SQLJ command line option (
-user), the angle brackets indicate that
conn_context_class and the password (with preceding slash) are optional entries. You must provide a username, however.
Oracle's goal is to make our products, services, and supporting documentation accessible to the disabled community with good usability. 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 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:
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.