本文整理自一份企業內部訂餐系統的後台管理程式碼,功能聚焦在餐館基本資料的管理。整份範例執行於 TOMCAT 4.01 平台的 B/S 架構之上,Tomcat 本身的安裝設定不在此贅述,以下著重說明目錄結構、各檔案職責與關鍵程式碼。
/tomcat/webapps/canyin/ 主目錄 /tomcat/webapps/canyin/Jsp/ JSP 檔目錄 /tomcat/webapps/canyin/Jsp/admin/ 後台管理 JSP 檔 /tomcat/webapps/canyin/WEB-INF/classes/canyin/ JavaBean 位元碼 /tomcat/webapps/canyin/data/ XML 檔目錄 /tomcat/webapps/ROOT/ Tomcat 啟動目錄,僅放 index.html
data/users.xml:記錄使用者資訊。data/restaurants.xml:記錄餐館基礎資料。ROOT/index.html:首頁,提供帳號與密碼輸入框。Jsp/loginjudge.jsp:身分判定頁,依帳號密碼決定導向後台管理端或前台客戶端;本範例中一旦確認具管理權限,即直接跳往餐館資料管理頁以簡化流程。Jsp/admin/admin_rest.jsp:餐館基本資料管理頁,負責名稱、電話、地址的檢視與維護。checkSessionBean.class:檢查 session 中的身分標記,非管理員則跳回登入頁。connXmlBean.class:負責載入 XML 文件。writeXmlBean.class:負責把 DOM 內容寫回 XML 文件。使用者檔以屬性承載欄位,結構精簡:
<?xml version="1.0" encoding="UTF-8" ?> <users> <user name="joard" password="joard" roles="admin" /> <user name="joard01" password="joard01" roles="user" /> <user name="joard02" password="joard02" roles="user" /> </users>
餐館檔則在根元素上多維護一個 num 屬性:
<?xml version="1.0" encoding="UTF-8" ?>
<restaurants num="10">
<restaurant id="1">
<name>上海亭快餐店</name>
<phone>021-76546726</phone>
<address>百老匯廣場 B 座</address>
</restaurant>
<restaurant id="8">
<name>香格里拉大飯店</name>
<phone>021-2312134</phone>
<address>南京路 1023 號</address>
</restaurant>
</restaurants>
num 的用途值得留意:它記錄這份文件累計曾有多少筆記錄,每新增一筆就加一,即使日後刪除也不回退——作用等同資料庫裡慣用的自動遞增 ID 欄位,用來為新的 <restaurant> 配發唯一的 id。
connXmlBean 負責把檔案讀進 DOM:
public String connXml(String XMLFileName) {
String strExc = "";
try {
factory = DocumentBuilderFactory.newInstance();
builder = factory.newDocumentBuilder();
doc = builder.parse(XMLFileName);
doc.normalize();
} catch (Exception e) {
strExc = e.toString();
}
return strExc;
}
public Document getXMLDoc() { return doc; }
writeXmlBean 負責把 DOM 寫回檔案,用的是 Transformer 而非直接操作檔案串流:
public String writeXml(Document doc, String XMLFileName) {
String strExc = "";
try {
TransformerFactory tfactory = TransformerFactory.newInstance();
Transformer transformer = tfactory.newTransformer();
DOMSource source = new DOMSource(doc);
StreamResult result = new StreamResult(new File(XMLFileName));
transformer.transform(source, result);
} catch (Exception e) {
strExc = e.toString();
}
return strExc;
}
checkSessionBean 則是簡單的 session 比對器,把傳入的名稱與期望值兩相比較,回傳 boolean。三個 Bean 都有一個共同特色:例外不往外拋,而是轉成字串回傳,讓 JSP 端自行決定如何呈現錯誤。
loginjudge.jsp 先用正規表達式檢查帳號密碼是否為空,接著載入 users.xml,以 getElementsByTagName("user") 取出所有 user 節點,逐筆比對 name 與 password 屬性。比對成功後再看 roles:若是 admin 就寫入 sesUserRole = "admin" 並導向 admin/admin_rest.jsp,否則寫入 "user" 並回傳前台首頁。找不到對應帳號時,則用一段 alert 提示後退回上一頁。
這裡有個值得學的細節:session.setMaxInactiveInterval(1800) 明確設定了 30 分鐘的閒置逾時,避免管理 session 長期占著記憶體。
admin_rest.jsp 是整個範例的核心。它一開場先用 checkSessionBean.checkSessionBean(request, "sesUserRole", "admin") 把關,未通過就顯示提示框並導回登入頁。之後依 act 參數分派四種行為:
restaurants 根元素的 num 屬性取出目前計數並加一,寫回 num,然後用 createElement、createAttribute、createTextNode 組出新的 <restaurant> 節點掛到根元素下,最後呼叫 writeXmlBean.writeXml 存盤並重導自身頁面。id 相符的節點並記下索引,同時檢查名稱與電話是否與其他記錄重複,通過後直接以 getFirstChild().setNodeValue(...) 就地改寫 name、phone、address 三個子節點的文字值。doc.getElementsByTagName("restaurants").item(0).removeChild(delNode) 把它從根元素摘除,再存盤。restaurants 完全沒有子節點,則自動把頁面狀態切換為新增。每個寫入動作完成後都會呼叫 response.sendRedirect(request.getRequestURI()),讓瀏覽器重新載入最新資料——這是以重新整理換取資料新鮮度的典型做法。
頁面以純 HTML 表格搭配 JavaScript 完成。checkform() 與 checkform2() 分別服務修改與新增兩種表單,兩者都用同一條正規表達式 /^(\s*|(\ )|(\.))*$/ 判斷輸入是否為空白,若通過檢查則呼叫 submit() 送出。刪除按鈕則用 confirm() 做二次確認後才導向帶著 act=del 的網址。
作者自陳這份程式碼「很多地方並不簡練」,理由是開發過程中過度精簡往往會為後續維護帶來困難——這是一個很務實的取捨觀。
幾點值得記下的經驗:
doc.getElementsByTagName("restaurants").item(i) 的傳回值本身已是 Node 型別,若不需要存取元素專屬的屬性,其實不必強制轉型為 Element,直接操作即可。本系統因參考資料有誤,全部採用了強制轉型,後續開發可以簡化。trim() 與 Integer.parseInt() 都無法接受 null 值,呼叫前必須先防呆。整體而言,這個範例完整示範了「以 XML 檔當資料庫」在 JSP 中的實作樣貌:DOM 負責讀、Transformer 負責寫、JavaBean 封裝細節、JSP 專注流程。它也清楚暴露了這種做法的限制——沒有併發控制、每次操作都要整份重寫、資料量一大就會明顯變慢。適合規模小、讀多寫少的內部工具,若使用者數量成長,就該換成真資料庫了。