Sun Microsystems released JDBC as part of Java Development Kit (JDK) 1.1 on February 19, 1997.1 Since then it has been part of the Java Platform, Standard Edition (Java SE).
The JDBC classes are contained in the Java package java.sql and javax.sql.
Starting with version 3.1, JDBC has been developed under the Java Community Process. JSR 54 specifies JDBC 3.0 (included in J2SE 1.4), JSR 114 specifies the JDBC Rowset additions, and JSR 221 is the specification of JDBC 4.0 (included in Java SE 6).2
JDBC 4.1, is specified by a maintenance release 1 of JSR 2213 and is included in Java SE 7.4
JDBC 4.2, is specified by a maintenance release 2 of JSR 2215 and is included in Java SE 8.6
The latest version, JDBC 4.3, is specified by a maintenance release 3 of JSR 2217 and is included in Java SE 9.8
Since JDBC is mostly a collection of interface definitions and specifications, it allows multiple implementations of these interfaces to exist and be used by the same application at runtime. The API provides a mechanism for dynamically loading the correct Java packages and registering them with the JDBC Driver Manager (DriverManager). DriverManager is used as a Connection factory for creating JDBC connections.
JDBC connections support creating and executing statements. JDBC connections support update statements such as SQL's CREATE, INSERT, UPDATE and DELETE, or query statements such as SELECT. Additionally, stored procedures may be invoked through a JDBC connection. JDBC represents statements using one of the following classes:
PreparedStatement allows the dynamic query to vary depending on the query parameter.15
Update statements such as INSERT, UPDATE and DELETE return an update count indicating the number of rows affected in the database as an integer.20 These statements do not return any other information.
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 javax.sql.
JDBC connections are often managed via a connection pool rather than obtained directly from the driver.21
When a Java application needs a database connection, one of the DriverManager.getConnection() methods is used to create a JDBC Connection. The URL used is dependent upon the particular database and JDBC driver. It will always begin with the "jdbc:" protocol, but the rest is up to the particular vendor.
Starting from Java SE 7 you can use Java's try-with-resources statement to simplify the above code:
Once a connection is established, a Statement can be created.
Note that Connections, Statements, and ResultSets often tie up operating system resources such as sockets or file descriptors. In the case of Connections to remote database servers, further resources are tied up on the server, e.g. cursors for currently open ResultSets. It is vital to close() any JDBC object as soon as it has played its part; garbage collection should not be relied upon. The above try-with-resources construct is a code pattern that obviates this.
Data is retrieved from the database using a database query mechanism. The example below shows creating a statement and executing a query.
The following code is an example of a PreparedStatement query which uses conn and class from the first example:
If a database operation fails, JDBC raises an SQLException. There is typically very little one can do to recover from such an error, apart from logging it with as much detail as possible. It is recommended that the SQLException be translated into an application domain exception (an unchecked one) that eventually results in a transaction rollback and a notification to the user.
The following code is an example of a database transaction:
For an example of a CallableStatement (to call stored procedures in the database), see the JDBC API Guide documentation.
Main article: JDBC driver
JDBC drivers are client-side adapters (installed on the client machine, not on the server) that convert requests from Java programs to a protocol that the DBMS can understand.
Commercial and free drivers provide connectivity to most relational-database servers. These drivers fall into one of the following types:
Note also a type called an internal JDBC driver - a driver embedded with JRE in Java-enabled SQL databases. It is used for Java stored procedures. This does not fit into the classification scheme above, although it would likely resemble either a type 2 or type 4 driver (depending on whether the database itself is implemented in Java or not). An example of this is the KPRB (Kernel Program Bundled) driver23 supplied with Oracle RDBMS. "jdbc:default:connection" offers a relatively standard way of making such a connection (at least the Oracle database and Apache Derby support it). However, in the case of an internal JDBC driver, the JDBC client actually runs as part of the database being accessed, and so can access data directly rather than through network protocols.
"Sun Ships JDK 1.1 -- Javabeans Included". www.sun.com. Sun Microsystems. 1997-02-19. Archived from the original on 2008-02-10. Retrieved 2010-02-15. February 19, 1997 - The JDK 1.1 [...] is now available [...]. This release of the JDK includes: [...] Robust new features including JDBC for database connectivity https://web.archive.org/web/20080210044125/http://www.sun.com/smi/Press/sunflash/1997-02/sunflash.970219.0001.xml ↩
JDBC API Specification Version: 4.0. http://java.sun.com/products/jdbc/download.html#corespec40 ↩
"The Java Community Process(SM) Program - communityprocess - mrel". jcp.org. Retrieved 22 March 2018. http://jcp.org/aboutJava/communityprocess/mrel/jsr221/index.html ↩
"JDBC 4.1". docs.oracle.com. Retrieved 22 March 2018. http://docs.oracle.com/javase/7/docs/technotes/guides/jdbc/jdbc_41.html ↩
"The Java Community Process(SM) Program - communityprocess - mrel". jcp.org. Retrieved 22 March 2018. https://jcp.org/aboutJava/communityprocess/mrel/jsr221/index2.html ↩
"JDBC 4.2". docs.oracle.com. Retrieved 22 March 2018. http://docs.oracle.com/javase/8/docs/technotes/guides/jdbc/jdbc_42.html ↩
"The Java Community Process(SM) Program - communityprocess - mrel". jcp.org. Retrieved 22 March 2018. https://jcp.org/aboutJava/communityprocess/mrel/jsr221/index3.html ↩
"java.sql (Java SE 9 & JDK 9)". docs.oracle.com. Retrieved 22 March 2018. http://docs.oracle.com/javase/9/docs/api/java/sql/package-summary.html ↩
Bai 2022, p. 74. - Bai, Ying (2022). SQL Server Database Programming with Java. Cham: Springer International Publishing. doi:10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1. https://doi.org/10.1007%2F978-3-031-06553-8 ↩
Bai 2022, pp. 122–124, §4.2.3.5 More About the Execution Methods. - Bai, Ying (2022). SQL Server Database Programming with Java. Cham: Springer International Publishing. doi:10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1. https://doi.org/10.1007%2F978-3-031-06553-8 ↩
Bai 2022, pp. 72–74, §3.2 JDBC Components and Architecture. - Bai, Ying (2022). SQL Server Database Programming with Java. Cham: Springer International Publishing. doi:10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1. https://doi.org/10.1007%2F978-3-031-06553-8 ↩
Horstmann 2022, §5.5.3 SQL Escapes. - Horstmann, Cay (April 15, 2022). Core Java. Oracle Press Java. ISBN 978-0-13-787107-0. ↩
Bai 2022, pp. 122–124, §4.2.3.5 JDBC Components and Architecture. - Bai, Ying (2022). SQL Server Database Programming with Java. Cham: Springer International Publishing. doi:10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1. https://doi.org/10.1007%2F978-3-031-06553-8 ↩
Bai 2022, p. 83, §3.5.1 JDBC DataSource. - Bai, Ying (2022). SQL Server Database Programming with Java. Cham: Springer International Publishing. doi:10.1007/978-3-031-06553-8. ISBN 978-3-030-92686-1. https://doi.org/10.1007%2F978-3-031-06553-8 ↩
"Java JDBC API". docs.oracle.com. Retrieved 22 March 2018. https://docs.oracle.com/javase/8/docs/technotes/guides/jdbc/ ↩
Greenwald, Rick; Stackowiak, Robert; Stern, Jonathan (1999). Oracle Essentials: Oracle Database 10g. Essentials Series (3 ed.). Sebastopol, California: O'Reilly Media, Inc. (published 2004). p. 318. ISBN 9780596005856. Retrieved 2016-11-03. The in-database JDBC driver (JDBC KPRB)[:] Java code uses the JDBC KPRB (Kernel Program Bundled) version to access SQL on the same server. 9780596005856 ↩
"JDBC Drivers - CData Software". CData Software. Retrieved 22 March 2018. http://www.cdata.com/jdbc/ ↩
"JDBC Drivers - CData Software". CData Software. Archived from the original on 22 December 2015. Retrieved 22 March 2018. https://web.archive.org/web/20151222115409/http://www.rssbus.com/jdbc/ ↩
"New Type 5 JDBC Driver — DataDirect Connect". http://www.datadirect.com/products/features/data-connectivity/type-5-jdbc/index.html ↩
"Access External Databases from RPG with JDBCR4 Meat of the Matter". 28 June 2012. Retrieved 12 April 2016. http://iprodeveloper.com/rpg-programming/access-external-databases-rpg-jdbcr4 ↩
Sualeh Fatehi. "SchemaCrawler". GitHub. https://github.com/schemacrawler/SchemaCrawler ↩