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对象的转换。随后,输出可由任何应用程序使用,只需采用一种有效的、易于实现的方式来提供需要的输入。
|