了解如何使用 Spring 框架来改善 Oracle JDBC 访问。 正确关闭数据库资源 第一个 Spring 代码示例 代码清单 2 中的 JDBC 代码可以用来查询(大家都熟悉)的 scott/tiger 模式中的员工的酬金。正如之前所讨论的那样,在本示例中除了实际查询数据库的 SQL 代码之外,还必需要有大量的“例行”代码。 List commissions = new ArrayList();代码清单 3 中为使用 Spring 框架的代码,它提供了类似于代码清单 2 的功能。 List commissions = new ArrayList();值得注意的是与直接使用 JDBC 相比,利用 Spring 框架可以少得多的代码实现同样的功能。如代码清单 3 所示,您不需要编写和维护管理资源(连接、语句、结果集)的代码。甚至代码清单 3 中的少量的异常处理代码也不是绝对必需的,因为 DataAccessException 是一个非强制异常。因为 Number 类型用来返回奖金,因此不需要显式调用 ResultSet 的 wasNull 方法。实际上,您甚至在代码清单 3 中的任何地方都找不到 ResultSet 语法! 代码清单 3 还说明了由 Spring 框架的 JDBC 支持所提供和使用的基础类之一 — JdbcTemplate。我们将使用一个数据源来完成这个由 Spring 提供的类的实例化,然后在模板类上使用提供的 SQL 字符串调用它的被覆盖的 queryForList 方法之一。queryForList 方法将返回一个包含 HashMap 的 ArrayList,其中该 ArrayList 中的每一个元素都是一个返回的数据行,一个特定数组阵列元素中的每一个 Map 条目都是该行中的一个列值。 JdbcTemplate 提供了许多被覆盖的 queryForList 方法,它们可以用来查询潜在的多行数据。这个非常有用的类还提供了诸如 queryForInt(返回单个整数)、queryForLong(返回单个 long 型整数)、query、update 之类的方法。要分辨这些不同的被覆盖的方法,最容易的方式是阅读与 Spring 框架一起提供的基于 Javadoc 的 API 文档中的“方法详情”部分。这些方法的不同点在于使用的语句的类型(例如 Statement 或 PreparedStatement)和支持的特性。JdbcTemplate 还提供了一些方法,与上面使用的方法相比,它们需要更多的 JDBC 知识,但它们提供了更好的灵活性。这些更灵活但需要更多 JDBC 知识的方法将在本文稍后进行说明。 JDBC 异常处理 返回到代码清单 1,注意 java.sql.SQLException 是唯一一个显式捕获的异常。SQLException 中捕获了与数据库和 SQL 相关的各种异常情况。描述 SQLException 类的 Javadoc 注释介绍了可以从 SQLException 的实例中获得的基本信息。这些信息包括错误描述字符串 [getMessage()]、某个标准化 SQLState 异常 String [getSQLState()] 和供应商特有的整型错误码 [getErrorCode()]。在代码清单 1 中实现的简单的异常处理中使用了所有这三种信息。 SQLException 是一种强制异常(直接扩展 java.lang.Exception)。Java 的强制异常曾经引起很大争议,现在 Java 社区似乎正在取得共识:只有当在应用程序能够处理异常时才应使用强制异常。如应用程序代码不能以有意义的方式处理异常,则不应当强制处理该异常。因为 SQLException 是强制异常,所以应用程序代码必须处理它,或者捕获它并对其进行一些处理或显式地将其抛出给调用代码。 SQLException 的最后一点细微差别在于它是使用 SQL 的关系数据源所特有的异常。这使得不适合将它包含在真正可移植的数据访问对象 (DAO) 中,后者应当独立于数据信息库类型和访问语言。 Spring 框架对 SQLException 的处理是其在支持更容易的 JDBC 开发和维护方面最有用的特性之一。Spring 框架提供了完成 SQLException 抽象化的 JDBC 支持,并提供了一个对 DAO 友好的非检查异常层次结构。 图 1 (利用 Oracle JDeveloper 10g 的 UML 建模工具绘制)图示了一些用于 JDBC 和 DAO 的最有趣和最重要的 Spring 框架异常类。下面的图 1 中显示的所有类都属于 org.springframework 程序包下的一个子程序包。这些 JDBC 特有的异常处理类都位于 jdbc 子程序包中,更通用的 DAO 异常处理类包含在 dao 子程序包中。
处理供应商特有的错误码 如上所述,标准的 SQLException 提供了一个标准化的信息段 (SQLState) 和一个供应商特有的信息段 (ErrorCode)。正如大多数的数据库和它们的 JDBC 驱动程序实现一样,Oracle 数据库和 JDBC 驱动程序通过供应商特有的错误码所提供的关于问题的详细信息要比通过 SQLException 的与供应商无关的 SQLState 组件所提供的信息多得多。 Oracle 数据库及其 JDBC 驱动程序通过 Error Code 提供的更丰富得多的详细信息的一个明显的例子是 SQLState 代码 42000 (通常这指示语法错误或访问问题)。对于 Oracle JDBC 驱动程序的大量不同的 Oracle 错误码,SQLException 都将返回相同的 SQLState 值 (42000)。对应 SQLState 的 42000 值的一些 Oracle 错误码包括 900(“无效 SQL 语句”)、903(“无效表名”)、904(“无效标识符”)、911(“无效字符”)和 936(“缺少表达式”)。此外很明显任何来源于 Oracle JDBC 驱动程序的错误(与来源于 Oracle 数据库的错误相反)都没有任何对应的 SQLState。正如这些例子所显示那样,Oracle 特有的错误码所提供的关于错误情况的详细信息要比与供应商无关的 SQLState 所提供的信息更丰富得多。 有时候区分来源于 Oracle 数据库的错误和来源于 Oracle JDBC 驱动程序的错误非常重要。例如,903(“无效的表名”)错误码对应 Oracle 数据库错误码 ORA-00903。相反,17003(“无效的列索引”)错误码对应 Oracle JDBC 驱动程序错误码 ORA-17003。这两种类型的错误码(数据库和 JDBC 驱动程序)都是 Oracle 特有的(如 ORA- 前缀所指示的那样)。因为没有为来源于 Oracle JDBC 驱动程序的错误提供 SQLState 错误码,因此必须使用 Oracle 特有的错误码来区分由 JDBC 驱动程序导致的错误。
在下面的表 1 中列出了访问 Oracle 数据库的 JDBC 中的一些最常见的错误。“示例代码和/或注释”列中的示例显示了导致这种错误的 SQL 语句类型或提供了关于表中的该行上显示的特定错误的其他注释。
本文末尾的在线资源部分包含了到一个网站的链接,该网站详细介绍了用户可能遇到的各种 Oracle 数据库异常。Oracle JDBC 驱动程序错误码可以在 Oracle JDBC 开发人员指南和参考的附录 B 中找到,几种常见的 Oracle 数据库产生的错误码可以在 Oracle 数据库错误消息文档中找到(没有列出产品特有的 ORA 消息)。 Spring 框架既支持基于标准的 SQLState 又支持供应商特有的错误码。与自主开发的数据访问软件相比,该框架对供应商特有的错误码的支持利用了与特有数据库的更松散的耦合来实现。Spring 框架引入了一个 XML 配置文件,利用它将在 JDBC 代码中经常遇到的某些供应商特有的错误与 Spring 支持的异常类连接起来。Spring 提供的 sql-error-codes.xml 配置文件目前包含了代码清单 4 中所示针对 Oracle 数据库的配置。(在该文件中还涉及其他的数据库供应商,但并包含在此代码清单中。) <bean id="Oraclea€?sql-error-codes.xml 中的 value 元素的主体中的整数由逗号分隔,它们对应于前面所述的供应商特有的错误码的数字部分。在表 1 中列出了 "badSqlGrammarCodes" 类别中的许多数字码。17006 代码是一个 JDBC 驱动程序错误码,它指示“无效的列名”。代码清单 4 中的 property 元素标记的 name 属性指示 Spring 框架使用哪种类型的异常来处理那些特定的错误码。例如,917 (ORA-00917) 错误将导致 Spring 框架抛出一个非强制的 BadSqlGrammarException。因为该配置文件是 XML 格式的并且在代码的外部,因此可以很容易地将其他代码添加到该文件中,用于抛出最适合于特定供应商错误码的基于 Spring 的 JDBC 异常。 出于各种原因,您可能希望抛出与数据库的错误码对应的特定异常。例如,您可能希望选择处理 SQLException 正常抛出的情况,而不是处理所有的情况。因为在许多情况下,在运行时您无法对代码作任何处理。通过为数据库开发人员创建一个更细粒化的异常层次结构,以及通过提供特定数据库错误和特定异常之间的一个松散耦合的连接,Spring 框架使您能够更轻松地处理那些容易处理的异常,而选择忽略不能合理处理的非强制异常。 Spring 为 JDBC 支持提供的特别方便的异常类之一是 BadSqlGrammarException。该异常类提供了一个名称为 getSql() 的方法,该方法将返回在抛出异常时正被调用的 SQL 语句。因为该类可以识别 SQL 的特征(它不是一个通用的 DAO 类),因此它还通过 getSQLException() 方法提供了标准 SQLException 的一个句柄。 除了将其他的 Oracle 特有的错误码添加到 sql-error-codes.xml 文件中以将它们映射至现有的由 Spring 提供的异常类之外,您还可以创建定制的异常处理类。然后可以编写一个定制的 SQLExceptionTranslator 类来将 Oracle 错误码与这些定制的异常处理类连接起来。 将 PreparedStatement 用于 Spring 代码清单 3 中的 Spring 示例依靠 Spring 的 Statement 包装来执行 SQL 语句。然而,通常推荐使用 PreparedStatement 而不是 Statement 来对数据库执行 SQL 语句。Spring JdbcTemplate 类为许多方法提供了在 Statement 和 PreparedStatement 两者上构建的相同的功能,这样便于您按需选择 JDBC 语句的底层类型。 Spring 的基于 Javadoc 的 API 文档详细说明了各个方法是使用 Statement 还是 PreparedStatement。您还可以根据是否和 SQL 字符串一起传递了 SQL 参数给方法来分辨 JdbcTemplate 使用了哪一种类型。如果只传入了 SQL 字符串,那么方法一般使用 Statement。如果方法接收了 SQL 字符串的参数以及 SQL 语句,那么方法一般使用 PreparedStatement。下面的两个代码清单(代码清单 5 和代码清单 6)显示了使用 PreparedStatement 的标准 JDBC 访问和包装 PreparedStatement 的基于 Spring 的访问。 String updateStr = 代码清单 6 String updateStr =代码清单 6 为使用 Spring 框架来更新数据库的一个示例。虽然 "PreparedStatement" 语义没有在代码清单中出现,但本例中使用的 JdbcTemplate 的特殊的更新方法的确使用了 PreparedStatement。JDBC 的标准用法要求捕获 SQLException,并且必需一个 finally 程序块来确保关闭语句。代码清单 6 中的基于 Spring 的代码则不需要这些。 注意在代码清单 6 中的可执行代码中没有显式地提及 PreparedStatement。使用这个方便的 JdbcTemplate 更新方法的开发人员不需要关心 PreparedStatement 的具体用法、其 API 或 SQLException。注意开发人员使用了一个匿名内部类,以提供要和 SQL 字符串一起传递给 JdbcTemplate.update 方法的值。 使用 Oracle 特有的 SQL 语句 Spring 框架的一个有用的特点是它仅专注于“包装”JDBC 开发的最常用和最麻烦的方面,而不会过度阻止在需要的时候使用专有的 SQL/JDBC。虽然我们都希望使我们的代码完全标准化(如果这样做对我们无任何影响或有些一定影响),但有很多时候使用特殊的供应商特有的特性将是谨慎甚至必须的做法。 在 Oracle 范畴中的一个示例就是使用 Oracle 的 ROWID 来唯一描述 Oracle 表中的行。代码清单 7 和 8 显示了传统的基于 JDBC 和 Spring 的 JDBC 代码,它们分别根据提供的员工号从 scott/tiger EMP 表中检索 ROWID。在两种情况下都提供了一个作为字符串返回的 ROWID。 String queryStr = "SELECT rowid FROM emp WHERE empno = " 代码清单 8 String queryStr = "SELECT rowid FROM emp WHERE empno = "除了显示 Spring 框架支持 Oracle 特有的关键字的灵活性之外,代码清单 8 还显示了 Spring 的 DAO 异常之一的用途。在代码清单 8 中,如果不小心编辑了 queryStr 来返回所有的 ROWID,那么将抛出 IncorrectResultSizeDataAccessException。 专有 Oracle SQL 的最为大家所熟悉的例子可能是无处不在的查询 SELECT sysdate FROM dual。代码清单 9 显示了这个 Oracle 特有的查询(不是 ANSI 标准的一部分)如何与 Spring 框架一起使用。 String queryStr = "SELECT sysdate FROM dual";DDL 语句与 Spring 和 JDBC 前面的代码代码清单演示了使用 Spring 框架来处理 DML 语句。Spring 框架提供了非常简单的语义来支持 DDL 语句。代码清单 10 和 11 演示了用来执行从 Oracle 数据库中删除和清除表的语句的标准 JDBC 代码和 Spring 包装的 JDBC 代码。 Statement stmt = null; 代码清单 11 try这时应该很明显,基于 Spring 的代码比直接的 JDBC 代码要更易于阅读(以及编写和维护)。实际上,这个代码清单中只有两行是绝对必需的,因为捕获的异常是一个非强制异常。 利用 Spring 框架访问存储过程 代码清单 13 和 14 分别演示了从直接的 JDBC 和 Spring 包装的 JDBC 来访问一个经过设计的存储过程(如代码清单 12 所示)。 CREATE OR REPLACE PROCEDURE salary_percentile ( 代码清单 13 String escapeString = "{call salary_percentile (?,?,?,?)}";代码清单 14 中的使用基于 Spring 的代码来访问存储过程的示例演示了 org.springframework.jdbc.object.StoredProcedure 类的用法。(包含这个 StoredProcedure 类的 Spring 程序包也包含了除存储过程调用之外的其他类型的 SQL 语句的对象表示。关于其他 SQL 语句类型的对象程序包和对象表示的更多详细信息,请参见 Spring 的文档。) private class SalaryCalculator extends StoredProcedure代码清单 14 中的程序在单个类中表示代码。该代码清单中显示的代码的主体是一个扩展了 Spring 的 StoredProcedure 的内部类 (SalaryCalculator)。这个由开发人员创建的类包装了代码清单 12 中显示的存储过程。调用 SalaryCalculator 类只需要几行代码。因此,SalaryCalculator 类对调用存储过程所涉及的大部分问题进行了抽象化。 虽然开发人员必须编写扩展 StoredProcedure 的类,但这么做(而不是直接编写存储过程访问)将带来相应的好处。一个好处是能够使用 Spring 的特有的非强制 DAO 和 JDBC 异常而不是通用的强制 SQLException。此外,正如代码代码清单所示,处理关闭资源的烦琐工作被抽象化了。 注意在将小于 0 的薪水值传给存储过程时代码清单 13 和代码清单 14 返回的结果的差异是很有趣的。在直接的 JDBC 的情况下(代码清单 13),将返回值 0.0,而 wasNull() 是确定结果是否真正为空的唯一方式。在基于 Spring 的代码中(代码清单 14),这种情况下将返回一个 Java null,无需 wasNull() 调用。 利用 Spring 访问 Oracle 对象 Spring Framework 的 JDBC 抽象可以与 Oracle 对象(例如在代码清单 15 中创建的对象)结合使用。 CREATE OR REPLACE TYPE address_type AS OBJECT利用 JDBC 访问 Oracle 对象存在两种常用的方法。一种方法是将标准的 JDBC 接口 java.sql.Struct 与其 Oracle 驱动程序特有的类实施 oracle.sql.STRUCT 结合使用。第二种方法是创建与 Oracle 对象类型映射的 Java 类。将 Oracle 对象与 Oracle JDeveloper 10g IDE 和 JPublisher 结合使用是件轻而易举的事。 使用 java.sql.Struct 方法或 JPublisher 方法的一个有趣的“副作用”:如果您想在这些对象中访问数据,那么必须处理 SQLException。例如,使用 java.sql.Struct 方式,getAttributes() 方法将抛出 SQLException。同样,JDeveloper/JPublisher 创建的 Java 类也将包含抛出 SQLException 的方法。访问这些 Java 对象的开发人员将必须处理这些 SQLException,或者可以使用 Spring(如代码清单 16 和 17 所示)。 String queryStr = "SELECT address FROM emp_address_table WHERE " 代码清单 17 String updateStr = "UPDATE emp_address_table SET address = ? "在利用 JDBC 访问 Oracle 对象的两种方式下(Struct 和 SQLData)都将使用抛出 SQLException 的方法来访问返回的类。代码清单 16 和 17 显示了如何使用匿名内部回调类来将 SQLException 隐藏在特有的非强制 Spring 框架异常层次结构之后。这些重新抛出的异常利用了与本文中的其他示例相同的异常转换。这些代码清单不仅专门演示了如何处理 Oracle 对象的基于 Spring 的访问,还演示了在其他的 JdbcTemplate 常规方法不适用时如何使用匿名内部回调类。 在代码清单 16 中,您将在本文中第一次看到在基于 Spring 的代码中出现 ResultSet 和 SQLException。不过,注意甚至在这些代码中也没有直接使用 |
星期日, 十一月 26, 2006
在 Oracle JDBC 访问中加入一些 Spring 特性zz
订阅:
博文评论 (Atom)
1 条评论:
c为初学者编写代码示例
显示数字是奇数还是偶数
发表评论