Preface

This user's guide describes the JPublisher utility, which translates user-defined object types and PL/SQL packages to Java classes. SQLJ and JDBC programmers who need to have Java classes in their applications that correspond to object types, VARRAY types, nested table types, REF types, or PL/SQL packages use the JPublisher utility.

This preface has the following sections:

• Intended Audience

• Manual Structure

• Related Documentation

• Conventions this Manual Uses

Intended Audience

This manual assumes that you are an experienced programmer and understand Oracle databases and the SQL, SQLJ, and Java programming languages. It also assumes that you understand the principles of JDBC.

Manual Structure

This manual contains two chapters:

Chapter 1, "JPublisher"	Introduces the JPublisher utility. This chapter also includes sections on the JPublisher command line, command line options, input files, and the datatype mappings used to translate object types and method arguments.
Chapter 2, "JPublisher Examples"	Presents examples of JPublisher output for object types and wrapper methods.

Related Documentation

This manual contains references to the following Oracle publications:

• Oracle8i JDBC Developer's Guide and Reference

  This book describes Oracle's implementation of the JDBC standard and the Oracle JDBC server-side and client-side drivers. The Oracle extensions provide mappings from SQL datatypes to Java classes and offer significant advantages in manipulating SQL data. The extensions also support the use of structured objects in the database.

• Oracle8i SQLJ Developer's Guide and Reference

  This book explains the use of SQLJ to embed static SQL operations directly into Java code. It describes both standard SQLJ features and Oracle-specific SQLJ features.

• Oracle8i Java Stored Procedures Developer's Guide

  This book covers Java stored procedures, which open the Oracle RDBMS to all Java programmers. With stored procedures (functions, procedures, database triggers, and SQL methods), Java developers can implement business logic at the server level, and thereby improve application performance, scalability, and security.

• Oracle8i Enterprise JavaBeans and CORBA Developer's Guide

  This manual discusses the Oracle extensions to the JavaBeans and CORBA specifications.

• Oracle8i SQL Reference

  This reference book contains a complete description of the content and syntax of the Structured Query Language (SQL) used to manage information in an Oracle database.

• PL/SQL User's Guide and Reference

  PL/SQL is Oracle's procedural extension to SQL. An advanced fourth-generation programming language (4GL), PL/SQL offers seamless SQL access, tight integration with the Oracle server and tools, portability, security, and modern software engineering features such as data encapsulation, overloading, exception handling, and information hiding. This guide explains all the concepts behind PL/SQL and illustrates every facet of the language.

Conventions this Manual Uses

This book uses Solaris syntax. However, file names and directory names for Windows NT are the same, unless otherwise noted.

The term [ORACLE_HOME] indicates the full path of the Oracle home directory.

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.

Additionally, this manual uses the following conventions.

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.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.

---