JDBC接口概述

一、JDBC for WHY

JDBC（Java Data Base Connectivity,java数据库连接）是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问，它由一组用Java语言编写的类和接口组成。JDBC为工具/数据库开发人员提供了一个标准的API，据此可以构建更高级的工具和接口，使数据库开发人员能够用纯 Java API 编写数据库应用程序，同时，JDBC也是个商标名。

有了JDBC，向各种关系数据发送SQL语句就是一件很容易的事。换言之，有了JDBC API，就不必为访问Sysbase数据库专门写一个程序，为访问Oracle数据库又专门写一个程序，或为访问Informix数据库又编写另一个程序等等，程序员只需用JDBC API写一个程序就够了，它可向相应数据库发送SQL调用。同时，将Java语言和JDBC结合起来使程序员不必为不同的平台编写不同的应用程序，只须写一遍程序就可以让它在任何平台上运行，这也是Java语言“编写一次，处处运行”的优势。

二、JDBC for HOW
JDBC是由一系列连接（Connection）、SQL语句（Statement）和结果集（ResultSet）构成的，其主要作用概括起来有如下3个方面：
1.建立与数据库的连接。
2.向数据库发起查询请求。
3.处理数据库返回结果。
这些作用是通过一系列API实现的，其中的几个重要接口如下表所示。
这些接口的使用方法如下：

1)DriverManager
DriverManager类是Java.sql包中用于数据库驱动程序管理的类，作用于用户和驱动程序之间。它跟踪可用的驱动程序，并在数据库和相应驱动程序之间建立连接，也处理诸如驱动程序登录时间限制及登录和跟踪消息的显示等事务。DriverManager 类直接继承自java.lang.object，其主要成员方法如下表所示。

对于简单的应用程序，程序开发人员需要在此类中直接使用的惟一方法是 DriverManager.getConnection。该方法是用来建立与数据库的连接的。JDBC 允许用户调用 DriverManager 的方法 getDriver、getDrivers 和 registerDriver 及 Driver 的方法 connect。但多数情况下，最好让 DriverManager 类管理建立连接的细节。

2)Connection
Connection是用来表示数据库连接的对象，对数据库的一切操作都是在这个连接的基础上进行的。Connection类的主要成员方法如下表所示：


3.1)Statement
Statement用于在已经建立的连接的基础上向数据库发送SQL语句的对象。它只是一个接口的定义，其中包括了执行SQL语句和获取返回结果的方法。实际上有3种 Statement 对象：Statement、PreparedStatement（继承自Statement ）和 CallableStatement（继承自PreparedStatement）。它们都作为在给定连接上执行 SQL 语句的容器，每个都专用于发送特定类型的 SQL 语句： Statement 对象用于执行不带参数的简单 SQL 语句；PreparedStatement 对象用于执行带或不带 IN 参数的预编译 SQL 语句；CallableStatement 对象用于执行对数据库已存储过程的调用。Statement 接口提供了执行语句和获取结果的基本方法；PreparedStatement 接口添加了处理 IN 参数的方法；而 CallableStatement 添加了处理 OUT 参数的方法。
创建statement对象的方法如下：

Statement stmt = con.createStatement()

Statement接口定义中包括的方法如下表所示：


值得注意的是，Statement 接口提供了3种执行SQL语句的方法：executeQuery、executeUpdate和execute。使用哪一个方法由SQL语句所产生的内容决定。executeQuery方法用于产生单个结果集的SQL语句，如SELECT语句。executeUpdate方法用于执行INSERT、UPDATE、DELETE及DDL（数据定义语言）语句，例如CREATE TABLE 和 DROP TABLE。executeUpdate 的返回值是一个整数，表示它执行的SQL语句所影响的数据库中的表的行数（更新计数）。execute 方法用于执行返回多个结果集或多个更新计数的语句。

3.2)PreparedStatement
该接口继承了Statement接口，但PreparedStatement语句中包含了经过预编译的SQL语句，因此可以获得更高的执行效率。在PreparedStatement语句中可以包含多个用"？"代表的字段，在程序中可以利用setXXX方法设置该字段的内容，从而增强了程序设计的动态性。PreparedStatement接口的主要成员方法及其含义如下表所示：

PreparedStatement与Statement的区别在于它构造的SQL语句不是完整的语句，而需要在程序中进行动态设置。这一方面增强了程序设计的灵活性；另一方面，由于PreparedStatement语句是经过预编译的，因此它构造的SQL语句的执行效率比较高。所以对于某些使用频繁的SQL语句，用PreparedStatement语句比用Statement具有明显的优势
PreparedStatement对象的创建方法如下：

PreparedStatement pstmt = con.prepareStatement("update tbl_User set reward = ? where userId = ?");

在该语句中，包括两个可以进行动态设置的字段：reward和userId。
例如，我们想给第一个注册的用户5000点奖励，则可以用下面的方法设置空字段的内容：

pstmt.setInt(1, 5000);
pstmt. setInt (2, 1);

如果我们想给前50个注册的用户每人5000点奖励，则可以用循环语句对空字段进行设置：

pstmt.setInt(1, 5000);
for (int i = 0; i < 50; i++)
{
   pstmt.setInt(2,i);
   int rowCount = pstmt.executeUpdate();
}

如果传递的数据量很大，则可以通过将 IN 参数设置为 Java 输入流来完成。当语句执行时，JDBC驱动程序将重复调用该输入流，读取其内容并将它们当做实际参数数据传输。JDBC 提供了3种将IN参数设置为输入流的方法：setBinaryStream用于含有未说明字节的流；setAsciiStream用于含有ASCII字符的流；setUnicodeStream用于含有Unicode字符的流。这些方法比其他的setXXX方法要多一个用于指定流的总长度的参数，因为一些数据库在发送数据之前需要知道它传送的数据的大小。
下面是一个使用流作为 IN 参数发送文件内容的例子：

java.io.File file = new java.io.File("/tmp/data");
int fileLength = file.length();
java.io.InputStream fin = new java.io.FileInputStream(file);
java.sql.PreparedStatement pstmt = con.prepareStatement(
"update table set stuff = ? where index = 4");
pstmt.setBinaryStream (1, fin, fileLength);
pstmt.executeUpdate();

当语句执行时，将反复调用输入流 fin 以传递其数据。

3.3)CallableStatement
该对象用于执行对数据库已存储过程的调用。在CallableStatement对象中，有一个通用的成员方法call，这个方法用于以名称的方式调用数据库中的存储过程。在数据库调用过程中，可以通过设置IN参数向调用的存储过程提供执行所需的参数。另外，在存储过程的调用中，通过OUT参数获取存储过程的执行结果。
CallableStatement 接口的主要成员方法及其含义如下表所示：

调用存储过程的语法为：

{call procedure_name}              // 过程不需要参数
{call procedure_name[(?,?,?,…)]}    // 过程需要若干个参数
{? = call procedure_name[(?,?,?,…)]} //过程需要若干个参数并返回一个参数

其中procedure_name为存储过程的名字，方括号中的内容是可选的多个用于存储过程执行的参数。CallableStatement 对象的创建方法如下：
CallableStatement cstmt = con.prepareCall("{call getData(?, ?)}");
向存储过程传递执行需要参数的方法是通过setXXX语句完成的。例如，我们可以将两个参数设置如下：

cstmt.setByte(1, 25);
cstmt.setInt(2,64.85);

如果需要存储过程返回运行结果，则需要调用registerOutParameter方法设置存储过程的输出参数，然后调用getXXX方法来获取存储过程的执行结果。例如：

cstmt.registerOutParameter(1, java.sql.Types.TINYINT);
cstmt.registerOutParameter(1, java.sql.Types. INTEGER);
cstmt.executeUpdate();
byte a = cstmt.getByte(1);
int b = cstmt.getInt(2);

从上面的程序可以看出，Java的基本数据类型和SQL中支持的数据类型有一定的对应关系。这种对应关系如下表所示：

4)ResultSet
结果集（ResultSet）用来暂时存放数据库查询操作获得的结果。它包含了符合 SQL 语句中条件的所有行，并且它提供了一套 get 方法对这些行中的数据进行访问。ResultSet类的主要成员方法及其含义如下表所示：


从表中可以看出，ResultSet类不仅提供了一套用于访问数据的get方法，还提供了很多移动指针（cursor，有时也译为光标）的方法。cursor是ResultSet 维护的指向当前数据行的指针。最初它位于第一行之前，因此第一次访问结果集时通常调用 next方法将指针置于第一行上，使它成为当前行。随后每次调用 next 指针向下移动一行。