Java Database Connectivity
Encyclopedia : J : JA : JAV : Java Database Connectivity
JDBC is an API for the Java programming language that defines how a client may access a database. It provides methods for querying and updating data in a database. JDBC is oriented towards relational databases.
The Java Platform, Standard Edition includes the JDBC API together with an ODBC implementation of the API enabling connections to any relational database that supports ODBC. This driver is native code and not Java, and is closed source.[link]
Overview
JDBC has been part of the Java Standard Edition since the release of JDK 1.1. The JDBC classes are contained in the Java package . Starting with version 3.0, JDBC has been developed under the Java Community Process. JSR 54 specifies JDBC 3.0 (included in J2SE 1.3), JSR 114 specifies the JDBC Rowset additions, and JSR 221 is the specification of JDBC 4.0 (included in Java SE 6).
JDBC allows multiple implementations to exist and be used by the same application. The API provides a mechanism for dynamically loading the correct Java packages and registering them with the JDBC Driver Manager. The Driver Manager is used as a connection factory for creating JDBC connections.
JDBC connections support creating and executing statements. These statements may be update statements such as SQL INSERT, UPDATE and DELETE or they may be query statements using the SELECT statement. Additionally, stored procedures may be invoked through a statement. Statements are one of the following types:
- – the statement is sent to the database server each and every time.
- – the statement is cached and then the execution path is pre determined on the database server allowing it to be executed multiple times in an efficient manner.
- – used for executing stored procedures on the database.
Query statements return a JDBC row result set. The row result set is used to walk over the result set. Individual columns in a row are retrieved either by name or by column number. There may be any number of rows in the result set. The row result set has metadata that describes the names of the columns and their types.
There is an extension to the basic JDBC API in the package that allows for scrollable result sets and cursor support among other things.
Example
The method is used to load the JDBC driver class. The line below causes the JDBC driver from some jdbc vendor to be loaded into the application.
Class.forName( "com.somejdbcvendor.TheirJdbcDriver" );When a class is loaded, it creates an instance of itself and registers it with the . This can be done by including the needed code in the driver class's
static block. e.g. DriverManager.registerDriver(Driver driver)
Now when a connection is needed, one of the DriverManager.getConnection() methods is used to create a JDBC connection.
Connection conn = DriverManager.getConnection( "jdbc:somejdbcvendor:other data needed by some jdbc vendor", "myLogin", "myPassword" );The URL used is dependent upon the particular JDBC driver. It will always begin with the "jdbc:" protocol, but the rest is upto the particular vendor. Once a connection is established, a statement must be created.
Statement stmt = conn.createStatement(); stmt.executeUpdate( "INSERT INTO MyTable( name ) VALUES ( 'my name' ) " );Data is retrieved from the database using a database query mechanism. The example below shows creating a statement and executing a query.
Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery( "SELECT * FROM MyTable" ); while ( rs.next() ) } rs.close(); stmt.close();Typically, however, it would be rare for a seasoned Java programmer to code in such a fashion. The usual practice would be to abstract the database logic into an entirely different class and to pass preprocessed strings (perhaps derived themselves from a further abstracted class) containing SQL statements and the connection to the required methods. Abstracting the data model from the application code makes it more likely that changes to the application and data model can be made independently.
An example of a PreparedStatement query. Using conn and class from first example.
PreparedStatement ps = null; ResultSet rs = null; try } } catch (SQLException e) finally catch( SQLException e) // handle errors here or ignore them }Here are examples of host database types, Java can convert to with a function.
| Oracle Datatype | setXXX() |
|---|---|
|
CHAR
|
setString()
|
|
VARCHAR2
|
setString()
|
|
NUMBER
| setBigDecimal() |
|
setBoolean()
|
|
|
setByte()
|
|
|
setShort()
|
|
|
setInt()
|
|
|
setLong()
|
|
|
setFloat()
|
|
|
setDouble()
|
|
| INTEGER | setInt() |
| FLOAT | setDouble() |
| CLOB | setClob() |
| BLOB | setBlob() |
|
RAW
|
setBytes()
|
|
LONGRAW
|
setBytes()
|
|
DATE
|
setDate()
|
|
setTime()
|
|
|
setTimestamp()
|
For an example of a CallableStatement (to call stored procedures in the database), see the [http://java.sun.com/j2se/1.5.0/docs/guide/jdbc/getstart/callablestatement.html JDBC API Guide].
Drivers
Types
There are commercial and free drivers available for most relational database servers. These drivers fall into one of the following types:
- Type 1, the JDBC-ODBC bridge
- Type 2, the Native-API driver
- Type 3, the network-protocol driver
- Type 4, the native-protocol drivers
- Internal JDBC driver, driver embedded with JRE in Java-enabled SQL databases. Used for Java stored procedures.
- JDBC URL, all Database Connection String
Sources
- [SQLSummit.com] publishes list of drivers, including JDBC drivers and vendors
- Sun Microsystems provides a [list of some JDBC drivers and vendors]
- [Simba Technologies] ships an SDK for building custom JDBC Drivers for any custom/proprietary relational data source
- [DataDirect Technologies] provides a comprehensive suite of fast Type 4 JDBC drivers for all major database
- [i-net software] provides fast Type 4 JDBC drivers for all major databases
- [OpenLink Software] ships JDBC Drivers for a number of target databases, including Bridges to other data access mechanisms (e.g., ODBC, JDBC) which can provide more functionality than the targeted mechanism
External links
- [http://java.sun.com/j2se/1.5.0/docs/guide/jdbc JDBC API Guide]
- API Javadoc documentation
- API Javadoc documentation
- [DataDirect Technologies - JDBC Code Samples]
- [Sun tutorial]
- [Duke's Bakery - A JDBC Order Entry Prototype]
- [DBAccessor: A JDBC Wrapper Package]
- [List of Java Open Source Databases with JDBC drivers]
- [A sample implementation of a tiny-JDBC layer for an embedded DBMS] (PDF) by Federico Maggi (Introduction in both Italian and English: Other chapters in English)
- [JDBC Articles and Resources]
From Wikipedia, the Free Encyclopedia. Original article here. Support Wikipedia by contributing or donating.
All text is available under the terms of the GNU Free Documentation License See Wikipedia Copyrights for details.
