要在 Web 應用裡用 XML 設定資料來源,一般可以拆成下列幾個步驟。
本例把設定檔放在 /WEB-INF/ 目錄下,當然也可以放到別處,只是讀取時的寫法要跟著調整。
(1)MS SQL 的設定檔 /WEB-INF/mssql.XML:
< XML version="1.0" encoding="UTF-8">
< DataSource>
< !-- configure the datasource of MSSQL -->
< DatabaseUser>sa< /DatabaseUser>
< DatabasePassword>jckjdkmcj< /DatabasePassWord>
< DatabaseName>northwind< /DatabaseName>
< ServerName>10.0.0.168< /ServerName>
< ServerPort>1433< /ServerPort>
< MaxConnections>100< /MaxConnections>
< /DataSource>
(2)Oracle 的設定檔 /WEB-INF/Oracle.XML:
< XML version="1.0" encoding="UTF-8">
< DataSource>
< !-- configure the datasource of MSSQL -->
< DatabaseUser>zhangyi< /DatabaseUser>
< DatabasePassword>jckjdkmcj< /DatabasePassWord>
< DatabaseName>zydb< /DatabaseName>
< ServerName>10.0.0.168< /ServerName>
< ServerPort>1521< /ServerPort>
< MaxConnections>100< /MaxConnections>
< /DataSource>
注意:這兩個檔案的結構完全相同,因為後續解析時我們沿用同一組介面。
這裡定義了一個 config.java,作為解析 XML 檔的父類別:
/*
* Created on 2005-8-29
*
* the supper class for parse the XML files
*
*/
package zy.pro.wd.XML;
import Java.io.InputStream;
import Javax.XML.parsers.*;
import Javax.servlet.ServletContext;
import org.XML.sax.InputSource;
import org.w3c.dom.*;
/**
* @author zhangyi
*
*/
public abstract class Config {
/**
* the supper class for parse the XML files
*/
protected Element root;
protected void init(ServletContext sctx, String XMLFile) throws Exception {
InputStream is=null;
try{
is=sctx.getResourceAsStream(XMLFile);
DocumentBuilderFactory factory=DocumentBuilderFactory.newInstance();
DocumentBuilder builder=factory.newDocumentBuilder();
Document doc=builder.parse(new InputSource(is));
root=doc.getDocumentElement();
System.out.println("root: "+root );
}catch(Exception e){
e.printStackTrace();
}finally{
if(is!=null){
is.close();
}
}
}
protected String getElementText(Element parent,String name){
NodeList nodeList=parent.getElementsByTagName(name);
if(nodeList.getLength()==0){
return null;
}
Element element=(Element)nodeList.item(0);
StringBuffer sb=new StringBuffer();
for(Node child=element.getFirstChild();child!=null;child=child.getNextSibling()){
if(child.getNodeType()==Node.TEXT_NODE){
sb.append(child.getNodeValue());
}
}
return sb.toString().trim();
}
protected void cleanup(){
root=null;
}
}
這個父類別負責三件事:用 ServletContext 把 XML 讀成串流並解析為 DOM、以 getElementText() 取出指定元素內的文字節點值,以及用 cleanup() 釋放參照。
接著定義 DataSourceConfig.java,把各欄位名稱固定下來並對應成屬性:
/*
* Created on 2005-8-29
*
* reading the JDBC datasource propertIEs from XML files
*
*/
package zy.pro.wd.XML;
import Javax.sql.DataSource;
import Javax.servlet.ServletContext;
/**
* @author zhangyi
*
*/
public abstract class DataSourceConfig extends Config {
private static final String DATABASE_USER = "DatabaseUser";
private static final String DATABASE_PASSWORD = "DatabasePassWord";
private static final String SERVER_NAME = "ServerName";
private static final String DATABASE_NAME = "DatabaseName";
private static final String SERVER_PORT = "ServerPort";
protected DataSource ds;
protected String databaseUser;
protected String databasePassWord;
protected String serverName;
protected String portNumber;
protected String databaseName;
public void init(ServletContext sctx,String XMLFile) throws Exception{
super.init(sctx,XMLFile);
databaseUser=this.getElementText(root,DATABASE_USER);
System.out.println("< br>databaseUser: "+databaseUser);
databasePassword=this.getElementText(root,DATABASE_PASSWord);
System.out.println("< br>databasePassword: "+databasePassWord);
databaseName=this.getElementText(root,DATABASE_NAME);
System.out.println("< br>databaseName: "+databaseName);
serverName=this.getElementText(root,SERVER_NAME);
System.out.println("< br>serverName: "+serverName);
portNumber=this.getElementText(root,SERVER_PORT);
System.out.println("< br>portNumber: "+portNumber);
}
public DataSource getDataSource(){
return ds;
}
}
(1)MS SQL 的實作類別 MSSQLConfig.java:它在父類別讀好的欄位之上,再組出連線字串並建立連線池(後續接續設定最大連線數等參數):
/*
* Created on 2005-8-31
*
*/
package zy.pro.wd.XML;
import Javax.servlet.ServletContext;
import org.apache.commons.dbcp.BasicDataSource;
import com.microsoft.jdbc.base.BaseConnectionPool;
/**
* @author zhangyi
*
*/
public class MSSQLConfig extends DataSourceConfig {
private static final String MAX_CONNECTIONS = "MaxConnections";
public void init(ServletContext ctx, String XMLFile) throws Exception {
super.init(ctx, XMLFile);
String databaseURL = "jdbc:microsoft:sqlserver://" + this.serverName + ":"
+ this.portNumber + ";databaseName=" + this.databaseName;
System.out.println("< br> databaseURL : " + databaseURL);
// 後續在此以 databaseURL、帳號、密碼與最大連線數建立連線池
}
整體設計的巧思在於:XML 檔結構一致,解析邏輯集中在 Config 與 DataSourceConfig 兩層,各資料庫的差異只落在實作類別裡組連線字串的那幾行。要支援新的資料庫,只要多寫一個子類別與一份 XML 檔即可,不必動到解析核心。