JDBC API Tutorial and Reference, Second Edition:
Universal Data Access for the Java 2 Platform Second Edition

What the JDBC 2.0 API Includes.
Conventions Used in This Book.
Fonts to Indicate Function.
Icons to Indicate New Material.
Special Page Designations in the Index.
SQLException Is Implied in Method Explanations.
Some Method Explanations Are Combined.
Contents of the Book.
Part One.
Part Two.
Suggested Order for Reading Chapters.
Where to Find Information by Topic.
Resources on the Web.
What Is the JDBC API.
What Does JDBC Do?
A Base for Other APIs.
The JDBC API Versus ODBC and UDA.
Two-tier and Three-tier Models.
SQL Conformance.
JDBC Products.
Java Software Framework.
JDBC Driver Types.
Obtaining JDBC Drivers.
Java-relational DBMSs.
Other Products.
Java Overview.
Java Is Portable.
Java Is Object-Oriented.
Java Makes It Easy to Write Correct Code.
Java Includes a Library of Classes and Interfaces.
Java Is Extensible.
Java Is Secure.
Java Performs Well.
Java Scales Well.
Java Is Multithreaded.
Relational Database Overview.
Integrity Rules.
SELECT Statements.
WHERE Clauses.
Joins.
Common SQL Commands.
Result Sets and Cursors.
Transactions.
Stored Procedures.
Metadata.

Getting Started.
Setting Up a Database.
Establishing a Connection.
Loading Drivers.
Making the Connection.
Setting Up Tables.
Creating a Table.
Creating JDBC Statements.
Executing Statements.
Entering Data into a Table.
Getting Data from a Table.
Retrieving Values from Result Sets.
Using the Method next.
Using the getxXX Methods.
Using the Method getString.
Updating Tables.
Milestone: The Basics of JDBC.
Using Prepared Statements.
When to Use a PreparedStatement Object.
Creating a PreparedStatement Object.
Supplying Values for PreparedStatement Parameters.
Using a Loop to Set Values.
Return Values for the Method executeUpdate.
Using Joins.
Using Transactions.
Disabling Auto-commit Mode.
Committing a Transaction.
Using Transactions to Preserve Data Integrity.
When to Roll Back a Transaction.
Stored Procedures.
SQL Statements for Creating a Stored Procedure.
Calling a Stored Procedure Using the JDBC API.
Creating Complete JDBC Applications.
Putting Code in a Class Definition.
Importing Classes to Make Them Visible.
Using the main Method.
Using try and catch Blocks.
Retrieving Exceptions.
Retrieving Warnings.
Running the Sample Applications.
Sample Code.
Sample Code 1 and 2.
Sample Code 3 and 4.
Sample Code 5.
Sample Code 6.
Creating an Applet from an Application.
Writing Applet Code.
Running an Applet.
Sample Code 7 and 8.
Stored Procedures Using SQLJ and the JDBC API.
Creating a Stored Procedure.
Installing a Stored Procedure.
Declaring a Stored Procedure in SQL.

Getting Set Up to Use the JDBC 2.0 API.
Setting Up to Run Code with New Features.
Using Code Examples.
Moving the Cursor in Scrollable Result Sets.
Creating a Scrollable Result Set.
Moving the Cursor Forward and Backward.
Moving the Cursor to a Designated Row.
Getting the Cursor Position.
Making Updates to Updatable Result Sets.
Creating an Updatable Result Set.
Updating a Result Set Programmatically.
Inserting and Deleting Rows Programmatically.
Code Sample for Inserting a Row.
Deleting a Row Programmatically.
Seeing Changes in Result Sets.
Getting the Most Recent Data.
Making Batch Updates.
Using Statement Objects for Batch Updates.
Batch Update Exceptions.
Sample Code for Batch Update.
SQL3 Data Types.
DISTINCT Type.
Using SQL3 Data Types.
Blob, Clob, and Array Objects.
Creating an SQL Structured Type.
Creating a DISTINCT Type.
Using References to Structured Types.
Sample Code for Creating an SQL REF.
Using SQL3 Types as Column Values.
Inserting SQL3 Types into a Table.
Using Custom Mapping.
Implementing SQLData.
Using a Connection's Type Map.
Using Your Own Type Map.
Using Data Sources.
Using a DataSource Object to Get a Connection.
Deploying a Basic DataSource Object.
Deploying Other DataSource Implementations.
Getting and Using a Pooled Connection.
Deployment for Distributed Transactions.
Using Connections for Distributed Transactions.

Getting Information about Result Set Columns.
Using the Method getColumnCount.
Sample Code 9.
Using Other ResultSetMetaData Methods.
Getting Column Type Information.
Sample Code 10 and 11.
Sample Code 12.
Getting Other Information.
Using New JDBC 2.0 ResultSetMetaData Features.
Getting Other Information about a Result Set.
Getting Information about a Database or Database System.
Categories of DatabaseMetaData Methods.
Methods that Return a String.
Methods that Return an int.
Methods that Return a boolean.
Methods that Return a ResultSet Object.
Sample Code 13.
Getting Information about DBMS Data Types.
Sample Code 14.
Getting Information about Primary and Foreign Keys.
Sample Code 15.
Sample Code 16.
New JDBC 2.0 Core Methods.
Generic Applications.
Sample Code 17 and 18.
Sample Code 19.

Types and Uses of Rowsets.
Using a Rowset.
Creating a Rowset and Setting Properties.
Rowsets and Event Notification.
Obtaining a Scrollable and Updatable Rowset.
Using a Rowset for Scrolling and Updating.
Updating a Rowset.
An EJB Example.
A Distributed Application.
Differences in Rowsets.
EJB and Distributed Transactions.
A Stateless SessionBean Object.
Overview of an EJB Application.
The Remote Interface.
The Home Interface.
The Client Class.
The Enterprise Bean.

Array Overview.
Creating an Array Object.
Getting Base Type Information.
Materializing Array Data.
Four Versions of the Method getArray.
Four Versions of the Method getResultSet.
Using Array Methods.
Storing Array Objects.
Array Interface Definition.
Array Methods.

BatchUpdateException Overview.
What a BatchUpdateException Object Contains.
Retrieving BatchUpdateException Information.
BatchUpdateException Class Definition.
BatchUpdateException Constructors.
BatchUpdateException Methods.
Inherited Methods.
Methods Defined in BatchUpdateException.

Blob Overview.
Creating a Blob Object.
Materializing Blob Data.
Storing a Blob Object.
Blob Interface Definition.
Blob Methods.

CallableStatement Overview.
Creating a CallableStatement Object.
IN Parameters.
Making Batch Updates.
OUT Parameters.
Numbering of Parameters.
INOUT Parameters.
Retrieve OUT Parameters after Results.
Retrieving NULL Values as OUT Parameters.
CallableStatement Definition.
CallableStatement Methods.
Inherited Methods.
Methods Defined in CallableStatement.

Clob Overview.
Creating a Clob Object.
Materializing Clob Data.
Storing a Clob Object.
Clob Interface Definition.
Clob Methods.

Connection Overview.
Opening a Connection.
URLs in General Use.
JDBC URLs.
The odbc Subprotocol.
Registering Subprotocols.
Sending SQL Statements.
Transactions.
Transaction Isolation Levels.
Freeing DBMS Resources.
Using Type Maps.
Connection Interface Definition.
Connection Methods.
Connection Fields.

ConnectionEvent Overview.
ConnectionEvent Definition.
ConnectionEvent Constructors.
ConnectionEvent Methods.
Methods Inherited from java.util.EventObject.
Methods Defined in javax.sql.ConnectionEvent.

ConnectionEventListener Overview.
Methods for Event Notification.
Registering a ConnectionEventListener Object.
ConnectionEventListener Definition.
ConnectionEventListener Methods.

ConnectionPoolDataSource Overview.
Connection vs. PooledConnection Objects.
ConnectionPoolDataSource Definition.
ConnectionPoolDataSource Methods.

DatabaseMetaData Overview.
Creating a DatabaseMetaData Object.
ResultSet Objects as Return Values.
String Patterns as Arguments.
Pseudo Columns.
New JDBC 2.0 Core API Features.
Getting Advanced Type Information.
DatabaseMetaData Interface Definition.
DatabaseMetaData Methods.
DatabaseMetaData Fields.

DataSource Overview.
Properties.
Using JNDI.
Creating and Registering a DataSource Object.
Connecting to a Data Source.
DataSource Implementations.
Logging and Tracing.
Advantages of Using JNDI.
DataSource Definition.
DataSource Methods.

DataTruncation Overview.
Data Truncation with No Warning or Exception.
Data Truncation on Reads.
Data Truncation on Writes.
What a DataTruncation Object Contains.
Retrieving DataTruncation Information.
DataTruncation Class Definition.
DataTruncation Constructor.
DataTruncation Methods.
Inherited Methods.
Methods Defined in DataTruncation.

Date Overview.
Creating a Date Object.
Deprecated Methods.
Retrieving a Date Object.
Advanced Features.
Date Class Definition.
Date Constructors.
Date Methods.
Inherited Methods.
Methods Defined in Date.

Distinct Types Overview.
Creating a Distinct Type Object.
Storing Distinct Objects.
Using Distinct Data Types.
Custom Mapping of Distinct Types.

Driver Overview.
Loading and Registering a Driver.
JDBC Implementation Alternatives.
Driver Interface Definition.
Driver Methods.

DriverManager Overview.
Keeping Track of Available Drivers.
Establishing a Connection.
DriverManager Methods Are Static.
DriverManager Class Definition.
DriverManager Methods.

DriverPropertyInfo Overview.
Creating a DriverPropertyInfo Object.
Getting and Setting Fields.
DriverPropertyInfo Class Definition.
DriverPropertyInfo Constructor.
DriverPropertyInfo Fields.

PooledConnection Overview.
Application Code for Connection Pooling.
How Connection Pooling Works.
The Life Cycle of a PooledConnection Object.
PooledConnection Definition.
PooledConnection Methods.

PreparedStatement Overview.
Creating PreparedStatement Objects.
Passing IN Parameters.
Data Type Conformance on IN Parameters.
Using setObject.
Sending JDBC NULL as an IN parameter.
Sending Very Large IN Parameters.
Using PreparedStatement Objects in Batch Updates.
PreparedStatement Interface Definition.
PreparedStatement Methods.
Methods Inherited from Statement.
Methods Defined in PreparedStatement.

Ref Overview.
Creating an SQL Reference.
Creating a Ref Object.
Storing a Ref Object.
Dereferencing a Ref Object.
Ref Interface Definition.
Ref Methods.

ResultSet Overview.
Rows and Columns.
Cursors.
Cursor Movement Examples.
Determining the Number of Rows in a Result Set.
Retrieving Column Values.
Which getxXX Method to Use.
Types of Result Sets.
Concurrency Types.
Providing Performance Hints.
Creating Different Types of Result Sets.
Using a Prepared Statement to Create Result Sets.
Requesting Features That Are Not Supported.
Using updatexXX Methods.
Deleting a Row.
Inserting Rows.
Positioned Updates.
Queries That Produce Updatable Result Sets.
What Is Visible to Transactions.
Visibility of Changes Made by Others.
Visibility of a Result Set's Own Changes.
Detecting Changes.
Refetching a Row.
Using Streams for Very Large Row Values.
NULL Result Values.
Optional or Multiple Result Sets.
Closing a ResultSet Object.
JDBC Compliance.
ResultSet Interface Definition.
ResultSet Methods.
ResultSet Fields.

ResultSetMetaData Overview.
Creating a ResultSetMetaData Object.
Using ResultSetMetaData.
ResultSetMetaData Interface Definition.
ResultSetMetaData Methods.
ResultSetMetaData Fields.

RowSet Overview.
The Event Model for Rowsets.
Properties for a Rowset.
Setting Parameters.
Traversing a RowSet Object.
Executing a Command.
Using a RowSet Object's Metadata.
An Example Implementation.
Overview of CachedRowSet.
Uses for a CachedRowSet Object.
Sample CachedRowSet Definition.
Creating a CachedRowSet Object.
Populating a CachedRowSet Object.
Accessing Data.
Modifying Data.
Customizing Readers and Writers.
Other Methods.
Other Possible Implementations.
JDBCRowSet Class.
The WebRowSet Class.
RowSet Definition.
RowSet Methods.
Methods Inherited from ResultSet.
Methods Defined in RowSet.
RowSet Fields.

RowSetEvent Overview.
RowSet Events.
Creating a RowSetEvent Object.
RowSetEvent Definition.
RowSetEvent Constructor.
RowSetEvent Methods.
Inherited Methods.

RowSetInternal Overview.
RowSetInternal Definition.
RowSetInternal Methods.

RowSetListener Overview.
Registering and Deregistering a Listener.
Using RowSetListener Methods.
RowSetListener Definition.
RowSetListener Methods.

RowSetMetaData Overview.
RowSetMetaData Definition.
RowSetMetaData Methods.
Methods Inherited from ResultSetMetaData.
Methods Defined in RowSetMetaData.
RowSetMetaData Fields.

RowSetReader Overview.
The Reader/Writer Framework.
Reading Data for a Disconnected Rowset.
RowSetReader Definition.
RowSetReader Methods.

RowSetWriter Overview.
RowSetWriter Definition.
RowSetWriter Methods.

SQLData Overview.
Creating a Custom Mapping.
How SQLData Retrieves an Object.
How SQLData Is Used to Store an Object.
SQLData Interface Definition.
SQLData Methods.

SQLException Overview.
What an SQLException Object Contains.
Retrieving SQLException Information.
What an SQLException Means.
SQLException Class Definition.
SQLException Constructors.
SQLException Methods.
Inherited Methods.
Methods Defined in SQLException.

SQLInput Overview.
Creating an SQLInput Object.
Using readxXX Methods.
SQLInput Interface Definition.
SQLInput Methods.

SQLOutput Overview.
SQLOutput Interface Definition.
SQLOutput Methods.

SQLWarning Overview.
What an SQLWarning Object Contains.
Retrieving SQLWarning Information.
SQLWarning Class Definition.
SQLWarning Constructors.
SQLWarning Methods.
Inherited Methods.
Methods Defined in SQLWarning.

Statement Overview.
Creating Statement Objects.
Executing Statements Using Statement Objects.
Statement Completion.
Closing Statements.
SQL Escape Syntax in Statements.
Sending Batch Updates.
Giving Performance Hints.
Executing Special Kinds of Statements.
Statement Interface Definition.
Statement Methods.

Struct Overview.
Creating an SQL Structured Type.
Storing Referenceable Instances of a Structured Type.
Creating a Struct Object.
Mapping SQL Inheritance.
Ordering of Attributes.
Storing a Struct Object.
Struct Interface Definition.
Struct Methods.

Time Overview.
Creating a Time Object.
Deprecated Methods.
Retrieving a Time Object.
Advanced Features.
Time Class Definition.
Time Constructors.
Time Methods.

Timestamp Overview.
Creating a Timestamp Object.
Retrieving a Timestamp Object.
Advanced Features.
Timestamp Class Definition.
Timestamp Constructors.
Timestamp Methods.

Overview of Class Types.
Using the Constants in Class Types.
Using the Constant OTHER.
JDBC Types Added in the JDBC 2.0 Core API.
Types Class Definition.

XAConnection Overview.
Application Code in Distributed Transactions.
Distributed Transaction Requirements.
Creating an XAConnection Object.
What an XAResource Object Does.
How the Two-phase Commit Protocol Works.
Using an XAResource Object to Commit.
The XAResource Interface.
Steps in a Distributed Transaction.
Distributed Transactions and EJB.
XAConnection Definition.
XAConnection Methods.
Methods Inherited from javax.sql.PooledConnection.
Methods Defined in XAConnection.

XADataSource Overview.
Obtaining an XADataSource Object.
XADataSource Objects and Resource Managers.
XADataSource Definition.
XADataSource Methods.

Mapping Overview.
Mapping SQL Types to Java Types.
Basic JDBC Types.
CHAR, VARCHAR, LONGVARCHAR.
BINARY, VARBINARY, LONGVARBINARY.
BIT.
TINYINT.
SMALLINT.
INTEGER.
BIGINT.
REAL.
DOUBLE.
FLOAT.
DECIMAL and NUMERIC.
DATE, TIME, and TIMESTAMP.
Advanced JDBC Data Types.
BLOB.
CLOB.
ARRAY.
DISTINCT.
STRUCT.
REF.
JAVA_OBJECT.
Examples of Mapping.
Simple SQL Statement.
SQL Statement with IN Parameters.
SQL Statement with INOUT Parameters.
Custom Mapping.
Dynamic Data Access.
Storing Java Objects in a Database.
Tables for Type Mapping.
JDBC Types Mapped to Java Types.
Java Types Mapped to JDBC Types.
JDBC Types Mapped to Java Object Types.
Java Object Types Mapped to JDBC Types.
Conversions by setObject.
Conversions by ResultSet.getxXX Methods.
Types Mapped to Database-specific SQL Types.

Requirements for All Drivers.
Implement Methods in the Interfaces.
Implement a Static Initializer.
Support Extensions to SQLÜ92 Entry Level.
Support Scalar Functions.
Provide Locks for Positioned Updates and Deletes.
Support Multithreading.
Throw Exceptions for Truncated Input Parameters.
Use Default Behaviors for SQL3 Data Types.
Permitted Variants.
When Functionality Is Not Supported.
Variation in Fundamental Properties.
Adding Functionality.
Security Responsibilities of Drivers.
Check Shared TCP Connections.
Check All Local File Access.
Assume the Worst.
Use SQLException for Exceptions.
Suggested Implementations.
Prefetch Rows.
Provide ñFinalizeî Methods for Applets.
Avoid Implementation-dependent States.

Overview of JDBC 2.0 Core API Changes.
Summary of New Functionality.
Scrollable Result Sets.
Batch Updates.
Programmatic Updates.
Other New Features.
Support for Advanced Data Types.
What Are the SQL3 Data Types?
Summary of Support for the SQL3 Data Types.
Mapping of the New SQL3 Types.
SQL Locators.
Support for Storing Java Objects.
Complete List of Core API Changes.
What Did Not Change.
Additions to Existing Interfaces and Classes.
Deprecated Methods and Constructors.
New Interfaces, Classes, and Exceptions.
JDBC Standard Extension Features.
JNDI.
Connection Pooling.
Support for Distributed Transactions.
Rowsets.
Complete List of Extension API.
Post JDBC 1.0 API Changes.
Numeric to Bignum to BigDecimal.
AutoClose Mode Dropped.
Early Design Decisions.
ResultSet.getxXX Methods.
PreparedStatement.setxXX Methods.
CallableStatement.registerOutParameter Method.
Support for Large OUT Parameters.
isNull versus wasNull.
Java Type Names or JDBC Type Names.
Where to Send Suggestions.