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

XStream概述

官網(wǎng): 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的特點

靈活易用:提供簡單、靈活、易用的統(tǒng)一接口，用戶無需了解底層細節(jié)

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

高速穩(wěn)定：解析速度快，占用內存少

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

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

等等…… 具體參見官網(wǎng)說明

---

XStream架構

Converters 轉換器

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

---

I/O 輸入輸出

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

---

Context 上下文引用

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

區(qū)別如下：

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

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

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

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

---

Facade 統(tǒng)一接口

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

---

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 {// 創(chuàng)建一個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文件的方式，速度比傳統(tǒng)方式快很多 。

• object to XML 使用xstream.toXML方法

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

---

示例源碼

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

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

總結

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

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