• XStream概述
• XStream的特點
• XStream架構
  • Converters 轉換器
  • IO 輸入輸出
  • Context 上下文引用
  • Facade 統一接口
• Quick Start
  • 加入Maven依賴
  • Domain實體類
  • XML和Object互轉
• 小結
• 示例源碼

XStream概述

官網: http://x-stream.github.io/index.html

XStream開源類庫,用于將java對象序列化為XML或者將XML反序列化為Java對象，是Java對象和XML之間的一個雙向轉換器.

目前最新的版本是1.4.10 . May 23, 2017 XStream 1.4.10 released

---

XStream的特點

靈活易用:提供簡單、靈活、易用的統一接口，用戶無需了解底層細節

無需映射：大多數對象都可以在無須映射的情況下進行序列化以及反序列化的操作

高速穩定：解析速度快，占用內存少

靈活轉換：轉換策略都是可以定制的，允許自定義類型存儲為指定的XML格式

易于集成：通過實現特定的接口，可以直接和其他任何樹形結構進行序列化與反序列化操作

等等…… 具體參見官網說明

---

XStream架構

Converters 轉換器

當XStream遇到需要轉換的對象時，它會委派給合適的轉換器實現。 XStream為通用類型提供了多種轉換器實現，包括基本數據類型、String、Collections、Arrays、null、Date等。

---

I/O 輸入輸出

XStream是通過接口HierarchicalStreamWriter和HierachialStreamReader從底層XML數據中抽象而來的，分別用于序列化和反序列化操作。

---

Context 上下文引用

在XStream序列化或者反序列化對象時，它會創建兩個類MarshallingContext和UnmarshallingContext， 由他們來處理數據并委派合適的轉換器。 XStream提供了三種上下文的默認實現。

區別如下：

XStream.XPATH_REFERENCES（默認值）通過XPath引用來標識重復的引用

XStream.ID_REFERENCES :使用ID應用來標識重復的引用

XStream.NO_REFERENCES：對象作為樹形結構，重復的引用被視為兩個不同的對象，循環引用會導致異常產生。這種模式速度快，占用內存少。

可以通過XStream.setMode()方法調整。

---

Facade 統一接口

作為XStream的統一入口點，它將上面所提到的重要組件集成在一起，以統一的接口開放出來

---

Quick Start

加入Maven依賴

......<dependency><groupId>com.thoughtworks.xstream</groupId><artifactId>xstream</artifactId><version>${xstream.version}</version> </dependency>.....<xstream.version>1.4.10</xstream.version>

接下來，開始我們的XStream之旅，對象和XML之間的互換。

Domain實體類

先準備兩個Domain類

package com.xgj.oxm.xstream.quickDemo.domain;import java.io.Serializable; import java.util.Date;public class LoginLog implements Serializable {private static final long serialVersionUID = 1L;private int loginLogId;private int userId;private String ip;private Date loginDate;public int getLoginLogId() {return loginLogId;}public void setLoginLogId(int loginLogId) {this.loginLogId = loginLogId;}public int getUserId() {return userId;}public void setUserId(int userId) {this.userId = userId;}public String getIp() {return ip;}public void setIp(String ip) {this.ip = ip;}public Date getLoginDate() {return loginDate;}public void setLoginDate(Date loginDate) {this.loginDate = loginDate;}} package com.xgj.oxm.xstream.quickDemo.domain;import java.io.Serializable; import java.util.ArrayList; import java.util.Date; import java.util.List; import java.util.Map;public class User implements Serializable {private static final long serialVersionUID = 1L;private int id;private String userName;private String password;private int credits;private String lastIp;private Date lastVisit;private List<LoginLog> logs;private Map datas;public List<LoginLog> getLogs() {return logs;}public void setLogs(List logs) {this.logs = logs;}public int getId() {return id;}public void setId(int id) {this.id = id;}public String getUserName() {return userName;}public void setUserName(String userName) {this.userName = userName;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public int getCredits() {return credits;}public void setCredits(int credits) {this.credits = credits;}public String getLastIp() {return lastIp;}public void setLastIp(String lastIp) {this.lastIp = lastIp;}public Date getLastVisit() {return lastVisit;}public void setLastVisit(Date lastVisit) {this.lastVisit = lastVisit;}public void addLoginLog(LoginLog log) {if (this.logs == null) {logs = new ArrayList<LoginLog>();}logs.add(log);}public Map getDatas() {return datas;}public void setDatas(Map datas) {this.datas = datas;}}

XML和Object互轉

接下來我們來看下是XStream是如何進行轉換的

package com.xgj.oxm.xstream.quickDemo;import java.io.FileInputStream; import java.io.FileOutputStream; import java.text.ParseException; import java.util.Date;import com.thoughtworks.xstream.XStream; import com.thoughtworks.xstream.io.xml.DomDriver; import com.xgj.oxm.xstream.quickDemo.domain.LoginLog; import com.xgj.oxm.xstream.quickDemo.domain.User;public class XStreamDemo {private static XStream xstream;static {// 創建一個Xstream實例，并指定一個XML解析器xstream = new XStream(new DomDriver());}/*** * * @Title: getUser* * @Description: 初始化轉換對象* * @return* * @return: User* @throws ParseException*/public static User getUser() throws ParseException {LoginLog log = new LoginLog();log.setIp("127.0.0.1");log.setLoginLogId(99);log.setUserId(1);log.setLoginDate(new Date());User user = new User();user.setId(1);user.setUserName("Artisan");user.setPassword("artisan");user.setCredits(1000);user.setLastVisit(new Date());user.addLoginLog(log);return user;}/*** * * @Title: objectToXml* * @Description: Java對象轉換成XML* * @throws Exception* * @return: void*/public static void objectToXml() throws Exception {// 獲取轉換的User對象實例User user = getUser();// 輸出內容到控制臺,查看一下System.out.println(xstream.toXML(user));// 實例化一個文件輸出流FileOutputStream os = new FileOutputStream("D://XstreamDemo.xml");// 將User對象轉換為XML，并保存到指定的文件xstream.toXML(user, os);System.out.println("objectToXml successfully");}/*** * * @Title: XmlToObject* * @Description: Xml轉Java對象* * @throws Exception* * @return: void*/public static void XmlToObject() throws Exception {// 實例化文件輸入流FileInputStream in = new FileInputStream("D://XstreamDemo.xml");// 將xml文件輸入流轉化為對象User user = (User) xstream.fromXML(in);// 遍歷for (LoginLog log : user.getLogs()) {System.out.println("訪問時間:" + log.getLoginDate());System.out.println("訪問IP:" + log.getIp());}}public static void main(String[] args) throws Exception {objectToXml();System.out.println("=====================================");XmlToObject();} }

我們來看下生成的XML

<com.xgj.oxm.xstream.quickDemo.domain.User><id>1</id><userName>Artisan</userName><password>artisan</password><credits>1000</credits><lastVisit>2017-12-05 07:30:46.772 UTC</lastVisit><logs><com.xgj.oxm.xstream.quickDemo.domain.LoginLog><loginLogId>99</loginLogId><userId>1</userId><ip>127.0.0.1</ip><loginDate>2017-12-05 07:30:46.772 UTC</loginDate></com.xgj.oxm.xstream.quickDemo.domain.LoginLog></logs> </com.xgj.oxm.xstream.quickDemo.domain.User>

小結

我們在實例化Xstream的時候，指定了一個Dom XML解析器

xstream = new XStream(new DomDriver());

如果不指定，默認為XPP（XML Pull Parser），一種高速解析XML文件的方式，速度比傳統方式快很多 。

• object to XML 使用xstream.toXML方法

• XML back to an object 使用 xstream.fromXML方法

---

示例源碼

代碼已托管到Github—> https://github.com/yangshangwei/SpringMaster

《新程序員》：云原生和全面數字化實踐50位技術專家共同創作，文字、視頻、音頻交互閱讀

總結

以上是生活随笔為你收集整理的Spring OXM-XStream快速入门的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。