Teambiz中從Sql到XML的轉化過程
作者：何楊
撰寫日期：2012年2月23日
版本：1.00
更新日期：2012年2月24日
第一部分：功能說明
將后臺編寫的SQL語句，向數(shù)據(jù)庫請求后獲得的數(shù)據(jù)，整理成XML格式的文本。
第二部分：核心組件
| 名稱 | 路徑 | 說明 |
| JdbcDao | com.ibm.heyang.dao.base.JdbcDao | 此類中的fetchRecords函數(shù)用來取得數(shù)據(jù)庫中的數(shù)據(jù)， |
| NameValueRowMapper | com.ibm.heyang.dao.rowmapper.NameValueRowMapper | 此類用于將進行數(shù)據(jù)庫查詢得到的行集轉化為一個NameValue鏈表對象。 |
| NameValue | com.ibm.heyang.domain.NameValue | 此類用于存儲行集中某字段的名稱和值，在將對象鏈表轉化為XML的過程中使用了它的函數(shù)asXML()。 |
| NameValueList | com.ibm.heyang.domain.NameValueList | 內含一個鏈表，用于容納NameValue對象鏈表，在將對象鏈表轉化為XML的過程中使用了它的函數(shù)asXML()。 |
第三部分：從SQL語句向XML的轉化過程
NameValueRowMapper負責查詢結果集一個行的轉換，對于其中的每個字段，會形成一個字段名和字段值的NamaValue對象，然后放到一個類型為List<NameValue>的鏈表中。最終，這個鏈表對應著這個行集，鏈表里面的每個元素對應著一個字段（包含其名及值）。
NameValueList用于容納每個行形成的鏈表，它本身和查詢結果集是對應的。
得到最終的NameValueList之后，調用其asXML方法，將遍歷其中的每個元素，得到行集鏈表，再遍歷其中的NameValue對象，再調用每個對象的asXML函數(shù)，得到XML文本。
以下展示了兩個關鍵函數(shù)：
NameValueList對象的asXML函數(shù)如下：
public String asXML() {
StringBuilder sb=new StringBuilder();
for(Object obj:list){
List<NameValue> ls=(List<NameValue>)obj;
sb.append("<node>");
for(NameValue nv:ls){
sb.append(nv.asXML());
}
sb.append("</node>");
}
return sb.toString();
}
以上粗體部分是每個行的標志，在前臺頁面對XML進行解析時還要使用到它，這已經(jīng)形成了前后臺之間的一個約定。
NameValue對象的asXML函數(shù)如下：
public String asXML() {
StringBuilder sb=new StringBuilder();
sb.append("<"+name+">");
sb.append(StringUtils.isBlank(value)?"-":value);
sb.append("</"+name+">");
return sb.toString();
}
第四部分：效果展示
SQL語句示例：
select text, url, level from teambiz_menu where level<=2 order by level
使用SQL語句從數(shù)據(jù)庫查詢出來的結果集：
最終得到的XML文本：
<node>
<text>登出</text>
<url>Logout.do</url>
<level>0</level>
</node>
<node>
<text>修改自己信息</text>
<url>Goto.do?page=/page/jsp/user/modify/index.jsp</url>
<level>1</level>
</node>
<node>
<text>建立聯(lián)系</text>
<url>Goto.do?page=/page/jsp/relation/create/index.jsp</url>
<level>1</level>
</node>
<node>
<text>我發(fā)出去的聯(lián)系</text>
<url>Goto.do?page=/page/jsp/relation/sent/index.jsp</url>
<level>1</level>
</node>
<node>
<text>發(fā)給我的聯(lián)系</text>
<url>Goto.do?page=/page/jsp/relation/received/index.jsp</url>
<level>1</level>
</node>
<node>
<text>創(chuàng)建任務</text>
<url>Goto.do?page=/page/jsp/task/create/index.jsp</url>
<level>1</level>
</node>
<node>
<text>我發(fā)出去的任務</text>
<url>Goto.do?page=/page/jsp/task/sent/index.jsp</url>
<level>1</level>
</node>
<node>
<text>發(fā)給我的任務</text>
<url>Goto.do?page=/page/jsp/task/received/index.jsp</url>
<level>1</level>
</node>
<node>
<text>今日待辦任務/已辦任務</text>
<url>Goto.do?page=/page/jsp/task/tododone/index.jsp</url>
<level>1</level>
</node>
<node>
<text>用戶管理</text>
<url>#</url>
<level>2</level>
</node>
第五部分：使用步驟
| 步驟 | 說明 | 參照 |
| 編寫SQL語句 | 編寫一個正確的查詢語句，建議使用SqlToolBox進行整形工作。 | 類com.ibm.heyang.dao.MenuDao中的函數(shù)getMenuByUserLevel中的SQL語句。 |
| 使用fetchRecords函數(shù)得到結果集。 | 這個函數(shù)處于com.ibm.heyang.dao.base.JdbcDao類中，無需改動，只需要傳入正確的sql語句和RowMapper即可。 | 類com.ibm.heyang.dao.MenuDao中的函數(shù)getMenuByUserLevel中的List<?> ls=super.fetchRecords(sql,new NameValueRowMapper());一句。 |
| 將結果集用NameValueList包裝起來 | 將結果集傳入NameValueList類的構造函數(shù)即可。 | 類com.ibm.heyang.dao.MenuDao中的函數(shù)getMenuByUserLevel中的return new NameValueList(ls);一句。 |
| 將結果集轉化為XML | 使用NameValueList類的asXML函數(shù)。 | com.ibm.heyang.service.MenuService的getMenuByUserLevel函數(shù)。 |
第六部分：小結
編寫SQL語句并將其轉化為前臺可以辨識的格式是程序員的主要工作負擔，采用以上方式的好處有：
1.整個過程中，一個函數(shù)fetchRecords和三個對象NameValueRowMapper,NameValue,NameValueList都是系統(tǒng)提供的，程序員無需編碼，而只需把SQL語句寫好，放到DAO類的一個函數(shù)中就可以了。
2.任何查詢類的SQL語句，無論字段類型如何，都可以用如上方式處理。
3.如果有特殊的查詢方式，com.ibm.heyang.dao.rowmapper下還提供了很多類供使用，如針對select count(*) from tb的IntegerRowMapper類，針對select * from tb where id=XX 的MapRowMapper類，及將將一行記錄轉化成一個包含鍵值對的鏈表的StringRowMapper等，用戶也可參照UserRowMapper來書寫自己的RowMapper類。這些類的使用將給編碼帶來較大遍歷，關于它們將另行文詳述。