从JDBC数据库提取对XML/DOM友好的数据

　　当前的Java版本提供了完备的工具，可将输出内容从关系数据库查询转换成XML。最终获得的将是一个DOM（文档对象模型）文档对象。利用XSL（可扩展样式语言），它进而能转换成任意输出格式。本文介绍如何构建一个接口，用它读取与JDBC兼容的任何关系数据库，创建一个结果集，以便转换成任何类型的字符输出。
　　
　　接口
　　最开始必须定义一个接口。这个接口在实现后，应该能建立一个数据库连接、向其传递一个SQL查询、读取结果以及创建一个DOM文档对象。下面的DataBaseHandler接口定义了与数据库进行交互的行为（注重，本例缺少import语句，所以不能编译）。尤其要注重的是，getDocument()查询所返回的文档将由其他进程转换成所需的输出类型，这种转换是独立于数据库的。
　　
　　public interface DataBaseHandler{
　　
　　Document getDocument(String sqlQuery);
　　String getUrlString();
　　void setUrlString(String urlString);
　　String getUserName();
　　
　　void setUserName(String userName);
　　String getPassWord();
　　void setPassword(String password);
　　String getDriverName();
　　void setDriverName(String driverName);
　　}
　　
　　这是与数据库交互所需的最起码的行为。它包括几个get和set方法，用于确保数据库驱动程序名称、用户名和密码都得到了设置，或者以后能够检索到。下面总结了DataBaseHandler的需求：
　　
　　urlString
　　userName
　　password
　　sqlQuery string
　　driverName
　　调用set方法之后，getDocument()方法将完成所有实际的工作：
　　
　　Document getDocument(String sqlQuery);
　　
　　传给set方法的所有输入都可能已经传给getDocument()方法。从重用性的角度说，应该对这两个方法进行分隔，使类的实现能方便和灵活地利用这种多重输入传递功能。
　　
　　接口的一个抽象实现
　　接着要定义一个抽象类，它负责实现要求的大多数行为和操作，但某种特定数据库类型需要的那些行为必须排除在外。AbstractDataBaseHandler执行set和get方法的泛化操作，而且一旦设置好所有数据库处理参数，AbstractDataBaseHandler就要执行与数据库进行交互的泛化操作。惟一需要拿掉的就是与特定数据库类型有关的那些细节，以及为了获得DataBaseHandler的一个具体实现而必须定义的设置细节。
　　
　　get和set方法负责设置私有类变量；通过扩展AbstractDataBaseHandler而创建数据库处理器对象时，这些私有类变量将发生变化。这个过程是非常直观易懂的，如清单A所示。
　　
　　getDocument()方法中的操作位于一个try catch块中。数据库事务处理过程中一旦发生任何错误，或者要求的任何输入参数没有设置，错误就会被捕捉。SQLException答应多个异常链接到一起，这为我们带来了极大的方便。你必须遍历SQLException，检查数据库交互过程中可能发生的所有问题。
　　
　　} catch (SQLExceptionsqle) {
　　while(sqle != null) {
　　System.err.println ("**** SQLException ****\n");
　　System.err.println ("** SQLState: " + sqle.getSQLState() + "\n");
　　System.err.println ("** Message: " + sqle.getMessage() + "\n");
　　System.err.println ("** Error Code: " + sqle.getErrorCode() + "\n");
　　System.err.println ("***********\n");
　　/* There could be multiple exception messages chained together. */
　　sqle= sqle.getNextException();
　　
　　和其他任何异常一样，你可以为异常处理实现一个Java日志，用它记录发生的任何问题。必须确保可能发生的所有异常都包含在try catchā?????块中，以便分门别类地采取操作，让用户知道执行期间发生了什么问题。下面总结了SQLException包含的信息：
　　
　　描述错误一个字符串
　　一个SQLstate字符串 string
　　一个整型错误代码，它是不同的厂商特有的
　　到下一个异常的链接
　　getDocument()方法首先检查要求的所有参数是否齐备，否则引发一个异常：
　　
　　if(getUrlString() == null){
　　throw new Exception("Database URL String is not set.");
　　}
　　if(getUserName() == null){
　　throw new Exception("Database User Name is not set.");
　　}
　　if (getPassword() == null){
　　throw new Exception("Database Password is not set.");
　　}
　　if (getDriverName() == null){
　　throw new Exception("Database Driver Name is not set.");
　　}
　　
　　一个SQL查询字符串作为输入来传递。它可为你需要的任何SQL字符串，比如：
　　
　　SELECT * from mytable;
　　SELECT overdue, name, duedate, description from myactiontable;
　　
　　接着创建JDBC驱动程序的一个实例，它向DriverManager注册驱动程序：
　　
　　Class.forName(getDriverName());
　　
　　DriverManager现在可使用注册的驱动程序来创建一个数据库连接，并接管所有数据库操作。
　　
　　
　　不同的数据库要使用不同的URL连接字符串。对于Oracle数据库，字符串的形式是：
　　
　　host:port:sid
　　
　　具体需要的值是在tsnames配置文件中定义的，该文件的名称是tnsnames.ora，其中的设置项如下所示：
　　
　　mydb =
　　(DESCRIPTION =
　　(ADDRESS =
　　(PROTOCOL = TCP)
　　(Host = SERVERX.www.mycompany.com)
　　(Port = 1521)
　　)
　　(CONNECT_DATA =
　　(SID = examplesid)
　　(GLOBAL_NAME = exampledb)
　　)
　　)
　　
　　然后根据前面设置的URL字符串、用户名和密码来创建一个Connection对象，再用Connection对象来创建一个Statement对象，并针对数据库执行查询，以便返回一个结果集对象。所有细节由JDBC无缝地处理。
　　
　　取决于具体的SQL语句，语句执行之后也许不会返回任何值。这个类验证是否缺少返回值，只有在至少返回了一个数据行的前提下，才在文档中添加Element节点。列名要从一个ResultSetMetaData对象中检索，该对象是通过结果集的一个get方法来获得的：
　　ResultSetMetaDatarsmd = resultSet.getMetaData();
　　
　　在一个while循环中，将使用结果集的游标或行号来遍历整个结果集，同时生成一个DOM文档对象。
　　
　　while(resultSet.next()){
　　// add Element and TextNode objects which define each row and each data column.
　　}
　　
　　处理了ResultSet及其元数据后，就结束了与数据库的交互。之后，就可用XML/DOM对象来容纳数据，并用XSL来格式化数据。
　　
　　小结
　　本文讲述了如何创建一个接口，以便为DataBaseHandler定义泛化行为，以及如何用一个抽象类来实现它，以便将抽象类扩展成一个具体的、自定义的数据库处理程序。这种行为答应你透明地连接一个关系数据库，执行SQL查询，并返回一个结果集，随后可以将它的数据转换成一个DOM文档对象。