Java数据库接口JDBC入门(中)

yyli258

贡献于2013-12-19

字数:0 关键词: Java开发 Java

Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 Java 数据库接口 JDBC 入门基础讲座 来自:天极网 内容简介: JDBC 是 Sun 提供的一套数据库编程接口 API 函数,由 Java 语言编写的类、界面组 成。用 JDBC 写的程序能够自动地将 SQL 语句传送给相应的数据库管理系统。不但如此, 使用 Java 编写的应用程序可以在任何支持 Java 的平台上运行,不必在不同的平台上编 写不同的应用。Java 和 JDBC 的结合可以让开发人员在开发数据库应用程序时真正实现 “WriteOnce,RunEverywhere!” 注: 本教程来源于互联网,版权归原作者和出版商所有,仅供个人学习、参考之用,请勿保 存、转载发布、以及用于商业用途,请支持正版。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第一讲 慨述 概述 1.1 什么是 JDBCTM? JDBCTM 是一种用于执行 SQL 语句的 JavaTM API(有意思的是,JDBC 本身是个商标名而不是 一个缩写字;然而,JDBC 常被认为是代表 “Java 数据库连接 (Java Database Connectivity)”)。 它由一组用 Java 编程语言编写的类和接口组成。JDBC 为工具/数据库开发人员提供了一个标准的 API,使他们能够用纯 Java API 来编写数据库应用程序。 有了 JDBC,向各种关系数据库发送 SQL 语句就是一件很容易的事。换言之,有了 JDBC API, 就不必为访问 Sybase 数据库专门写一个程序,为访问 Oracle 数据库又专门写一个程序,为访问 Informix 数据库又写另一个程序,等等。您只需用 JDBC API 写一个程序就够了,它可向相应数据 库发送 SQL 语句。而且,使用 Java 编程语言编写的应用程序,就无须去忧虑要为不同的平台编写 不同的应用程序。将 Java 和 JDBC 结合起来将使程序员只须写一遍程序就可让它在任何平台上运 行。 Java 具有坚固、安全、易于使用、易于理解和可从网络上自动下载等特性,是编写数据库应用 程序的杰出语言。所需要的只是 Java 应用程序与各种不同数据库之间进行对话的方法。而 JDBC 正 是作为此种用途的机制。 JDBC 扩展了 Java 的功能。例如,用 Java 和 JDBC API 可以发布含有 applet 的网页,而该 applet 使用的信息可能来自远程数据库。企业也可以用 JDBC 通过 Intranet 将所有职员连到一个 或多个内部数据库中(即拐庑┲霸彼 玫募扑慊 ?Windows、 Macintosh 和 UNIX 等各种不同的操 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 作系统)。随着越来越多的程序员开始使用 Java 编程语言,对从 Java 中便捷地访问数据库的要 求也在日益增加。 MIS 管理员们都喜欢 Java 和 JDBC 的结合,因为它使信息传播变得容易和经济。企业可继续 使用它们安装好的数据库,并能便捷地存取信息,即使这些信息是储存在不同数据库管理系统上。 新程序的开发期很短。安装和版本控制将大为简化。程序员可只编写一遍应用程序或只更新一次, 然后将它放到服务器上,随后任何人就都可得到最新版本的应用程序。对于商务上的销售信息服务, Java 和 JDBC 可为外部客户提供获取信息更新的更好方法。 1.1.1 JDBC 的用途是什么? 简单地说,JDBC 可做三件事: 与数据库建立连接, 发送 SQL 语句, 处理结果。 下列代码段给出了以上三步的基本示例: Connection con = DriverManager.getConnection ("jdbc:odbc:wombat", "login", "password"); Statement stmt = con.createStatement(); ResultSet rs = stmt.executeQuery("SELECT a, b, c FROM Table1"); while (rs.next()) System.out.println(rs.getString("a") + " " + rs.getString("b") + " " + rs.getString("c")); Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 1.1.2 JDBC 是一种低级 API ,是高级 API 的基础 JDBC 是个“低级”接口,也就是说,它用于直接调用 SQL 命令。在这方面它的功能极佳,并 比其它的数据库连接 API 易于使用,但它 同时也被设计为一种基础接口,在它之上可以建立高级接 口和工具。 高级接口是“对用户友好的”接口,它使用的是一种更易理解和更为方便的 API,这种 API 在 幕后被转换为诸如 JDBC 这样的低级接口。在编写本文时,正在开发两种基于 JDBC 的高级 API: 一种用于 Java 的嵌入式 SQL。至少已经有一个提供者计划编写它。DBMS 实现 SQL:一种专门 设计来与数据库联合使用的语言。JDBC 要求 SQL 语句必须作为 String 传给 Java 方法。相反, 嵌入式 SQL 预处理器允许程序员将 SQL 语句直接与 Java 混在一起使用。例如,可在 SQL 语句中 使用 Java 变量,用以接受或提供 SQL 值。然后,嵌入式 SQL 预处理器将通过 JDBC 调用把这种 Java/SQL 的混合物转换为 Java。关系数据库表到 Java 类的直接映射。JavaSoft 和其它提供者都 声称要实现该 API。在这种“对象/关系”映射中,表中的每行对应于类的一个实例,而每列的值对 应于该实例的一个属性。于是,程序员可直接对 Java 对象进行操作;存取数据所需的 SQL 调用将 在“掩盖下”自动生成。此外还可提供更复杂的映射,例如将多个表中的行结合进一个 Java 类中。 随着人们对 JDBC 的兴趣日益增涨,越来越多的开发人员一直在使用基于 JDBC 的工具,以使 程序的编写更加容易。程序员也一直在编写力图使最终用户对数据库的访问变得更为简单的应用程 序。例如,应用程序可提供一个选择数据库任务的菜单。任务被选定后,应用程序将给出提示及空 白供填写执行选定任务所需的信息。所需信息输入后,应用程序将自动调用所需的 SQL 命令。在这 样一种程序的协助下,即使用户根本不懂 SQL 的语法,也可以执行数据库任务。 1.1.3 JDBC 与 ODBC 和其它 API 的比较 目前,Microsoft 的 ODBC(开放式数据库连接)API 可能是使用最广的、用于访问关系数据库 的编程接口。它能在几乎所有平台上连接几乎所有的数据库。为什么 Java 不使用 ODBC? Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 对这个问题的回答是:Java 可以使用 ODBC,但最好是在 JDBC 的帮助下以 JDBC-ODBC 桥的形 式使用,这一点我们稍后再说。现在的问题已变成:“为什么需要 JDBC”? 回答如下:ODBC 不适 合直接在 Java 中使用,因为它使用 C 语言接口。从 Java 调用本地 C 代码在安全性、实现、坚 固性和程序的自动移植性方面都有许多缺点。 从 ODBC API 到 Java API 的字面翻译是不可取的。例如,Java 没有指针,而 ODBC 却对指针 用得很广泛(包括很容易出错的指针 "void *")。您可以将 JDBC 想象成被转换为面向对象接口的 ODBC,而面向对象的接口对 Java 程序员来说较易于接收。ODBC 很难学。它把简单和高级功能混在 一起,而且即使对于简单的查询,其选项也极为复杂。相反,JDBC 尽量保证简单功能的简便性,而 同时在必要时允许使用高级功能。启用“纯 Java ”机制需要象 JDBC 这样的 Java API。如果使用 ODBC,就必须手动地将 ODBC 驱动程序管理器和驱动程序安装在每台客户机上。如 果 完 全 用 Java 编 写 JDBC 驱动程序则 JDBC 代码在所有 Java 平台上(从网络计算机到大型机)都可以自动安装、 移植并保证安全性。 总之,JDBC API 对于基本的 SQL 抽象和概念是一种自然的 Java 接口。它建立在 ODBC 上而 不是从零开始。因此,熟悉 ODBC 的程序员将发现 JDBC 很容易使用。JDBC 保留了 ODBC 的基本设 计特征;事实上,两种接口都基于 X/Open SQL CLI(调用级接口)。它们之间最大的区别在于:JDBC 以 Java 风格与优点为基础并进行优化,因此更加易于使用。 最近,Microsoft 又引进了 ODBC 之外的新 API: RDO、 ADO 和 OLE DB。这些设计在许多方 面与 JDBC 是相同的,即它们都是面向对象的数据库接口且基于可在 ODBC 上实现的类。但在这些 接口中,我们未看见有特别的功能使我们要转而选择它们来替代 ODBC,尤其是在 ODBC 驱动程序已 建立起较为完善的市场的情况下。它们最多也就是在 ODBC 上加了一种装饰而已。这并不是说 JDBC 不需要从其最初的版本再发展了;然而,我们觉得大部份的新功能应归入诸如前一节中所述的对象/ 关系映射和嵌入式 SQL 这样的高级 API。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 1.1.4 两层模型和三层模型 JDBC API 既支持数据库访问的两层模型,同时也支持三层模型。 在两层模型中,Java applet 或应用程序将直接与数据库进行对话。这将需要一个 JDBC 驱动 程序来与所访问的特定数据库管理系统进行通讯。用 户 的 SQL 语句被送往数据库中,而其结果将被 送回给用户。数据库可以位于另一台计算机上,用户通过网络连接到上面。这就叫做客户机/服务器 配置,其中用户的计算机为客户机,提供数据库的计算机为服务器。网络可以是 Intranet(它可将 公司职员连接起来),也可以是 Internet。 在三层模型中,命令先是被发送到服务的“中间层”,然后由它将 SQL 语句发送给数据库。数 据库对 SQL 语句进行处理并将结果送回到中间层,中间层再将结果送回给用户。MIS 主管们都发现 三层模型很吸引人,因为可用中间层来控制对公司数据的访问和可作的的更新的种类。中间层的另 一个好处是,用户可以利用易于使用的高级 API,而中间层将把它转换为相应的低级调用。最后, 许多情况下三层结构可提供一些性能上的好处。 到目前为止,中间层通常都用 C 或 C++ 这类语言来编写,这些语言执行速度较快。然而,随 着最优化编译器(它把 Java 字节代码转换为高效的特定于机器的代码)的引入,用 Java 来实现 中间层将变得越来越实际。这将是一个很大的进步,它使人们可以充分利用 Java 的诸多优点(如 坚固、多线程和安全等特征)。JDBC 对于从 Java 的中间层来访问数据库非常重要。 1.1.5 SQL 的一致性 结构化查询语言 (SQL) 是访问关系数据库的标准语言。困难之处在于:虽然大多数的 DBMS (数 据库管理系统)对其基本功能都使用了标准形式的 SQL,但它们却不符合最近为更高级的功能定义 的标准 SQL 语法或语义。例如,并非所有的数据库都支持储存程序或外部连接,那些支持这一功能 的数据库又相互不一致。人们希望 SQL 中真正标准的那部份能够进行扩展以包括越来越多的功能。 但同时 JDBC API 又必须支持现有的 SQL。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 JDBC API 解决这个问题的一种方法是允许将任何查询字符串一直传到所涉及的 DBMS 驱动程序 上。这意味着应用程序可以使用任意多的 SQL 功能,但 它 必 须 冒 这 样 的 风险:有可能在某些 DBMS 上 出错。事实上,应用程序查询甚至不一定要是 SQL,或者说它可以是个为特定的 DBMS 设计的 SQL 的 专用派生物(例如,文档或图象查)。 JDBC 处理 SQL 一致性问题的第二种方法是提供 ODBC 风格的转义子句。这将在 4.1.5 节“语 句对象中的 SQL 转义语法”中讨论。 转义语法为几个常见的 SQL 分歧提供了一种标准的 JDBC 语法。例如,对日期文字和已储存过 程的调用都有转义语法。 对于复杂的应用程序,JDBC 用第三种方法来处理 SQL 的一致性问题。它利用 DatabaseMetaData 接口来提供关于 DBMS 的描述性信息,从而使应用程序能适应每个 DBMS 的要求和功能。 由于 JDBC API 将用作开发高级数据库访问工具和 API 的基础 API,因此它还必须注意其所有 上层建筑的一致性。“符合 JDBC 标准 TM" 代表用户可依赖的 JDBC 功能的标准级别。要使用这一 说明,驱动程序至少必须支持 ANSI SQL-2 EntryLevel(ANSI SQL-2 代表美国国家标准局 1992 年 所采用的标准。Entry Level 代表 SQL 功能的特定清单)。驱动程序开发人员可用 JDBC API 所带 的测试工具包来确定他们的驱动程序是否符合这些标准。 “符合 JDBC 标准 TM” 表示提供者的 JDBC 实现已经通过了 JavaSoft 提供的一致性测试。 这些一致性测试将检查 JDBCAPI 中定义的所有类和方法是否都存在,并尽可能地检查程序是否具有 SQL Entry Level 功能。当然,这些测试并不完全,而且 JavaSoft 目前也无意对各提供者的实现 进行标级。但这种一致性定义的确可对 JDBC 实现提供一定的可信度。随着越来越多的数据库提供 者、连接提供者、Internet 提供者和应用程序编程员对 JDBC API 的接受,JDBC 也正迅速成为 Java 数据库访问的标准。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 1.2 JDBC 产品 在编写本文时,有几个基于 JDBC 的产品已开发完毕或正在开发中。当然,本节中的信息将很 快成为过时信息。因此,有关最新的信息,请查阅 JDBC 的网站,可 通过从以下 URL 开始浏览找到: http://java.sun.com/products/jdbc 1.2.1 JavaSoft 框架 JavaSoft 提供三种 JDBC 产品组件,它们是 Java 开发工具包 (JDK) 的组成部份:JDBC 驱动 程序管理器,JDBC 驱动程序测试工具包,和 JDBC-ODBC 桥。 JDBC 驱动程序管理器是 JDBC 体系结构的支柱。它实际上很小,也很简单;其主要作用是把 Java 应用程序连接到正确的 JDBC 驱动程序上,然后即退出。 JDBC 驱动程序测试工具包为使 JDBC 驱动程序运行您的程序提供一定的可信度。只有通过 JDBC 驱动程序测试包的驱动程序才被认为是符合 JDBC 标准 TM 的。 JDBC-ODBC 桥使 ODBC 驱动程序可被用作 JDBC 驱动程序。它的实现为 JDBC 的快速发展提供 了一条途径,其长远目标提供一种访问某些不常见的 DBMS(如果对这些不常见的 DBMS 未实现 JDBC) 的方法。 1.2.2 JDBC 驱动程序的类型 我们目前所知晓的 JDBC 驱动程序可分为以下四个种类: JDBC-ODBC 桥加 ODBC 驱动程序:JavaSoft 桥产品利用 ODBC 驱动程序提供 JDBC 访问。注意, 必须将 ODBC 二进制代码(许多情况下还包括数据库客户机代码)加载到使用该驱动程序的每个客 户机上。因此,这种类型的驱动程序最适合于企业网(这种网络上客户机的安装不是主要问题), 或者是用 Java 编写的三层结构的应用程序服务器代码。 本地 API - 部份用 Java 来编写的驱动程序: 这种类型的驱动程序把客户机 API 上的 JDBC 调用转换为 Oracle、Sybase、Informix、DB2 或其它 DBMS 的调用。注意,象桥驱动程序一样,这 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 种类型的驱动程序要求将某些二进制代码加载到每台客户。 JDBC 网络纯 Java 驱动程序:这 种驱 动程序将 JDBC 转换为与 DBMS 无关的网络协议,之后这 种协议又被某个服务器转换为一种 DBMS 协议。这种网络服务器中间件能够将它的纯 Java 客户机 连接到多种不同的数据库上。所用的具体协议取决于提供者。通常,这是最为灵活的 JDBC 驱动程 序。有可能所有这种解决方案的提供者都提供适合于 Intranet 用的产品。为了使这些产品也支持 Internet 访问,它们必须处理 Web 所提出的安全性、通过防火墙的访问等方面的额外要求。几家 提供者正将 JDBC 驱动程序加到他们现有的数据库中间件产品中。 本地协议纯 Java 驱动程序:这种类型的驱动程序将 JDBC 调用直接转换为 DBMS 所使用的网 络协议。这将允许从客户机机器上直接调用 DBMS 服务器,是 Intranet 访问的一个很实用的解决 方法。由于许多这样的协议都是专用的,因此数据库提供者自己将是主要来源,有几家提供者已在 着手做这件事了。最后,我们预计第 3、4 类驱动程序将成为从 JDBC 访问数据库的首选方法。第 1、2 类驱动程序在直接的纯 Java 驱动程序还没有上市前将会作为过渡方案来使用。对第 1、2 类 驱动程序可能会有一些变种,这些变种要求有连接器,但通常这些是更加不可取的解决方案。第 3、 4 类驱动程序提供了 Java 的所有优点,包括自动安装(例如,通过使用 JDBC 驱动程序的 applet applet 来下载该驱动程序)。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第二讲 Connection 对象 JDBC 基础教程之连接 Connection 对象代表与数据库的连接。连接过程包括所执行的 SQL 语句和在该连接上所返回 的结果。一个应用程序可与单个数据库有一个或多个连接,或者可与许多数据库有连接。2.1.1 打 开连接与数据库建立连接的标准方法是调用 DriverManager.getConnection 方法。该方法接受含有 某个 URL 的字符串。DriverManager 类(即所谓的 JDBC 管理层)将尝试找到可与那个 URL 所代 表的数据库进行连接的驱动程序。DriverManager 类存有已注册的 Driver 类的清单。当调用方法 getConnection 时,它将检查清单中的每个驱动程序,直到找到可与 URL 中指定的数据库进行连接 的驱动程序为止。Driver 的方法 connect 使用这个 URL 来建立实际的连接。 用户可绕过 JDBC 管理层直接调用 Driver 方法。这在以下特殊情况下将很有用:当两个驱动 器可同时连接到数据库中,而用户需要明确地选用其中特定的驱动器。但一般情况下,让 DriverManager 类处理打开连接这种事将更为简单。 下述代码显示如何打开一个与位于 URL "jdbc:odbc:wombat" 的数据库的连接。所用的用户标 识符为 "oboy" ,口令为 "12Java": String url = "jdbc:odbc:wombat"; Connection con = DriverManager.getConnection(url, "oboy", "12Java"); 2.1.2 一般用法的 URL 由于 URL 常引起混淆,我们将先对一般 URL 作简单说明,然后再讨论 JDBC URL。 URL(统一资源定位符)提供在 Internet 上定位资源所需的信息。可将它想象为一个地址。URL Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 的第一部份指定了访问信息所用的协议,后面总是跟着冒号。常用的协议有"ftp"(代表“文件传输 协议”)和 "http" (代表“超文本传输协议”)。如果协议是 "file",表示资源是在某个本地文 件系统上而非在 Internet 上(下例用于表示我们所描述的部分;它并非 URL 的组成部分)。 ftp://javasoft.com/docs/JDK-1_apidocs.zip http://java.sun.com/products/jdk/CurrentRelease file:/home/haroldw/docs/books/tutorial/summary.html URL 的其余部份(冒号后面的)给出了数据资源所处位置的有关信息。如 果协议是 file,则 URL 的其余部份是文件的路径。对于 ftp 和 http 协议,URL 的其余部份标识了主机并可选地给出某个 更详尽的地址路径。例如,以下是 JavaSoft 主页的 URL。该 URL 只标识了主机: http://java.sun.com 从该主页开始浏览,就可以进到许多其它的网页中,其中之一就是 JDBC 主页。JDBC 主页的 URL 更为具体,它看起来类似: http://java.sun.com/products/jdbc 2.1.3 JDBC URL JDBC URL 提供了一种标识数据库的方法,可以使相应的驱动程序能识别该数据库并与之建立连 接。实际上,驱动程序编程员将决定用什么 JDBC URL 来标识特定的驱动程序。用户不必关心如何 来形成 JDBC URL;他们只须使用与所用的驱动程序一起提供的 URL 即可。JDBC 的作用是提供某些 约定,驱动程序编程员在构造他们的 JDBC URL 时应该遵循这些约定。 由于 JDBC URL 要与各种不同的驱动程序一起使用,因此这些约定应非常灵活。首先,它们应 允许不同的驱动程序使用不同的方案来命名数据库。例如, odbc 子协议允许(但并不是要求) URL 含有属性值。第二,JDBC URL 应允许驱动程序编程员将一切所需的信息编入其中。这样就可以让要 与给定数据库对话的 applet 打开数据库连接,而无须要求用户去做任何系统管理工作。第三, JDBC URL 应允许某种程度的间接性。也就是说,JDBC URL 可指向逻辑主机或数据库名,而这种逻辑主机 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 或数据库名将由网络命名系统动态地转换为实际的名称。这可以使系统管理员不必将特定主机声明 为 JDBC 名称的一部份。网络命名服务(例如 DNS、 NIS 和 DCE )有多种,而对于使用哪种命名服 务并无限制。JDBC URL 的标准语法如下所示。它由三部分组成,各部分间用冒号分隔: jdbc:< 子协议 >:< 子名称 > JDBC URL 的三个部分可分解如下: jdbc ─ 协议。 JDBC URL 中的协议总是 jdbc。 <子协议> ─ 驱动程序名或数据库连接机制(这种机制可由一个或多个驱动程序支持)的名称。 子协议名的典型示例是 "odbc",该名称是为用于指定 ODBC 风格的数据资源名称的 URL 专门保留 的。例如,为了通过 JDBC-ODBC 桥来访问某个数据库,可以用如下所示的 URL: jdbc:odbc:fred 本例中,子协议为 "odbc",子名称 "fred" 是本地 ODBC 数据资源。 如果要用网络命名服务(这样 JDBC URL 中的数据库名称不必是实际名称),则命名服务可以 作为子协议。例如,可用如下所示的 URL :jdbc:dcenaming:accounts-payable 本例中,该 URL 指 定了本地 DCE 命名服务应该将数据库名称 "accounts-payable" 解析为更为具体的可用于连接真 实数据库的名称。<子名称> ─ 一种标识数据库的方法。子名称可以依不同的子协议而变化。它还 可以有子名称的子名称(含有驱动程序编程员所选的任何内部语法)。使用子名称的目的是为定位 数据库提供足够的信息。前例中,因为 ODBC 将提供其余部份的信息,因此用 "fred" 就已足够。 然而,位于远程服务器上的数据库需要更多的信息。例如,如果数据库是通过 Internet 来访问的, 则在 JDBC URL 中应将网络地址作为子名称的一部份包括进去,且必须遵循如下所示的标准 URL 命 名约定://主机名:端口/子协议假设 "dbnet" 是个用于将某个主机连接到 Internet 上的协议,则 JDBC URL 类似: Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 jdbc:dbnet://wombat:356/fred 2.1.4 "odbc" 子协议子协议 odbc 是一种特殊情况。它是为 用于指定 ODBC 风格的数据资源名称的 URL 而保留的,并具有下列特性:允许在子名称(数据资源 名称)后面指定任意多个属性值。odbc 子协议的完整语法为: jdbc:odbc:< 数据资源名称 >[;< 属 性名 >=< 属性值 >]* 因此,以下都是合法的 jdbc:odbc 名称: jdbc:odbc:qeor7jdbc:odbc:wombat jdbc:odbc:wombat;CacheSize=20;ExtensionCase=LOWER jdbc:odbc:qeora;UID=kgh;PWD=fooey 2.1.5 注册子协议驱动程序编程员可保留某个名称以将之用作 JDBC URL 的子协议名。 当 DriverManager 类将此名称加到已注册的驱动程序清单中时,为之保留该名称的驱动程序应 能识别该名称并与它所标识的数据库建立连接。例如,odbc 是为 JDBC- ODBC 桥而保留的。 示例之二,假设有个 Miracle 公司,它可能会将 "miracle" 注册为连接到其 Miracle DBMS 上 的 JDBC 驱动程序的子协议,从而使其他人都无法使用这个名称。JavaSoft 目前作为非正式代理负 责注册 JDBC 子协议名称。要注册某个子协议名称,请发送电子邮件到下述地址: jdbc@wombat.eng.sun.com 2.1.6 发送 SQL 语句连接一旦建立,就可用来向它所涉及的数据库传送 SQL 语句。JDBC 对可被发送的 SQL 语句类型不加任何限制。这就提供了很大的灵活性,即允许使用特定的数据库语句或甚至于非 SQL 语句。然而,它要求用户自己负责确保所涉及的数据库可以处理所发送的 SQL 语句,否则将自食其 果。例如,如果某个应用程序试图向不支持储存程序的 DBMS 发送储存程序调用,就会失败并将抛 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 出异常。JDBC 要求驱动程序应至少能提供 ANSI SQL-2 Entry Level 功能才可算是符合 JDBC 标准 TM 的。这意味着用户至少可信赖这一标准级别的功能。JDBC 提供了三个类,用于向数据库发送 SQL 语句。Connection 接口中的三个方法可用于创建这些类的实例。下面列出这些类及其创建方法: Statement ─ 由方法 createStatement 所创建。Statement 对象用于发送简单的 SQL 语句。 PreparedStatement ─ 由方法 prepareStatement 所创建。 PreparedStatement 对象用于发送带有一个或多个输入参数( IN 参数)的 SQL 语句。 PreparedStatement 拥有一组方法,用于设置 IN 参数的值。 执行语句时,这些 IN 参数将被送到数据库中。PreparedStatement 的实例扩展了 Statement , 因此它们都包括了 Statement 的方法。 PreparedStatement 对象有可能比 Statement 对象的效率更高,因为它已被预编译过并存放在 那以供将来使用。 CallableStatement ─ 由方法 prepareCall 所创建。CallableStatement 对象用于执行 SQL 储存程序 ─ 一组可通过名称来调用(就象函数的调用那样)的 SQL 语句。CallableStatement 对 象从 PreparedStatement 中继承了用于处理 IN 参数的方法,而且还增加了用于处理 OUT 参数和 INOUT 参数的方法。 以下所列提供的方法可以快速决定应用哪个 Connection 方法来创建不同类型的 SQL 语句: createStatement 方法用于:简单的 SQL 语句(不带参数) prepareStatement 方法用于: 带 一个或多个 IN 参数的 SQL 语句 经常被执行的简单 SQL 语句 prepareCall 方法用于: 调用已储 存过程 2.1.7 事务事务由一个或多个这样的语句组成:这些语句已被执行、完成并被提交或还原。 当调用方法 commit 或 rollback 时,当前事务即告就结束,另一个事务随即开始。 缺省情况下,新连接将处于自动提交模式。也就是说,当执行完语句后,将自动对那个语句调 用 commit 方法。这种情况下,由于每个语句都是被单独提交的,因此一个事务只由一个语句组成。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 如果禁用自动提交模式,事务将要等到 commit 或 rollback 方法被显式调用时才结束,因此它将 包括上一次调用 commit 或 rollback 方法以来所有执行过的语句。对于第二种情况,事务中的所 有语句将作为组来提交或还原。 方法 commit 使 SQL 语句对数据库所做的任何更改成为永久性的,它还将释放事务持有的全部 锁。而方法 rollback 将弃去那些更改。 有时用户在另一个更改生效前不想让此更改生效。这可通过禁用自动提交并将两个更新组合在 一个事务中来达到。如果两个更新都是成功,则调用 commit 方法,从而使两个更新结果成为永久 性的;如果其中之一或两个更新都失败了,则调用 rollback 方法,以将值恢复为进行更新之前的 值。 大多数 JDBC 驱动程序都支持事务。事实上,符合 JDBC 的驱动程序必须支持事务。 DatabaseMetaData 给出的信息描述 DBMS 所提供的事务支持水平。 2.1.8 事务隔离级别 如果 DBMS 支持事务处理,它必须有某种途径来管理两个事务同时对一个数据库进行操作时可 能发生的冲突。用户可指定事务隔离级别,以指明 DBMS 应该花多大精力来解决潜在冲突。例如, 当事务更改了某个值而第二个事务却在该更改被提交或还原前读取该值时该怎么办 假设第一个事 务被还原后,第二个事务所读取的更改值将是无效的,那么是否可允许这种冲突? JDBC 用户可用 以下代码来指示 DBMS 允许在值被提交前读取该值(“dirty 读取”),其中 con 是当前连接: con.setTransactionIsolation(TRANSACTION_READ_UNCOMMITTED); 事务隔离级别越高,为避免冲突所花的精力也就越多。Connection 接口定义了五级,其中最低 级别指定了根本就不支持事务,而最高级别则指定当事务在对某个数据库进行操作时,任何其它事 务不得对那个事务正在读取的数据进行任何更改。通常,隔离级别越高,应用程序执行的速度也就 越慢(由于用于锁定的资源耗费增加了,而用户间的并发操作减少了)。在 决 定 采 用 什么隔离级别时, Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 开发人员必须在性能需求和数据一致性需求之间进行权衡。当然,实际所能支持的级别取决于所涉 及的 DBMS 的功能。 当创建 Connection 对象时,其事务隔离级别取决于驱动程序,但通常是所涉及的数据库的缺 省值。用户可通过调用 setIsolationLevel 方法来更改事务隔离级别。新的级别将在该连接过程的 剩余时间内生效。要想只改变一个事务的事务隔离级别,必须在该事务开始前进行设置,并在该事 务结束后进行复位。我们不提倡在事务的中途对事务隔离级别进行更改,因为这将立即触发 commit 方法的调用,使在此之前所作的任何更改变成永久性的。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第三讲 DriverManager 类 JDBC 基础教程之驱动设置 1、概述 DriverManager 类是 JDBC 的管理层,作用于用户和驱动程序之间。它跟踪可用的驱动程序, 并在数据库和相应驱动程序之间建立连接。另外,DriverManager 类也处理诸如驱动程序登录时间 限制及登录和跟踪消息的显示等事务。 对于简单的应用程序,一般程序员需要在此类中直接使用的唯一方法是 DriverManager.getConnection。正如名称所示,该方法将建立与数据库的连接。JDBC 允许用户调 用 DriverManager 的方法 getDriver、getDrivers 和 registerDriver 及 Driver 的方法 connect。但多数情况下,让 DriverManager 类管理建立连接的细节为上策。 1、跟踪可用驱动程序 DriverManager 类包含一列 Driver 类,它们已通过调用方法 DriverManager.registerDriver 对自己进行了注册。所有 Driver 类都必须包含有一个静态部分。它创建该类的实例,然后在加载 该实例时 DriverManager 类进行注册。这样,用户正常情况下将不会直接调用 DriverManager.registerDriver;而是在加载驱动程序时由驱动程序自动调用。加载 Driver 类, 然后自动在 DriverManager 中注册的方式有两种: 通过调用方法 Class.forName。这将显式地加载驱动程序类。由于这与外部设置无关,因此推 荐使用这种加载驱动程序的方法。以下代码加载类 acme.db.Driver: Class.forName("acme.db.Driver"); Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 如果将 acme.db.Driver 编写为加载时创建实例,并调用以该实例为参数的 DriverManager.registerDriver(本该如此),则它在 DriverManager 的驱动程序列表中,并可用 于创建连接。 通过将驱动程序添加到 java.lang.System 的属性 jdbc.drivers 中。这是一个由 DriverManager 类加载的驱动程序类名的列表,由冒号分隔:初始化 DriverManager 类时,它搜索 系统属性 jdbc.drivers,如果用户已输入了一个或多个驱动程序,则 DriverManager 类将试图加 载它们。以下代码说明程序员如何在 ~/.hotjava/properties 中输入三个驱动程序类(启动时, HotJava 将把它加载到系统属性列表中): jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.test.ourDriver; 对 DriverManager 方法的第一次调用将自动加载这些驱动程序类。 注意:加载驱动程序的第二种方法需要持久的预设环境。如果对这一点不能保证,则调用方法 Class.forName 显式地加载每个驱动程序就显得更为安全。这也是引入特定驱动程序的方法,因为 一旦 DriverManager 类被初始化,它将不再检查 jdbc.drivers 属性列表。 在以上两种情况中,新加载的 Driver 类都要通过调用 DriverManager.registerDriver 类进 行自我注册。如上所述,加载类时将自动执行这一过程。 由于安全方面的原因,JDBC 管理层将跟踪哪个类加载器提供哪个驱动程序。这样,当 DriverManager 类打开连接时,它仅使用本地文件系统或与发出连接请求的代码相同的类加载器提 供的驱动程序。 2、建立连接 加载 Driver 类并在 DriverManager 类中注册后,它们即可用来与数据库建立连接。当调用 DriverManager.getConnection 方法发出连接请求时,DriverManager 将检查每个驱动程序,查看 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 它是否可以建立连接。 有时可能有多个 JDBC 驱动程序可以与给定的 URL 连接。例如,与给定远程数据库连接时,可 以使用 JDBC-ODBC 桥驱动程序、JDBC 到通用网络协议驱动程序或数据库厂商提供的驱动程序。在 这种情况下,测试驱动程序的顺序至关重要,因为 DriverManager 将使用它所找到的第一个可以成 功连接到给定 URL 的驱动程序。 首先 DriverManager 试图按注册的顺序使用每个驱动程序(jdbc.drivers 中列出的驱动程序 总是先注册)。它将跳过代码不可信任的驱动程序,除非加载它们的源与试图打开连接的代码的源 相同。 它通过轮流在每个驱动程序上调用方法 Driver.connect,并向它们传递用户开始传递给方法 DriverManager.getConnection 的 URL 来对驱动程序进行测试,然后连接第一个认出该 URL 的驱 动程序。 这种方法初看起来效率不高,但由于不可能同时加载数十个驱动程序,因此每次连接实际只需 几个过程调用和字符串比较。 以下代码是通常情况下用驱动程序(例如 JDBC-ODBC 桥驱动程序)建立连接所需所有步骤的示 例: Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); //加载驱动程序 String url = "jdbc:odbc:fred"; DriverManager.getConnection(url, "userID", "passwd"); Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第四讲 Statement 对象 JDBC 基础教程之语句 概述 Statement 对象用于将 SQL 语句发送到数据库中。实际上有三种 Statement 对象,它们都作 为在给定连接上执行 SQL 语句的包容器:Statement、PreparedStatement(它从 Statement 继承 而来)和 CallableStatement(它从 PreparedStatement 继承而来)。它们都专用于发送特定类型 的 SQL 语句: Statement 对象用于执行不带参数的简单 SQL 语句;PreparedStatement 对象用于 执行带或不带 IN 参数的预编译 SQL 语句;CallableStatement 对象用于执行对数据库已存储过程 的调用。 Statement 接口提供了执行语句和获取结果的基本方法。PreparedStatement 接口添加了处理 IN 参数的方法;而 CallableStatement 添加了处理 OUT 参数的方法。 1、创建 Statement 对象 建立了到特定数据库的连接之后,就可用该连接发送 SQL 语句。Statement 对象用 Connection 的方法 createStatement 创建,如下列代码段中所示: Connection con = DriverManager.getConnection(url, "sunny", ""); Statement stmt = con.createStatement(); 为了执行 Statement 对象,被发送到数据库的 SQL 语句将被作为参数提供给 Statement 的方 法: ResultSet rs = stmt.executeQuery("SELECT a, b, c FROM Table2"); 2、使用 Statement 对象执行语句 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 Statement 接口提供了三种执行 SQL 语句的方法:executeQuery、executeUpdate 和 execute。 使用哪一个方法由 SQL 语句所产生的内容决定。 方法 executeQuery 用于产生单个结果集的语句,例如 SELECT 语句。 方法 executeUpdate 用于执行 INSERT、UPDATE 或 DELETE 语句以及 SQL DDL(数据定义语言) 语句,例如 CREATE TABLE 和 DROP TABLE。INSERT、UPDATE 或 DELETE 语句的效果是修改表中零 行或多行中的一列或多列。executeUpdate 的返回值是一个整数,指示受影响的行数(即更新计数)。 对于 CREATE TABLE 或 DROP TABLE 等不操作行的语句,executeUpdate 的返回值总为零。 方法 execute 用于执行返回多个结果集、多个更新计数或二者组合的语句。因为多数程序员不 会需要该高级功能,所以本概述后面将在单独一节中对其进行介绍。 执行语句的所有方法都将关闭所调用的 Statement 对象的当前打开结果集(如果存在)。这意 味着在重新执行 Statement 对象之前,需要完成对当前 ResultSet 对象的处理。 应注意,继承了 Statement 接口中所有方法的 PreparedStatement 接口都有自己的 executeQuery、executeUpdate 和 execute 方法。Statement 对象本身不包含 SQL 语句,因而必 须给 Statement.execute 方法提供 SQL 语句作为参数。PreparedStatement 对象并不将 SQL 语句 作为参数提供给这些方法,因为它们已经包含预编译 SQL 语句。CallableStatement 对象继承这些 方法的 PreparedStatement 形式。对于这些方法的 PreparedStatement 或 CallableStatement 版 本,使用查询参数将抛出 SQLException。 3、语句完成 当连接处于自动提交模式时,其中所执行的语句在完成时将自动提交或还原。语句在已执行且 所有结果返回时,即认为已完成。对于返回一个结果集的 executeQuery 方法,在 检 索 完 ResultSet 对象的所有行时该语句完成。对于方法 executeUpdate,当它执行时语句即完成。但在少数调用方 法 execute 的情况中,在检索所有结果集或它生成的更新计数之后语句才完成。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 有些 DBMS 将已存储过程中的每条语句视为独立的语句;而另外一些则将整个过程视为一个复 合语句。在启用自动提交时,这种差别就变得非常重要,因为它影响什么时候调用 commit 方法。 在前一种情况中,每条语句单独提交;在后一种情况中,所有语句同时提交。 4、关闭 Statement 对象 Statement 对象将由 Java 垃圾收集程序自动关闭。而作为一种好的编程风格,应在不需要 Statement 对象时显式地关闭它们。这将立即释放 DBMS 资源,有助于避免潜在的内存问题。 5、Statement 对象中的 SQL 转义语法 Statement 可包含使用 SQL 转义语法的 SQL 语句。转义语法告诉驱动程序其中的代码应该以 不同方式处理。驱动程序将扫描任何转义语法,并将它转换成特定数据库可理解的代码。这使得转 义语法与 DBMS 无关,并允许程序员使用在没有转义语法时不可用的功能。 转义子句由花括号和关键字界定: {keyword . . . parameters . . . } 该关键字指示转义子句的类型,如下所示。 escape 表示 LIKE 转义字符 字符“%”和“_”类似于 SQL LIKE 子句中的通配符(“%”匹配零个或多个字符,而“_”则匹 配一个字符)。为了正确解释它们,应在其前面加上反斜杠(“\”),它是字符串中的特殊转义字符。 在查询末尾包括如下语法即可指定用作转义字符的字符: {escape 'escape-character'} 例如,下列查询使用反斜杠字符作为转义字符,查找以下划线开头的标识符名: stmt.executeQuery("SELECT name FROM Identifiers WHERE Id LIKE `\_%' {escape `\'}; fn 表示标量函数 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 几乎所有 DBMS 都具有标量值的数值、字符串、时间、日期、系统和转换函数。要使用这些函 数,可使用如下转义语法:关键字 fn 后跟所需的函数名及其参数。例如,下列代码调用函数 concat 将两个参数连接在一起: {fn concat("Hot", "Java")}; 可用下列语法获得当前数据库用户名: {fn user()}; 标量函数可能由语法稍有不同的 DBMS 支持,而它们可能不被所有驱动程序支持。各种 DatabaseMetaData 方法将列出所支持的函数。例如,方法 getNumericFunctions 返回用逗号分隔 的数值函数列表,而方法 getStringFunctions 将返回字符串函数,等等。 驱动程序将转义函数调用映射为相应的语法,或直接实现该函数。 d、t 和 ts 表示日期和时间文字 DBMS 用于日期、时间和时间标记文字的语法各不相同。JDBC 使用转义子句支持这些文字的语 法的 ISO 标准格式。驱动程序必须将转义子句转换成 DBMS 表示。 例如,可用下列语法在 JDBC SQL 语句中指定日期: {d `yyyy-mm-dd'} 在该语法中,yyyy 为年代,mm 为月份,而 dd 则为日期。驱动程序将用等价的特定于 DBMS 的 表示替换这个转义子句。例如,如果 '28- FEB-99' 符合基本数据库的格式,则驱动程序将用它替 换 {d 1999-02-28}。 对于 TIME 和 TIMESTAMP 也有类似的转义子句: {t `hh:mm:ss'} {ts `yyyy-mm-dd hh:mm:ss.f . . .'} TIMESTAMP 中的小数点后的秒(.f . . .)部分可忽略。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 call 或 ? = call 表示已存储过程 如果数据库支持已存储过程,则可从 JDBC 中调用它们,语法为: {call procedure_name[(?, ?, . . .)]} 或(其中过程返回结果参数): {? = call procedure_name[(?, ?, . . .)]} 方括号指示其中的内容是可选的。它们不是语法的必要部分。 输入参数可以为文字或参数。有关详细信息,参见 JDBC 指南中第 7 节,“ CallableStatement”。 可通过调用方法 DatabaseMetaData.supportsStoredProcedures 检查数据库是否支持已存储 过程。 oj 表示外部连接 外部连接的语法为 {oj outer-join} 其中 outer-join 形式为 table LEFT OUTER JOIN {table / outer-join} ON search-condition 外部连接属于高级功能。有关它们的解释可参见 SQL 语 法 。 JDBC 提供了三种 DatabaseMetaData 方法用于确定驱动程序支持哪些外部连接类型:supportsOuterJoins、 supportsFullOuterJoins 和 supportsLimitedOuterJoins。 方法 Statement.setEscapeProcessing 可打开或关闭转义处理;缺省状态为打开。当性能极为 重 要 时,程序员可能想关闭它以减少处理时间。但通常它将出于打开状态。应注意: setEscapeProcessing 不适用于 PreparedStatement 对象,因为在调用该语句前它就可能已被发送 到数据库。有关预编译的信息,参见 PreparedStatement。 6、使用方法 execute Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 execute 方法应该仅在语句能返回多个 ResultSet 对象、多个更新计数或 ResultSet 对象与 更新计数的组合时使用。当执行某个已存储过程或动态执行未知 SQL 字符串(即应用程序程序员在 编译时未知)时,有可能出现多个结果的情况,尽管这种情况很少见。例如,用户可能执行一个已 存储过程(使用 CallableStatement 对象 - 参见第 135 页的 CallableStatement),并且该已存 储过程可执行更新,然后执行选择,再进行更新,再进行选择,等等。通常使用已存储过程的人应 知道它所返回的内容。 因为方法 execute 处理非常规情况,所以获取其结果需要一些特殊处理并不足为怪。例如,假 定已知某个过程返回两个结果集,则在使用方法 execute 执行该过程后,必须调用方法 getResultSet 获得第一个结果集,然后调用适当的 getXXX 方法获取其中的值。要获得第二个结果 集,需要先调用 getMoreResults 方法,然后再调用 getResultSet 方法。如果已知某个过程返回 两个更新计数,则首先调用方法 getUpdateCount,然后调用 getMoreResults,并再次调用 getUpdateCount。 对于不知道返回内容,则情况更为复杂。如果结果是 ResultSet 对象,则方法 execute 返回 true;如果结果是 Java int,则返回 false。如果返回 int,则意味着结果是更新计数或执行的语 句是 DDL 命令。在调用方法 execute 之后要做的第一件事情是调用 getResultSet 或 getUpdateCount。调用方法 getResultSet 可以获得两个或多个 ResultSet 对象中第一个对象;或 调用方法 getUpdateCount 可以获得两个或多个更新计数中第一个更新计数的内容。 当 SQL 语句的结果不是结果集时,则方法 getResultSet 将返回 null。这可能意味着结果是 一个更新计数或没有其它结果。在这种情况下,判断 null 真正含义的唯一方法是调用方法 getUpdateCount,它将返回一个整数。这个整数为调用语句所影响的行数;如果为 -1 则表示结果 是结果集或没有结果。如果方法 getResultSet 已返回 null(表示结果不是 ResultSet 对象),则 返回值 -1 表示没有其它结果。也就是说,当下列条件为真时表示没有结果(或没有其它结果): Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 ((stmt.getResultSet() == null) && (stmt.getUpdateCount() == -1)) 如果已经调用方法 getResultSet 并处理了它返回的 ResultSet 对象,则有必要调用方法 getMoreResults 以确定是否有其它结果集或更新计数。如果 getMoreResults 返回 true,则需要 再次调用 getResultSet 来检索下一个结果集。如上所述,如果 getResultSet 返回 null,则需要 调用 getUpdateCount 来检查 null 是表示结果为更新计数还是表示没有其它结果。 当 getMoreResults 返回 false 时,它表示该 SQL 语句返回一个更新计数或没有其它结果。 因此需要调用方法 getUpdateCount 来检查它是哪一种情况。在这种情况下,当下列条件为真时表 示没有其它结果: ((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1)) 下面的代码演示了一种方法用来确认已访问调用方法 execute 所产生的全部结果集和更新计 数: stmt.execute(queryStringWithUnknownResults); while (true) { int rowCount = stmt.getUpdateCount(); if (rowCount > 0) { // 它是更新计数 System.out.println("Rows changed = " + count); stmt.getMoreResults(); continue; } if (rowCount == 0) { // DDL 命令或 0 个更新 System.out.println(" No rows changed or statement was DDL Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 command"); stmt.getMoreResults(); continue; } // 执行到这里,证明有一个结果集 // 或没有其它结果 ResultSet rs = stmt.getResultSet; if (rs != null) { . . . // 使用元数据获得关于结果集列的信息 while ( rs break; // 没有其它结果 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第五讲 ResultSet 对象 JDBC 基础教程之 ResultSet 对象 概述 ResultSet 包含符合 SQL 语句中条件的所有行,并且它通过一套 get 方法(这些 get 方法可 以访问当前行中的不同列)提供了对这些行中数据的访问。ResultSet.next 方法用于移动到 ResultSet 中的下一行,使下一行成为当前行。 结果集一般是一个表,其中有查询所返回的列标题及相应的值。例如,如 果 查询为 SELECT a, b, c FROM Table1,则结果集将具有如下形式: a b c -------- --------- -------- 12345 Cupertino CA 83472 Redmond WA 83492 Boston MA 下面的代码段是执行 SQL 语句的示例。该 SQL 语句将返回行集合,其中列 1 为 int,列 2 为 String,而列 3 则为字节数组: java.sql.Statement stmt = conn.createStatement(); ResultSet r = stmt.executeQuery("SELECT a, b, c FROM Table1"); while (r.next()) Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 { // 打印当前行的值。 int i = r.getInt("a"); String s = r.getString("b"); float f = r.getFloat("c"); System.out.println("ROW = " + i + " " + s + " " + f); } 1、行和光标 ResultSet 维护指向其当前数据行的光标。每调用一次 next 方法,光标向下移动一行。最初 它位于第一行之前,因此第一次调用 next 将把光标置于第一行上,使它成为当前行。随着每次调 用 next 导致光标向下移动一行,按照从上至下的次序获取 ResultSet 行。 在 ResultSet 对象或其父辈 Statement 对象关闭之前,光标一直保持有效。 在 SQL 中,结果表的光标是有名字的。如果数据库允许定位更新或定位删除,则需要将光标的 名字作为参数提供给更新或删除命令。可通过调用方法 getCursorName 获得光标名。 注意:不是所有的 DBMS 都支持定位更新和删除。可使用 DatabaseMetaData.supportsPositionedDelete 和 supportsPositionedUpdate 方法来检查特定连 接是否支持这些操作。当支持这些操作时,DBMS/驱动程序必须确保适当锁定选定行,以使定位更新 不会导致更新异常或其它并发问题。 2、列 方法 getXXX 提供了获取当前行中某列值的途径。在每一行内,可按任何次序获取列值。但为 了保证可移植性,应该从左至右获取列值,并且一次性地读取列值。列名或列号可用于标识要从中 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 获取数据的列。例如,如果 ResultSet 对象 rs 的第二列名为“title”,并将值存储为字符串, 则下列任一代码将获取存储在该列中的值: String s = rs.getString("title"); String s = rs.getString(2); 注意列是从左至右编号的,并且从列 1 开始。同时,用作 getXXX 方法的输入的列名不区分大 小写。 提供使用列名这个选项的目的是为了让在查询中指定列名的用户可使用相同的名字作为 getXXX 方法的参数。另一方面,如果 select 语句未指定列名(例如在“select * from table1” 中或列是导出的时),则应该使用列号。这些情况下, 户将无法确切知道列名。 有些情况下,SQL 查询返回的结果集中可能有多个列具有相同的名字。如 果列名用作 getXXX 方 法的参数,则 getXXX 将返回第一个匹配列名的值。因而,如果多个列具有相同的名字,则需要使 用列索引来确保检索了正确的列值。这时,使用列号效率要稍微高一些。 关于 ResultSet 中列的信息,可通过调用方法 ResultSet.getMetaData 得到。返回的 ResultSetMetaData 对象将给出其 ResultSet 对象各列的编号、类型和属性。 如果列名已知,但不知其索引,则可用方法 findColumn 得到其列号。 3、数据类型和转换 对于 getXXX 方法,JDBC 驱动程序试图将基本数据转换成指定 Java 类型,然后返回适合的 Java 值。例如,如 果 getXXX 方法为 getString,而基本数据库中数据类型为 VARCHAR,则 JDBC 驱 动程序将把 VARCHAR 转换成 Java String。getString 的返回值将为 Java String 对象。 下表显示了允许用 getXXX 获取的 JDBC 类型及推荐用它获取的 JDBC 类型(通用 SQL 类型)。 小写的 x 表示允许 getXXX 方法获取该数据类型;大写的 X 表示对该数据类型推荐使用 getXXX Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 方法。例如,除了 getBytes 和 getBinaryStream 之外的任何 getXXX 方法都可用来获取 LONGVARCHAR 值,但是推荐根据返回的数据类型使用 getAsciiStream 或 getUnicodeStream 方法。 方法 getObject 将任何数据类型返回为 Java Object。当基本数据类型是特定于数据库的抽象类型 或当通用应用程序需要接受任何数据类型时,它是非常有用的。 可使用 ResultSet.getXXX 方法获取常见的 JDBC 数据类型。 “x”表示该 getXXX 方法可合法地用于获取给定 JDBC 类型。 “X”表示推荐使用该 getXXX 方法来获取给定 JDBC 类型。 getByte X x x x x x x x x x x x x getShort x X x x x x x x x x x x x getInt x x X x x x x x x x x x x getLong x x x X x x x x x x x x x getFloat x x x x X x x x x x x x x getDouble x x x x x X X x x x x x x getBigDecimal x x x x x x x X X x x x x getBoolean x x x x x x x x x X x x x getString x x x x x x x x x x X X x x x x x x x getBytes X X x getDate x x x X x getTime x x x X x getTimestamp x x x x X getAsciiStream x x X x x x getUnicodeStream x x X x x x Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 getBinaryStream x x X getObject x x x x x x x x x x x x x x x x x x x 4、对非常大的行值使用流 ResultSet 可以获取任意大的 LONGVARBINARY 或 LONGVARCHAR 数据。方法 getBytes 和 getString 将数据返回为大的块(最大为 Statement.getMaxFieldSize 的返回值)。但是,以较小 的固定块获取非常大的数据可能会更方便,而这可通过让 ResultSet 类返回 java.io.Input 流来 完成。从该流中可分块读取数据。注意:必须立即访问这些流,因为在下一次对 ResultSet 调用 getXXX 时它们将自动关闭(这是由于基本实现对大块数据访问有限制)。 JDBC API 具有三个获取流的方法,分别具有不同的返回值: getBinaryStream 返回只提供数据库原字节而不进行任何转换的流。 getAsciiStream 返回提供单字节 ASCII 字符的流。 getUnicodeStream 返回提供双字节 Unicode 字符的流。 注意:它不同于 Java 流,后者返回无类型字节并可(例如)通用于 ASCII 和 Unicode 字符。 下列代码演示了 getAsciiStream 的用法: java.sql.Statement stmt = con.createStatement(); ResultSet r = stmt.executeQuery("SELECT x FROM Table2"); // 现在以 4K 块大小获取列 1 结果: byte buff = new byte[4096]; while (r // 将新填充的缓冲区发送到 ASCII 输出流: output.write(buff, 0, size); Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 } } 5、NULL 结果值 要确定给定结果值是否是 JDBC NULL,必须先读取该列,然后使用 ResultSet.wasNull 方法检 查该次读取是否返回 JDBC NULL。 当使用 ResultSet.getXXX 方法读取 JDBC NULL 时,方法 wasNull 将返回下列值之一: Java null 值:对于返回 Java 对象的 getXXX 方法(例如 getString、getBigDecimal、 getBytes、getDate、getTime、getTimestamp、getAsciiStream、getUnicodeStream、getBinaryStream、 getObject 等)。 零值:对于 getByte、getShort、getInt、getLong、getFloat 和 getDouble。 false 值:对于 getBoolean。 6、可选结果集或多结果集 通常使用 executeQuery(它返回单个 ResultSet)或 executeUpdate(它可用于任何数据库修 改语句,并返回更新行数)可执行 SQL 语句。但有些情况下,应用程序在执行语句之前不知道该语 句是否返回结果集。此外,有些已存储过程可能返回几个不同的结果集和/或更新计数。 为了适应这些情况,JDBC 提供了一种机制,允许应用程序执行语句,然后处理由结果集和更新 计数组成的任意集合。这种机制的原理是首先调用一个完全通用的 execute 方法,然后调用另外三 个方法,getResultSet、getUpdateCount 和 getMoreResults。这些方法允许应用程序一次一个地 研究语句结果,并确定给定结果是 ResultSet 还是更新计数。 为了适应这些情况,JDBC 提供了一种机制,允许应用程序执行语句,然后处理由结果集和更新 计数组成的任意集合。这种机制的原理是首先调用一个完全通用的 execute 方法,然后调用另外三 个方法,getResultSet、getUpdateCount 和 getMoreResults。这些方法允许应用程序一次一个地 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 研究语句结果,并确定给定结果是 ResultSet 还是更新计数。 用户不必关闭 ResultSet;当产生它的 Statement 关闭、重新执行或用于从多结果序列中获取 下一个结果时,该 ResultSet 将被 Statement 自动关闭。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第六讲 PreparedStatement 接口 JDBC 基础教程之 PreparedStatement 概述 该 PreparedStatement 接口继承 Statement,并与之在两方面有所不同: PreparedStatement 实例包含已编译的 SQL 语句。这就是使语句“准备好”。包含于 PreparedStatement 对象中的 SQL 语句可具有一个或多个 IN 参数。IN 参数的值在 SQL 语句创建 时未被指定。相反的,该语句为每个 IN 参数保留一个问号(“?”)作为占位符。每个问号的值 必须在该语句执行之前,通过适当的 setXXX 方法来提供。 由于 PreparedStatement 对象已预编译过,所以其执行速度要快于 Statement 对象。因此, 多次执行的 SQL 语句经常创建为 PreparedStatement 对象,以提高效率。 作为 Statement 的子类,PreparedStatement 继承了 Statement 的所有功能。另外它还添加 了一整套方法,用于设置发送给数据库以取代 IN 参数占位符的值。同时,三种方法 execute、 executeQuery 和 executeUpdate 已被更改以使之不再需要参数。这些方法的 Statement 形式(接 受 SQL 语句参数的形式)不应该用于 PreparedStatement 对象。 1、创建 PreparedStatement 对象 以下的代码段(其中 con 是 Connection 对象)创建包含带两个 IN 参数占位符的 SQL 语句 的 PreparedStatement 对象: PreparedStatement pstmt = con.prepareStatement("UPDATE table4 SET m = ? WHERE x = ?"); pstmt 对象包含语句 "UPDATE table4 SET m = ? WHERE x = ?",它已发送给 DBMS,并为执行 作好了准备。 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 2、传递 IN 参数 在执行 PreparedStatement 对象之前,必须设置每个 ? 参数的值。这可通过调用 setXXX 方 法来完成,其中 XXX 是与该参数相应的类型。例如,如果参数具有 Java 类型 long,则使用的方 法就是 setLong。setXXX 方法的第一个参数是要设置的参数的序数位置,第二个参数是设置给该参 数的值。例如,以下代码将第一个参数设为 123456789,第二个参数设为 100000000: pstmt.setLong(1, 123456789); pstmt.setLong(2, 100000000); 一旦设置了给定语句的参数值,就可用它多次执行该语句,直到调用 clearParameters 方法清 除它为止。在连接的缺省模式下(启用自动提交),当语句完成时将自动提交或还原该语句。 如果基本数据库和驱动程序在语句提交之后仍保持这些语句的打开状态,则同一个 PreparedStatement 可执行多次。如果这一点不成立,那么试图通过使用 PreparedStatement 对象 代替 Statement 对象来提高性能是没有意义的。 利用 pstmt(前面创建的 PreparedStatement 对象),以下代码例示了如何设置两个参数占位 符的值并执行 pstmt 10 次。如上所述,为做到这一点,数据库不能关闭 pstmt。在该示例中,第 一个参数被设置为 "Hi"并保持为常数。在 for 循环中,每次都将第二个参数设置为不同的值:从 0 开始,到 9 结束。 pstmt.setString(1, "Hi"); for (int i = 0; i < 10; i++) { pstmt.setInt(2, i); int rowCount = pstmt.executeUpdate(); Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 } 3、IN 参数中数据类型的一致性 setXXX 方法中的 XXX 是 Java 类型。它是一种隐含的 JDBC 类型(一般 SQL 类型),因为驱 动程序将把 Java 类型映射为相应的 JDBC 类型(遵循该 JDBCGuide 中§8.6.2 “映射 Java 和 JDBC 类型”表中所指定的映射),并将该 JDBC 类型发送给数据库。例如,以下代码段将 PreparedStatement 对象 pstmt 的第二个参数设置为 44,Java 类型为 short: pstmt.setShort(2, 44); 驱动程序将 44 作为 JDBC SMALLINT 发送给数据库,它是 Java short 类型的标准映射。 程序员的责任是确保将每个 IN 参数的 Java 类型映射为与数据库所需的 JDBC 数据类型兼容 的 JDBC 类型。不妨考虑数据库需要 JDBC SMALLINT 的情况。如果使用方法 setByte ,则驱动程 序将 JDBC TINYINT 发送给数据库。这是可行的,因为许多数据库可从一种相关的类型转换为另一 种类型,并且通常 TINYINT 可用于 SMALLINT 适用的任何地方 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 第七讲 CallableStatement 对象 JDBC 基础教程之 CallableStatement 概述 CallableStatement 对象为所有的 DBMS 提供了一种以标准形式调用已储存过程的方法。已储 存过程储存在数据库中。对已储存过程的调用是 CallableStatement 对象所含的内容。这种调用是 用一种换码语法来写的,有两种形式:一种形式带结果参,另一种形式不带结果参数。结果参数是 一种输出 (OUT) 参数,是已储存过程的返回值。两种形式都可带有数量可变的输入(IN 参数)、 输出(OUT 参数)或输入和输出(INOUT 参数)的参数。问号将用作参数的占位符。 在 JDBC 中调用已储存过程的语法如下所示。注意,方括号表示其间的内容是可选项;方括号本 身并不是语法的组成部份。 {call 过程名[(?, ?, ...)]} 返回结果参数的过程的语法为: {? = call 过程名[(?, ?, ...)]} 不带参数的已储存过程的语法类似: {call 过程名} 通常,创建 CallableStatement 对象的人应当知道所用的 DBMS 是支持已储存过程的,并且知 道这些过程都是些什么。然而,如果需要检查,多种 DatabaseMetaData 方法都可以提供这样的信 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 息。例如,如果 DBMS 支持已储存过程的调用,则 supportsStoredProcedures 方法将返回 true, 而 getProcedures 方法将返回对已储存过程的描述。CallableStatement 继承 Statement 的方法 (它们用于处理一般的 SQL 语句),还继承了 PreparedStatement 的方法(它们用于处理 IN 参)。 CallableStatement 中定义的所有方法都用于处理 OUT 参数或 INOUT 参数的输出部分:注册 OUT 参数的 JDBC 类型(一般 SQL 类型)、从这些参数中检索结果,或者检查所返回的值是否为 JDBC NULL。 1、创建 CallableStatement 对象 CallableStatement 对象是用 Connection 方法 prepareCall 创建的。下例创建 CallableStatement 的实例,其中含有对已储存过程 getTestData 调用。该过程有两个变量,但不 含结果参数: CallableStatement cstmt = con.prepareCall("{call getTestData(?, ?)}"); 其中?占位符为 IN、OUT 还是 INOUT 参数,取决于已储存过程 getTestData。 2、IN 和 OUT 参数 将IN 参数传给 CallableStatement 对象是通过 setXXX 方法完成的。该方法继承自 PreparedStatement。所传入参数的类型决定了所用的 setXXX 方法(例如,用 setFloat 来传入 float 值等)。 如果已储存过程返回 OUT 参数,则在执行 CallableStatement 对象以前必须先注册每个 OUT 参数的 JDBC 类型(这是必需的,因为某些 DBMS 要求 JDBC 类型)。注册 JDBC 类型是用 registerOutParameter 方法来完成的。语句执行完后,CallableStatement 的 getXXX 方法将取回 参数值。正确的 getXXX 方法是为各参数所注册的 JDBC 类型所对应的 Java 类型。换言之, registerOutParameter 使用的是 JDBC 类型(因此它与数据库返回的 JDBC 类型匹配),而 getXXX Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 将之转换为 Java 类型。 作为示例,下述代码先注册 OUT 参数,执行由 cstmt 所调用的已储存过程,然后检索在 OUT 参 数中返回的值。方法 getByte 从第一个 OUT 参数中取出一个 Java 字节,而 getBigDecimal 从第 二个 OUT 参数中取出一个 BigDecimal 对象(小数点后面带三位数): CallableStatement cstmt = con.prepareCall("{call getTestData(?, ?)}"); cstmt.registerOutParameter(1, java.sql.Types.TINYINT); cstmt.registerOutParameter(2, java.sql.Types.DECIMAL, 3); cstmt.executeQuery(); byte x = cstmt.getByte(1); java.math.BigDecimal n = cstmt.getBigDecimal(2, 3); CallableStatement 与 ResultSet 不同,它不提供用增量方式检索大 OUT 值的特殊机制。 3、INOUT 参数 既支持输入又接受输出的参数(INOUT 参数)除了调用 registerOutParameter 方法外,还要 求调用适当的 setXXX 方法(该方法是从 PreparedStatement 继承来的)。setXXX 方法将参数值 设置为输入参数,而 registerOutParameter 方法将它的 JDBC 类型注册为输出参数。setXXX 方法 提供一个 Java 值,而驱动程序先把这个值转换为 JDBC 值,然后将它送到数据库中。这种 IN 值 的 JDBC 类型和提供给 registerOutParameter 方法的 JDBC 类型应该相同。然后,要检索输出值, 就要用对应的 getXXX 方法。例如,Java 类型为 byte 的参数应该使用方法 setByte 来赋输入值。 应该给 registerOutParameter 提供类型为 TINYINT 的 JDBC 类型,同时应使用 getByte 来检索 输出值。 下例假设有一个已储存过程 reviseTotal,其唯一参数是 INOUT 参数。方法 setByte 把此参 Java 数据库接口 JDBC 入门基础讲座 Java 爱好者 http://www.javafan.net 制作 数设为 25,驱动程序将把它作为 JDBC TINYINT 类型送到数据库中。接着,registerOutParameter 将该参数注册为 JDBC TINYINT。执行完该已储存过程后,将返回一个新的 JDBC TINYINT 值。方法 getByte 将把这个新值作为 Java byte 类型检索。 CallableStatement cstmt = con.prepareCall("{call reviseTotal(?)}"); cstmt.setByte(1, 25); cstmt.registerOutParameter(1, java.sql.Types.TINYINT); cstmt.executeUpdate(); byte x = cstmt.getByte(1); 4、先检索结果,再检索 OUT 参数 由于某些 DBMS 的限制,为了实现最大的可移植性,建议先检索由执行 CallableStatement 对 象 所 产 生 的结果,然后再用 CallableStatement.getXXX 方法来检索 OUT 参 数。如果 CallableStatement 对象返回多个 ResultSet 对象(通过调用 execute 方法),在检索 OUT 参数 前应先检索所有的结果。这种情况下,为确保对所有的结果都进行了访问,必须对 Statement 方法 getResultSet、getUpdateCount 和 getMoreResults 进行调用,直到不再有结果为止。 检索完所有的结果后,就可用 CallableStatement.getXXX 方法来检索 OUT 参数中的值。 5、检索作为 OUT 参数的 NULL 值 返回到 OUT 参数中的值可能会是 JDBC NULL。当出现这种情形时,将对 JDBC NULL 值进行转 换以使 getXXX 方法所返回的值为 null、0 或 false,这取决于 getXXX 方法类型。对于 ResultSet 对象,要知道 0 或 false 是否源于 JDBCNULL 的唯一方法,是用方法 wasNull 进行检测。如 果 getXXX 方法读取的最后一个值是 JDBC NULL,则该方法返回 true,否则返回 flase。

下载文档,方便阅读与编辑

文档的实际排版效果,会与网站的显示效果略有不同!!

需要 8 金币 [ 分享文档获得金币 ] 0 人已下载

下载文档

相关文档