XML簡介

什麼是xml?

• XML 指可擴充套件標記語言（EXtensible Markup Language）
• XML 是一種標記語言，很類似 HTML
• XML 的設計宗旨是傳輸資料，而非顯示資料
• XML 標籤沒有被預定義。您需要自行定義標籤。
• XML 被設計為具有自我描述性。
• XML 是 W3C 的推薦標準

xml檔案例項

下面是自定義的xml檔案

<?xml version="1.0" encoding="UTF-8" ?>
<Users>
    <User name="Johnson" password="admin" phoneNum
 
="10036363636" email="[email protected]"/>
    <User name="leo" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="John" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="Mary" password="admin" phoneNum="10036363636"
 
 email="[email protected]"/>
    <User name="Paul" password="admin" phoneNum="10036363636" email="[email protected]"/>
</Users>

• 其中的Users, User元素標籤是自定義的，在這裡表示使用者列表、使用者物件
• User元素中的name, password, phoneNum, email代表定義該物件的屬性

dom4j

dom4j簡介

dom4j是一個用來讀寫XML檔案的Java XML API。dom4j是一個十分優秀的JavaXML API，具有效能優異、功能強大和極其易使用的特點，是一個開放原始碼的軟體。

dom4j使用方式

1. 引入專案依賴，這裡以maven專案為例

    <dependencies>
        <dependency>
            <groupId>dom4j</groupId>
            <artifactId>dom4j</artifactId>
            <version>1.6.1</version>
        </dependency>
    </dependencies>

1. 準備好自定義的xml檔案，這裡以上面的xml檔案為例，將其儲存為users.xml

<?xml version="1.0" encoding="UTF-8" ?>
<Users>
    <User name="Johnson" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="leo" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="John" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="Mary" password="admin" phoneNum="10036363636" email="[email protected]"/>
    <User name="Paul" password="admin" phoneNum="10036363636" email="[email protected]"/>
</Users>

1. 編寫程式，讀取xml檔案內容

public static void main(String... strings) throws Exception {
    //檔案路徑
    String filePathName = "C:\\Users\\johnson\\Desktop\\users.xml";

    //定義dom4j的SAXReader物件
    SAXReader reader = new SAXReader();

    //通過reader獲取到的檔案內容被讀取並轉換成Document物件
    Document document = reader.read(new File(filePathName));

    //獲取文件中的根節點, Element是dom4j的元素物件，即獲取Users標籤的元素
    Element rootElement = document.getRootElement();

    //獲取根節點中的所有子元素列表,即user物件列表
    @SuppressWarnings("unchecked")
    List<Element> userElements = rootElement.elements();

    //element物件的attributeValue(String name)方法可以獲取到元素的屬性值
    userElements.forEach(userElement -> System.out.println(userElement.attributeValue("name") +
            " || " + userElement.attributeValue("password") +
            " || " + userElement.attributeValue("phoneNum") +
            " || " + userElement.attributeValue("email")));
}

1. 由於xml檔案元素是自定義的，因此需要自定義的程式來解析，程式執行解析結果如下:

Johnson || admin || 10036363636 || 123456789@qq.com
leo || admin || 10036363636 || 123456789@qq.com
John || admin || 10036363636 || 123456789@qq.com
Mary || admin || 10036363636 || 123456789@qq.com
Paul || admin || 10036363636 || 123456789@qq.com

dom4j xml檔案讀取寫入操作封裝例項

package xxx.xxx.xxx.xxx.util;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.UnsupportedEncodingException;

import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.io.OutputFormat;
import org.dom4j.io.SAXReader;
import org.dom4j.io.XMLWriter;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * 對XML檔案進行操作的工具類
 * 
 * Created by Xuyh at 2017年4月21日 下午7:41:42.
 */
public class XMLUtils {
    private static Logger logger = LoggerFactory.getLogger(XMLUtils.class);

    /**
     * 將document寫入XML檔案
     * 
     * @param filePathName 檔案路徑名
     * @param document
     * @return
     */
    public static boolean wirteXMLFile(String filePathName, Document document) {
        OutputFormat format = OutputFormat.createPrettyPrint();
        format.setEncoding("UTF-8");
        XMLWriter writer = null;
        try {
            writer = new XMLWriter(new FileOutputStream(new File(filePathName)), format);
            writer.write(document);
            writer.flush();
        } catch (UnsupportedEncodingException e1) {
            logger.warn(e1.getMessage());
            return false;
        } catch (IOException e2) {
            logger.warn(e2.getMessage());
            return false;
        } finally {
            if (writer != null) {
                try {
                    writer.close();
                } catch (IOException e) {
                    logger.warn(e.getMessage());
                    return false;
                }
            }
        }
        return true;
    }

    /**
     * 讀取XML檔案獲取document
     * 
     * @param filePathName 檔案路徑名
     * @return
     */
    public static Document readXMLFile(String filePathName) {
        SAXReader reader = new SAXReader();
        Document document = null;
        try {
            document = reader.read(new File(filePathName));
        } catch (DocumentException e) {
            logger.warn(e.getMessage());
        }
        return document;
    }

    /**
     * 讀取XML檔案獲取document
     * 
     * @param file 檔案物件
     * @return
     */
    public static Document readXMLFile(File file) {
        SAXReader reader = new SAXReader();
        Document document = null;
        try {
            document = reader.read(file);
        } catch (DocumentException e) {
            logger.warn(e.getMessage());
        }
        return document;
    }
}

需要注意的是，該工具類使用到了slf4j庫來記錄日誌

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.22</version>
</dependency>