使用DOM和XSL来格式化由Java提取的数据

核心提示：java可从任何JDBC兼容数据库提取数据，将数据转换成一个DOM对象，使用DOM和XSL来格式化由Java提取的数据，然后用XSL将数据格式化成需要的形式，在上一篇文章中，随后，输出可由任何应用程序使用，我们演示了如何从数据库中程序化地提取数据，现在

　　java可从任何JDBC兼容数据库提取数据，将数据转换成一个DOM对象，然后用XSL将数据格式化成需要的形式。在上一篇文章中，我们演示了如何从数据库中程序化地提取数据。现在，让我们讨论如何生成DOM对象，并用一个XSL样式表来格式化数据。这样一来，最终的输出就可用于任何应用程序，只要你为它们提供需要的输入。



生成DOM文档


Java的最新版本支持JAXP xml处理，并实现了由万维网协会（W3C）定义的DOM API。使用这些相容于JAXP的版本，只需3行代码即可创建一个DOM文档对象，其中用到了JAXP factory和builder方法：


DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
Document document = builder.newDocument();

我们创建一个名为resultset的根元素，并把它添加到文档对象中


Element root = document.createElement("resultset");
document.appendChild(root);

resultset游标遍历结果集时，在根元素中添加包含行数据的一个新元素：


Element nextRow = document.createElement("row");

列计数必须从ResultSetMetaData对象中读取；在本项目的数据库数据提取阶段，它必须是已经定义好的：

int columnCount = rsmd.getColumnCount();

列名要用for循环来检索；针对每个列名，都添加一个name节点，它带有一个子TextNode，其中包含用于一个names元素的名值：


String[] columnNames = new String[columnCount];
Element names = document.createElement("names");
for (int i = 0; i 〈 columnCount; i++){
/* the first column is 1, the second is 2, ... */
columnNames[i] = rsmd.getColumnName(i + 1);
Element nextNameNode = document.createElement("name");
Text nextName = document.createTextNode(columnNames[i]);
nextNameNode.appendChild(nextName);
names.appendChild(nextNameNode);
}

列索引从1开始，而非从0开始。读取每个数据行时，列值都在一个for循环中作为字符串来泛化地检索，这个for循环将读取每一个列值：



/* Move the cursor through the data one row at a time. */
while(resultSet.next()){
/* Create an Element node for each row of data. */
Element nextRow = document.createElement("row");
if (debug) System.out.PRintln("new row");
for (int i = 0; i 〈 columnCount; i++){
/* Create an Element node for each column value. */
Element nextNode = document.createElement(columnNames[i]);
/* the first column is 1, the second is 2, ... */
/* getString() will retrieve any of the basic SQL types*/
Text text = document.createTextNode(resultSet.getString(i + 1));
nextNode.appendChild(text);
nextRow.appendChild(nextNode);
}
root.appendChild(nextRow);
}

所有数据都转换到一个DOM文档对象中之后，连接就可关闭。DataBaseHandler永远不需要进行文件操作。XML文档是在内存中创建的。
一个具体的DataBaseHandler对象


使用少数几行代码，即可构造一个泛化的DefaultDataBaseHandler：



public class DefaultDataBaseHandler extends AbstractDataBaseHandler{

public DefaultDataBaseHandler(String urlString, String userName,
String passWord, String driverName){

setUrlString(urlString);
setUserName(userName);
setPassword(password);
setDriverName(driverName);
}
}

OracleDataBase处理程序稍微有点儿复杂：

public class OracleDataBaseHandler extends AbstractDataBaseHandler{

private String thinOraclePrefix = "jdbc:oracle:thin:@";
private String urlString;
private String userName;
private String password;
private String driverName = "oracle.jdbc.OracleDriver";
private String host;
private String port;
private String sid;

public OracleDataBaseHandler(String host, String sid,
String userName, String password){

this.host = host;
this.sid = sid;
/* a valid url connection string format is: "host:port:sid" */
setUrlString(thinOraclePrefix + host + ":1521:" + sid);
setUserName(userName);
setPassword(password);
}

public OracleDataBaseHandler(String host, String port, String sid,
String userName, String password){

this.host = host;
this.sid = sid;
this.port = port;
/* a valid url connection string format is: "host:port:sid" */
setUrlString(thinOraclePrefix + host + ":" + port + ":" + sid);
setUserName(userName);
setPassword(password);
}
}

ODBCDataBaseHandler区别不大，只是它处理的是数据源名称（DSN），而非主机名称、端口和SID。之所以要使用与Oracle数据库有关的主机名称、端口号和SID，是因为我们处理的是一个数据库服务器，而不是一个数据库文件。但是，Microsoft access关系数据库要使用.mdb文件：

public class ODBCDataBaseHandler extends AbstractDataBaseHandler{

private String urlString;
private String userName;
private String password;
private String driverName = "sun.jdbc.odbc.JdbcOdbcDriver";
private String dsn;
private String odbcPrefix = "jdbc:odbc:";
public ODBCDataBaseHandler(String dsn, String userName, String password){
/* a valid url connection string format is: "jdbc:odbc:dsn" */
this.dsn = dsn;
setUrlString(odbcPrefix + dsn);
setUserName(userName);
setPassword(password);
setDriverName(driverName);
}
}

要了解访问一种特定数据库的细节，请查阅产品文档。你需要用另一个类来调用一个具体的DataBaseHandler，并进行XSL转换，从而将数据库结果转换成一种有用的替代输出类型。
SQLMapper

SQLMapper类用一个DataBaseHandler类来完成它的数据库工作，并用一个映射方法将文档对象转换成需要的输出类型。映射方法返回一个字符串，因为原来就假定输出由字符数据构成。另外，也可以使用一个StringBuffer。

SQLMapper需要一个SQL查询字符串、一个输出类型集以及一个用于执行具体工作的DataBaseHandler。它们用set方法来初始化，并用get方法来检索：




if ((getSQL() != null)
&& (getSQL().length() 〉 0)
&& (getOutputType() != null)
&& (isValidOutputType(getOutputType()))
&& (getDataBaseHandler() != null)){
Document document = dataBaseHandler.getDocument(getSQL());

为了转换成需要的输出，需要在set方法中指定一个XSL样式表。我们创建了一个Transformer对象，它只提供一个私有getTransformer方法。该方法可获取一个默认样式表或者指定的样式表。如有必要，可使用Java的TransformerFactory方法来生成一个样式表：



TransformerFactorytransformerfactory = TransformerFactory.newInstance();
transformer = transformerfactory.newTransformer(getStylesheet());

同样只需要几行Java代码就可完成转换：


Transformer transformer = getTransformer();
StringWritersw = new StringWriter();
StreamResult result = new StreamResult(sw);
if (transformer != null) {
transformer.transform(new DOMSource(document.getDocumentElement()), result);
output = sw.toString();
System.err.println("output: " + output);
}else{
System.err.println("No Transformer");
}

Transformer对象需要一个DOMSource对象。为了获得这个对象，我们向Transformer的构造函数传递一个DOM文档的根元素。

最后要由实现者设计自己的XSL样式表。也可选用一些默认样式表，以便将原始数据转换成Html或者XML。下面是一个泛化的XSL样式表，它能使用所谓的“标识转换”（identity transformation）技术，将生成的数据转换成一个XML文档，并确保输出内容相容于UTF-8标准，并具有良好的可读性。

〈?xml version="1.0" encoding="UTF-8"?〉
〈xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"〉
〈xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes" /〉
〈xsl:template match="@*node()"〉
〈xsl:copy〉
〈xsl:apply-templates select="@*node()"/〉
〈/xsl:copy〉
〈/xsl:template〉
〈/xsl:stylesheet〉


下面是一个泛化的XSL样式表，它能将生成的数据转换成一个HTML表格：




〈?xml version="1.0" encoding="UTF-8"?〉
〈xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"〉
〈xsl:output method="html" indent="yes" /〉

〈xsl:template match="resultset"〉
〈h2 align="center"〉Default HTML Transform Result〈/h2〉
〈table border="1" align="center"〉〈xsl:apply-templates/〉〈/table〉
〈/xsl:template〉
〈xsl:template match="names"〉
〈tr〉〈xsl:apply-templates/〉〈/tr〉
〈/xsl:template〉
〈xsl:template match="name"〉
〈td〉〈xsl:apply-templates/〉〈/td〉
〈/xsl:template〉
〈xsl:template match="row"〉
〈tr〉〈xsl:apply-templates/〉〈/tr〉
〈/xsl:template〉
〈xsl:template match="*"〉
〈td〉〈xsl:apply-templates/〉〈/td〉
〈/xsl:template〉

〈/xsl:stylesheet〉

下面是一个泛化的XSL样式表，它将生成的数据转换成一个WML（无线标记语言）表格：


〈?xml version="1.0" encoding="UTF-8"?〉
〈xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"〉
〈xsl:output method="html" indent="yes" /〉
〈xsl:template match="resultset"〉
〈wml〉
〈card id="index" title="Default WML Transform Result"〉
〈xsl:apply-templates/〉〈/card〉
〈/wml〉
〈/xsl:template〉
〈xsl:template match="names"〉
Names: 〈xsl:apply-templates/〉
〈/xsl:template〉
〈xsl:template match="name"〉
〈i〉〈xsl:apply-templates/〉〈/i〉
〈/xsl:template〉
〈xsl:template match="row"〉
〈card〉〈xsl:apply-templates/〉〈/card〉
〈/xsl:template〉
〈xsl:template match="*"〉
〈i〉〈xsl:apply-templates/〉〈/i〉
〈/xsl:template〉

〈/xsl:stylesheet〉

下面是一个泛化的XSL样式表，它将生成的数据转换成以逗号分隔的一个表格（CSV表格），它可直接用Excel读取：



〈?xml version="1.0" encoding="UTF-8"?〉
〈xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"〉
〈xsl:output method="text" indent="yes"/〉
〈xsl:template match="names"〉
〈xsl:for-each select="*"〉
〈xsl:if test="position() != last()"〉〈xsl:value-of select="."/〉,〈/xsl:if〉
〈xsl:if test="position() = last()"〉〈xsl:value-of select="."/〉〈/xsl:if〉
〈/xsl:for-each〉
〈/xsl:template〉
〈xsl:template match="row"〉
〈xsl:for-each select="*"〉
〈xsl:if test="position() != last()"〉〈xsl:value-of select="."/〉,〈/xsl:if〉
〈xsl:if test="position() = last()"〉〈xsl:value-of select="."/〉〈/xsl:if〉
〈/xsl:for-each〉
〈/xsl:template〉
〈/xsl:stylesheet〉

运用SQLMapper的一些思路


后端数据库可以使用一个表来定义网页用户界面的表单元素。在一个jsp页中，只需几行代码即可检索这个表。你的Web服务器也许安装了一个Oracle数据库，但是没有前端图形用户界面。现在就可以定义一个GUI的元素，让数据库正式工作起来：


〈%@ page language="java" contentType="text/html" import="sqlmapper.*, mywebapp.* %〉
〈%@ page errorPage="errorPage.jsp" %〉
〈html〉
〈!-- getUserArea.jsp executed on 〈%= (new java.util.Date()) %〉 --〉
〈!-- @Author: Charles Bell --〉
〈!-- @Version: April 22, 2003 --〉
〈head〉
〈title〉Your company name - 〈%= dynamicTitle %〉〈/title〉
〈/head〉
〈body background="〈%= dynamicBackgroundImageFileName%〉"〉
〈%
WebAppUtilitymyWebAppUtility = new WebAppUtility();
String host = myWebAppUtility.getDatabaseHost();
String sid = myWebAppUtility.getDatabaseSID();
String userName = (String) session.getAttribute("validatedUserName");;
String password = myWebAppUtility.getDatabasePassord();
SQLMapper mapper = new SQLMapper();
DataBaseHandler dataBaseHandler=
new OracleDataBaseHandler(host, sid, userName, password);

mapper.setSQL("select * from FormDataElements");
mapper.setOutputType("html");
mapper.setDataBaseHandler(dataBaseHandler);
mapper.setXSLTranformStyleSheet("stylesheets/formdata.xsl");
out(mapper.map);
%〉
〈%@include file="footer.jsp" %〉
〈/body〉
〈/html〉

使用这些技术，只需单击一个按钮，JSP网页即可弹出最新的、根据一个活动数据库而动态生成的报表。CSV输出可用于生成动态的Excel电子表格。XML输出可为另一个Web应用程序提供服务，该应用程序将与它自己的后端数据库进行通信。


小结

我们介绍了如何创建一个接口来定义DataBaseHandler的泛化行为，并用一个抽象类来实现它，以便将这个抽象类扩展成一个定制的、具体的数据库处理程序，所有操作只需几行Java代码。SQLMapper类利用这种行为来透明连接一个关系数据库，执行SQL查询，并将数据转换成一个DOM文档对象。然后，通过应用一个XSL样式表来获取需要的输出，从而完成一个DOM对象的转换。随后，输出可由任何应用程序使用，只需采用一种有效的、易于实现的方式来提供需要的输入。