這個範例示範如何把 XML 當成選單資料的儲存格式,做出一個可以在瀏覽器上增刪改、再存回 XML 檔案的後台管理介面。技術組合相當經典:JSP 負責頁面與 JavaScript 互動,JSTL 負責把伺服器端的資料集合渲染成表單,Servlet 負責用 DOM 解析與產生 XML,JavaBean 則充當資料載體,最後一層 menus.xsl 把同一份 XML 轉呈為真正可點擊的選單。
forEach 把現有選單結構展開成可編輯表單,並用 JavaScript 在瀏覽器端動態新增或移除節點。頁面先把 .btn input 的樣式定義好,再用三個 JavaScript 函式撐起瀏覽器端的增刪改:newItem() 在目前選單下插入一組子選單輸入框,delItem() 移除所屬的 div,newMenu() 則在按鈕列之前插入一整塊新的選單編輯區。所有欄位都用具名的 form input 承載,送出時以 parent 這個隱藏欄位記錄父子關係。
清單 1. Menu.jsp
<%@page contentType="text/html; charset=GBK"%>
<%@taglib uri="https://java.sun.com/jstl/core_rt" prefix="c"%>
<html>
<head>
<title>menu</title>
<style>
.btn input{
background:#FF6600;
border-left:1px #FFFFFF solid;
border-top:1px #FFFFFF solid;
border-right:1px #990000 solid;
border-bottom:1px #990000 solid;
padding-top:4px;
color:#FFFFFF;
}
</style>
<!-- 以下 JS 腳本處理 menu 的瀏覽器端增、刪、改 -->
<script language="javascript" type="">
function newItem(ele){
var pNode;
var pdiv;
var item_name,item_url,item_tip;
var text1,text2,text3;
pNode = ele.parentNode;
pdiv = document.createElement("<div class='item'></div>");
item_hidden = document.createElement("<input type='hidden' name='parent'
value='"+pNode.childNodes[1].value+"'/>");
text1 = document.createTextNode("子選單名稱:");
item_name = document.createElement("<input type='text' name='menuitem_name'/>");
text2 = document.createTextNode("子選單 URL:");
item_url = document.createElement("<input type='text' name='menuitem_url'/>");
text3 = document.createTextNode("子選單連結說明:");
item_tip = document.createElement("<input type='text' name='menuitem_title'/>");
pdiv.appendChild(item_hidden);
pdiv.appendChild(text1);
pdiv.appendChild(item_name);
pdiv.appendChild(text2);
pdiv.appendChild(item_url);
pdiv.appendChild(text3);
pdiv.appendChild(item_tip);
pdiv.appendChild(document.createElement(
"<input type='button' value='刪除此子選單' onclick='delItem(this)'/>"));
pNode.appendChild(pdiv);
}
function delItem(ele){
var pNode;
var pdiv;
pNode = ele.parentNode.parentNode;
pdiv = ele.parentNode;
pNode.removeChild(pdiv);
}
function newMenu(ele){
var pNode;
var pdiv;
var text1,menunameElement,newmenuBtnElement,delmenuBtnElement;
pNode = ele.parentNode.parentNode;
pdiv = document.createElement("<div style='border:#999999 1px solid;
background:#FFFFCC; padding:5px; margin-bottom:10px; display:block;'></div>");
text1 = document.createTextNode(" 選單:");
menunameElement = document.createElement(
"<input type='text' name='menuname' style='background:#cccccc;'/>");
newmenuBtnElement = document.createElement(
"<input type='button' value='新增子選單' onclick='newItem(this)'/>");
delmenuBtnElement = document.createElement(
"<input type='button' value='刪除此選單' onclick='delItem(this)'/>");
pdiv.appendChild(text1);
pdiv.appendChild(menunameElement);
pdiv.appendChild(delmenuBtnElement);
pdiv.appendChild(newmenuBtnElement);
pNode.insertBefore(pdiv, document.getElementById("btn"));
}
</script>
</head>
<body bgcolor="#ffffff">
<form action="XMLservlet" method="post">
<div style="background:#FFFFFF; border:#333333 1px solid; font-family:Arial;
font-size:12px; padding:5px;">
<div style="border:#999999 1px solid; background:#FFFFCC; padding:5px;
margin-bottom:10px;">
請指定 XML 檔:
<%-- 文件路徑 --%>
<input type="text" name="xmlfilename" value="${XMLfile}"/>
<br/>
<input name="" type="submit"/>
</div>
</div>
</form>
<form action="newXMLservlet" method="post">
<div style="background:#FFFFFF; border:#333333 1px solid; font-family:Arial;
font-size:12px; padding:5px;">
<div style="background:#ff6600; border:#333333 1px solid; font-family:Arial;
font-size:12px; padding:5px;">
${xmlfile} 下的選單結構:
<input type="hidden" name="xmlfile" value="${XMLfile}"/>
</div>
<%-- 透過 JSTL 標準標籤的 forEach 循環輸出 menu --%>
<%-- items 的值是從 request 取得的 menus(bean 的 ArrayList)--%>
<c:forEach var="menu" items="${menus}">
<div style="border:#999999 1px solid; background:#FFFFCC; padding:5px;
margin-bottom:10px; display:block;">
選單:
<input type="text" name="menuname" value="${menu.menu_name}"
style="background:#cccccc;"/>
<input type="button" value="新增子選單" onClick="newItem(this)"/>
<input type="button" value="刪除${menu.menu_name}選單" onclick="delItem(this)"/>
<br/><br/>
<%-- 遍歷輸出子項目資訊 --%>
<c:forEach var="mitem" items="${menuitems}">
<%-- 若該 bean 的 menu_name 等於父元素的 menu_name,就掛到這個 menu 下 --%>
<c:if test="${mitem.menu_name == menu.menu_name}">
<div class="item">
<input type="hidden" name="parent" value="${mitem.menu_name}"/>
子選單名稱:
<input type="text" name="menuitem_name" value="${mitem.menuitem_text}"/>
子選單 URL:
<input type="text" name="menuitem_url" value="${mitem.menuitem_url}"/>
子選單連結說明:
<input type="text" name="menuitem_title" value="${mitem.menuitem_tip}"/>
<input type="button" value="刪除此子選單" onClick="delItem(this)"/>
</div>
<br/>
</c:if>
</c:forEach>
</div>
</c:forEach>
<div class="btn" id="btn" style="border:#999999 1px solid; background:#235478;
padding:5px; margin-bottom:10px;">
<input name="" type="button" value="新增選單" onClick="newMenu(this)"/>
<input name="" type="submit" value="儲存修改"/>
<span style="background:#ffffff;padding:3px;">
<a href="${xmlfile}" target="_blank">瀏覽 XML</a>
</span>
</div>
</div>
</form>
</div>
</body>
</html>
這裡有兩個細節值得注意。第一,父子關係並不是靠 DOM 結構表達,而是靠每個子選單區塊中的隱藏欄位 parent,其值等於所屬選單的名稱——這讓巢狀層級得以攤平成一維的表單欄位陣列。第二,newItem() 透過 pNode.childNodes[1].value 取得父層的選單名稱,這個索引與 HTML 結構的排列順序是綁在一起的,若日後調整標籤順序,這段程式就得跟著改。
這個 Servlet 的任務是把 XML 讀進來、拆成兩組 ArrayList,再交給 Menu.jsp 渲染。流程是:建立 DocumentBuilderFactory 與 DocumentBuilder,解析檔案取得 Document,取得根節點的子節點清單後逐一遍歷;遇到 menu 元素就把它的 name 屬性存進 menuBean 放進 alist_menuname,遇到 items 元素就把 url、tip 與文字內容存進另一個 bean 放進 alist_items。
清單 2. XMLservlet.java
package XTO;
import xmlbean.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;
import javax.xml.parsers.*;
import org.w3c.dom.*;
import org.xml.sax.*;
public class XMLservlet extends HttpServlet {
private static final String CONTENT_TYPE = "text/html; charset=utf-8";
public void init() throws ServletException {
}
private String fs(Object obj) {
if (obj == null) {
obj = "";
}
return obj.toString();
}
// 處理 HTTP GET 請求
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType(CONTENT_TYPE);
request.setCharacterEncoding("GBK");
String xmlfile = "";
// 取得使用者指定的 XML 檔
xmlfile = fs(request.getParameter("xmlfilename"));
if (xmlfile == null || xmlfile.equals("")) {
xmlfile = (String) request.getAttribute("xmlfilename");
}
// 存放 menu name 的 bean 集合
ArrayList alist_menuname = new ArrayList();
// 存放 menu name 與 menu item 資訊的 bean 集合
ArrayList alist_items = new ArrayList();
// 建立 DocumentBuilderFactory,用於解析 XML 文件
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = null;
try {
db = dbf.newDocumentBuilder();
} catch (ParserConfigurationException ex1) {
System.out.print(ex1.toString());
request.setAttribute("Error", ex1.toString());
}
// 讀入 XML 檔
Document doc = null;
try {
doc = db.parse(new File(xmlfile));
} catch (Exception ex) {
System.out.print(ex.toString());
request.setAttribute("Error", ex.toString());
}
Element root = doc.getDocumentElement();
NodeList children = root.getChildNodes();
for (int i = 0; i < children.getLength(); i++) {
Node child = children.item(i);
if (child instanceof Element) {
Element childElement = (Element) child;
if (childElement.getTagName().equals("menu")) {
menuBean mb = new menuBean();
mb.setMenu_name(childElement.getAttribute("name"));
alist_menuname.add(mb);
}
NodeList cEchildren = childElement.getChildNodes();
for (int j = 0; j < cEchildren.getLength(); j++) {
Node menuitem = cEchildren.item(j);
if (menuitem instanceof Element) {
Element menu = (Element) menuitem;
if (menu.getTagName().equals("items")) {
menuBean mb2 = new menuBean();
mb2.setMenu_name(childElement.getAttribute("name"));
mb2.setMenuitem_url(menu.getAttribute("url"));
mb2.setMenuitem_tip(menu.getAttribute("tip"));
mb2.setMenuitem_text(
((Text) menu.getFirstChild()).getData().trim());
alist_items.add(mb2);
}
}
}
}
}
request.setAttribute("menus", alist_menuname);
request.setAttribute("menuitems", alist_items);
request.setAttribute("xmlfile", xmlfile);
// 伺服器端轉向
request.getRequestDispatcher("menu.jsp").forward(request, response);
doGet(request, response);
}
public void destroy() {
}
}
這裡有兩處是原範例的瑕疵,實作時值得修正:一是 getTagName() == "items" 用 == 比較字串,應改為 equals(),否則在多数 JVM 上會永遠為 false;二是檔案路徑直接接受使用者輸入並交給 new File(),等於把任意檔案讀取的風險開在後門,正式環境應加上白名單或改用伺服器端的相對路徑基準。另外 request.getRequestDispatcher("menu.JSP") 的大小寫在大小寫敏感的文件系統上也可能找不到資源,實務上建議統一為小寫檔名。
儲存時的方向與讀取相反:從 request 取出所有 menuname、menuitem_name 等參數陣列,用 DOM API 重新建構文件樹,再透過 Transformer 輸出到檔案。這裡刻意加上 xml-stylesheet 處理指示,讓產生的 XML 被瀏覽器開啟時能直接套用 menus.xsl 呈現。
清單 3. newXMLservlet.java
package XTO;
import xmlbean.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;
import javax.xml.parsers.*;
import org.w3c.dom.*;
import org.xml.sax.*;
import javax.xml.transform.*;
import javax.xml.transform.dom.*;
import javax.xml.transform.stream.*;
public class newXMLservlet extends HttpServlet {
private static final String CONTENT_TYPE = "text/html; charset=GBK";
private DocumentBuilder db;
public newXMLservlet() {
try {
jbInit();
} catch (Exception ex) {
ex.printStackTrace();
}
}
public void init() throws ServletException {
}
// 把 XML 文件樹輸出到檔案
private void saveDocument(Document doc, File f)
throws TransformerFactoryConfigurationError,
TransformerConfigurationException,
FileNotFoundException,
TransformerException {
Transformer t = TransformerFactory.newInstance().newTransformer();
Properties props = new Properties();
props.put(OutputKeys.INDENT, "yes"); // 格式化輸出
props.put(OutputKeys.ENCODING, "GB2312"); // 設定 XML 編碼
t.setOutputProperties(props);
t.transform(new DOMSource(doc), new StreamResult(new FileOutputStream(f)));
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType(CONTENT_TYPE);
request.setCharacterEncoding("GBK");
// 取得目標 XML 檔
String xmlfile = request.getParameter("xmlfile").toString();
File f = new File(xmlfile);
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
try {
db = dbf.newDocumentBuilder();
} catch (ParserConfigurationException ex) {
System.out.print(ex.toString());
}
Document doc = db.newDocument();
// 掛上樣式表參照,讓瀏覽器開啟時套用 menus.xsl
Node sheet = doc.createProcessingInstruction("xml-stylesheet",
"type=\"text/xsl\" href=\"menus.xsl\"");
doc.appendChild(sheet);
Element menusroot = doc.createElement("menus");
// 依表單送回的 menuname 逐一建立 menu 元素
for (int i = 0; i < request.getParameterValues("menuname").length; i++) {
Element menu = doc.createElement("menu");
menu.setAttribute("name", request.getParameterValues("menuname")[i]);
// 依 menuitem_name 的個數建立子選單 items 元素
for (int j = 0; j < request.getParameterValues("menuitem_name").length; j++) {
if (request.getParameterValues("parent")[j].equals(
request.getParameterValues("menuname")[i])) {
Element menuitem = doc.createElement("items");
menuitem.setAttribute("url",
request.getParameterValues("menuitem_url")[j]);
menuitem.setAttribute("tip",
request.getParameterValues("menuitem_title")[j]);
Text itemname = doc.createTextNode(
request.getParameterValues("menuitem_name")[j]);
menuitem.appendChild(itemname);
menu.appendChild(menuitem);
}
}
menusroot.appendChild(menu);
}
doc.appendChild(menusroot);
try {
saveDocument(doc, f);
} catch (Exception ex1) {
System.out.print(ex1.toString());
}
// 儲存後回到 XMLservlet,重新讀取並刷新畫面
request.setAttribute("xmlfilename", xmlfile);
request.getRequestDispatcher("XMLservlet").forward(request, response);
doGet(request, response);
}
public void destroy() {
}
private void jbInit() throws Exception {
}
}
這段程式把「攤平的表單」還原成「兩層的樹」:外層迴圈走 menu,內層迴圈逐一比對 parent 是否等於目前的 menu 名稱,符合的就掛到該 menu 底下。這種做法的時間複雜度是 O(m×n),選單規模小時無妨;若項目數量可觀,改用 HashMap<String, List> 先分組會快得多。
如清單 4,四個私有欄位加上成對的 getter/setter,沒有其他邏輯。
清單 4. menuBean.java
package xmlbean;
public class menuBean {
public menuBean() {
}
private String menu_name;
private String menuitem_url;
private String menuitem_tip;
private String menuitem_text;
public String getMenuitem_url() {
return menuitem_url;
}
public String getMenuitem_tip() {
return menuitem_tip;
}
public String getMenuitem_text() {
return menuitem_text;
}
public String getMenu_name() {
return menu_name;
}
public void setMenuitem_url(String menuitem_url) {
this.menuitem_url = menuitem_url;
}
public void setMenuitem_tip(String menuitem_tip) {
this.menuitem_tip = menuitem_tip;
}
public void setMenuitem_text(String menuitem_text) {
this.menuitem_text = menuitem_text;
}
public void setMenu_name(String menu_name) {
this.menu_name = menu_name;
}
}
檔案開頭的 xml-stylesheet 處理指示讓直接開啟這份 XML 時,瀏覽器會套用 menus.xsl 把它渲染成網頁。
清單 5. menu.xml
<?xml version="1.0" encoding="GB2312"?>
<?xml-stylesheet type="text/xsl" href="menus.xsl"?>
<menus>
<menu name="資訊入口網站">
<items tip="" url="#">搜狐</items>
<items tip="" url="#">雅虎</items>
<items tip="" url="#">中國人</items>
<items tip="" url="#">貓撲</items>
<items tip="" url="#">MSN</items>
<items tip="中國最大資訊入口之一" url="https://sina.com.cn">新浪</items>
</menu>
<menu name="播客入口網站">
<items tip="" url="#">土豆</items>
<items tip="" url="#">我樂</items>
<items tip="" url="#">偶偶</items>
<items tip="" url="#">新浪視頻</items>
<items tip="" url="#">貓撲視頻</items>
<items tip="" url="#">Youtube</items>
</menu>
<menu name="IT 入口網站">
<items tip="" url="#">中關村</items>
<items tip="" url="#">PChome</items>
<items tip="" url="#">InTo 中關村</items>
<items tip="" url="#">PConline</items>
<items tip="數碼家電引領者" url="#">數碼</items>
</menu>
<menu name="娛樂網站">
<items tip="這是一個不錯的娛樂網站" url="#">娛樂網站1</items>
</menu>
</menus>
樣式表用 xsl:for-each 兩層迴圈把 menu 與 items 展開,為每個 menu 產生一塊「標題 + 內容」的結構,並在 <head> 中注入一段 JavaScript。點擊標題時呼叫 MenuWork(this),它會先把其他選單收合(display: none),再切換目前這個的顯示狀態,達到「同一時間只展開一組」的手風琴效果。menulist() 則靠 parentNode.childNodes[1] 從標題元素找到對應的內容容器。
清單 6. menus.xsl
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:fo="https://www.w3.org/1999/XSL/Format">
<xsl:output method="html"/>
<xsl:template match="/menus">
<html>
<head>
<title></title>
<link href="menu.css" rel="stylesheet" type="text/css" />
<script language="javascript">
var menus = new Array();
var menulist;
var menunameParentNode;
var n;
var f;
function MenuWork(menuname) {
menus.push(menuname);
for (var i = 0; i < menus.length; i++) {
if (menus[i] != menuname) {
menulist(menus[i]).style.display = "none";
}
}
var display = menulist(menuname).style.display;
menulist(menuname).style.display = (display == "block") ? "none" : "block";
if (menulist(menuname).style.display == "block") {
n = menulist(menuname);
n.style.overflow = "hidden";
}
}
function menulist(menuname) {
menunameParentNode = menuname.parentNode;
x = menunameParentNode.childNodes[1];
return x;
}
</script>
</head>
<body>
<div id="menubody">
<xsl:for-each select="menu">
<div class="menus">
<div class="menuname" onmousedown="MenuWork(this)">
<xsl:value-of select="@name"/>
</div>
<div class="menuitems">
<ul class="items">
<xsl:for-each select="items">
<li>
<xsl:element name="a">
<xsl:attribute name="href"><xsl:value-of select="@url"/></xsl:attribute>
<xsl:attribute name="title"><xsl:value-of select="@tip"/></xsl:attribute>
<xsl:value-of select="."/>
</xsl:element>
</li>
</xsl:for-each>
</ul>
</div>
</div>
</xsl:for-each>
</div>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
原範例在這裡有個 bug:所有重複使用的 id(menus、menuname、menuitems、items)在迴圈中會產生多份相同的 id,而 HTML 要求 id 在文件中唯一。上面已把它們改為 class;若要繼續用 id 選擇器,可在每輪附加索引(例如 id="menuname{position()}")來保持唯一性。另外 childNodes[1] 這種位置索引同樣對標籤順序敏感,改用 nextSibling 搭配型別判斷,或乾脆用 getElementsByTagName,都會更穩健。
這個範例的價值在於把「XML 當資料庫」這條路走完了:XML 檔是唯一真實來源,Servlet 負責讀寫,JSP/JSTL 負責編輯介面,XSLT 負責唯讀呈現。它對小型、結構固定、變動不頻繁的設定資料相當合適——不必啟動資料庫,用任何文字編輯器都能改。
但也正因如此,它不適合承載大量或高併發的資料:每次儲存都要重寫整份檔案,缺乏交易與鎖定機制,多人不小心就會互相覆蓋。若要走向正式環境,通常有兩個方向:把儲存層換成資料庫並保留 XML 作為匯出格式,或是導入 JAXB/XMLBeans 這類資料綁定框架,用產生的 POJO 取代手寫的 DOM 遍歷,讓型別安全與程式碼可讀性都更好一層。
原始範例以 JBuilder 2005 搭配 Windows 文字編輯器開發。