DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 Java 操作 XML 動態產生多層級選單
編輯:XML詳解     

這個範例示範如何把 XML 當成選單資料的儲存格式,做出一個可以在瀏覽器上增刪改、再存回 XML 檔案的後台管理介面。技術組合相當經典:JSP 負責頁面與 JavaScript 互動,JSTL 負責把伺服器端的資料集合渲染成表單,Servlet 負責用 DOM 解析與產生 XML,JavaBean 則充當資料載體,最後一層 menus.xsl 把同一份 XML 轉呈為真正可點擊的選單。

組件與職責分工

  • Menu.jsp:管理介面。用 JSTL 的 forEach 把現有選單結構展開成可編輯表單,並用 JavaScript 在瀏覽器端動態新增或移除節點。
  • XMLservlet:讀取指定的 XML 檔,解析成兩組 bean 集合(menu 名稱、menu 項目),塞進 request 後轉發回 Menu.jsp。
  • newXMLservlet:接收表單回傳,重新組出一棵 DOM 樹並寫回原檔案,然後再轉回 XMLservlet 重新載入。
  • menuBean:承載 menu_name、menuitem_url、menuitem_tip、menuitem_text 四個欄位。
  • menu.xml / menus.xsl:資料檔與呈現用的樣式表。

Menu.jsp

頁面先把 .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 結構的排列順序是綁在一起的,若日後調整標籤順序,這段程式就得跟著改。

XMLservlet:讀取並攤平成 bean 集合

這個 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") 的大小寫在大小寫敏感的文件系統上也可能找不到資源,實務上建議統一為小寫檔名。

newXMLservlet:把表單寫回 XML

儲存時的方向與讀取相反:從 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> 先分組會快得多。

menuBean:最單純的資料載體

如清單 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;
    }
}

menu.xml:資料檔

檔案開頭的 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>

menus.xsl:轉成互動選單

樣式表用 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 文字編輯器開發。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved