Before You Begin

Welcome to the Using Java DataBase Connectivity book of the Forte for Java Programming Series. This book focuses on programming with persistent data--data stored in a database or other data store that is external to your applications. The book discusses the different persistence programming models supported by Forte for Java 4. It focuses on the Transparent Persistence technology provided by the Forte for Java 4 integrated development environment (IDE).

This book is written for programmers who want to learn how to use the persistence programming models supported by Forte for Java 4. The book assumes a general knowledge of Java and database access technology. Before reading it, you should be familiar with the following subjects:

Java programming language

Relational database concepts (such as tables and keys)

How to use the chosen database

You can create the examples in this book in the environments listed in the release notes on the following web site:

http://forte.sun.com/ffj/documentation/index.html

Screen shots vary slightly from one platform to another. You should have no trouble translating the slight differences to your platform. Although almost all procedures use the Forte for Java 4 user interface, occasionally you might be instructed to enter a command at the command line. Here too, there are slight differences from one platform to another. For example, a Microsoft Windows command might look like this:

c:\>cd MyWorkDir\MyPackage

To translate for UNIX® or Linux environments, simply change the prompt and use forward slashes:

% cd MyWorkDir/MyPackage

Before You Read This Book

Java programming language

Relational database concepts (such as tables and keys)

How to use the chosen database

Note - Sun is not responsible for the availability of third-party web sites mentioned in this document and does not endorse and is not responsible or liable for any content, advertising, products, or other materials on or available from such sites or resources. Sun will not be responsible or liable for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services available on or through any such sites or resources.

How This Book Is Organized

This book describes JDBC productivity enhancement tools provided by Forte for Java 4. These automate many JDBC programming tasks in building client components or applications that interact with a database.

Typographic Conventions

Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your`.login` file. Use `ls` `-a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized	Read Chapter 6 in the User's Guide. These are called class options. You must be superuser to do this.
AaBbCc123	Command-line variable; replace with a real name or value	To delete a file, type `rm` filename.

Related Documentation

Forte for Java 4 documentation includes books delivered in Acrobat Reader (PDF) format, online help, readme files of example applications, and Javadoc trademark documentation.

Documentation Available Online

The documents in this section are available from the Forte for Java 4 portal and the docs.sun.comSM web site.

The documentation link of the Forte for Java 4 Developer Resources portal is at http://forte.sun.com/ffj/documentation/. The docs.sun.com web site is at http://docs.sun.com.

Release notes (HTML format)

Available for each Forte for Java 4 edition. Describe last-minute release changes and technical notes.

Forte for Java 4 Getting Started Guide (PDF format) - Community Edition part no. 816-4062-10, Enterprise Edition part no. 816-4063-10

Available for each Forte for Java 4 edition. Describes how to install the Forte for Java 4 product on each supported platform and includes other pertinent information, such as system requirements, upgrade instructions, web server and application server installation instructions, command-line switches, installed subdirectories, Javadoc setup, database integration, and information on how to use the Update Center.

The Forte for Java 4 Programming Series (PDF format)

This series provides in-depth information on how to use various Forte for Java 4 features to develop well-formed J2EE applications.

Building Web Components - part no. 816-4337-10

Describes how to build a web application as a J2EE web module using JSP pages, servlets, tag libraries, and supporting classes and files.

Building J2EE Applications With Forte for Java - part no. 816-4061-10

Describes how to assemble EJB modules and web modules into a J2EE application, and how to deploy and run a J2EE application.

Building Enterprise JavaBeans Components - part no. 816-4060-10

Describes how to build EJB components--session beans and entity beans with container-managed or bean-managed persistence--using the Forte for Java 4 EJB Builder wizard and other components of the IDE.

Building Web Services - part no. 816-4059-10

Describes how to use the tools provided by the Web Services module to build web services. Web services are application business services published as Extensible Markup Language (XML) documents delivered over HTTP connections.

Using Java DataBase Connectivity - part no. 816-4685-10

Describes how to use the JDBC productivity enhancement tools of the Forte for Java 4 IDE, including how to use them to create a JDBC application.

Forte for Java 4 tutorials (PDF format)

You can also find the completed tutorial applications at http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

Forte for Java 4, Community Edition Tutorial - part no. 816-4058-10

Provides step-by-step instructions for building a simple J2EE web application using Forte for Java 4, Community Edition tools.

Forte for Java 4, Enterprise Edition Tutorial - part no. 816-4057-10

Provides step-by-step instructions for building an application using EJB components and Web Services technology.

The docs.sun.com web site (http://docs.sun.com) enables you to read, print, and buy Sun Microsystems manuals through the Internet. If you cannot find a manual, see the documentation index installed with the product on your local system or network.

Online Help

Online help is available inside the Forte for Java 4 development environment. You can access help by pressing the help key (Help in a Solaris environment, F1 on Microsoft Windows and Linux), or by choosing Help right arrow Contents. Either action displays a list of help topics and a search facility.

Examples

Several examples that illustrate a particular Forte for Java 4 feature are available, with accompanying Readme files, in the sampledir/examples subdirectory of your user settings directory. In addition, you can download Enterprise Edition-specific examples from the Developer Resources portal and unzip them into the examples directory.

See the Developer Resources portal at:
http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

Javadoc Documentation

Javadoc documentation is available within the IDE for many Forte for Java 4 modules. Refer to the release notes for instructions on installing this documentation. When you start the IDE, you can access this Javadoc documentation within the Javadoc pane of the Explorer.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:

docfeedback@sun.com

Please include the part number (816-4685) of your document in the subject line of your email.