LiteXml
a lite and power serializable&deserializable xml parser
产生背景
目前端与端之间通信的主流数据流有:json,xml,protobuffer,byte流,现在最流行的是json,因为结构简单,市面上有很多快速,高效,稳定的解析器,比如gson,fastjson等等,json也是可以跨平台的,也就是与端无关,主要按照json协议进行传输就可以了,这也是目前很多平台使用json作为payload的原因。主流但是不是唯一选择,所以目前还有很多端之间通信,数据源的配置,模版配置等使用xml,原因是更结构化,但是相对json来说较复杂点,但是所能够表示的信息更丰富,然而对于xml的解析来说,却是一个很多人头疼的问题,没有像json那样方便的解析器,手动解析又特别繁琐,同时代码量也很大,并且容易出问题。所以我经过一些天的思考之后,能不能实现一个通用,快速,高效,简单易用的xml解析器了,于是就有了今天的轻量级xml解析器,通过这个解析器,可以很快的,简单的实现对象与文档之间的转换,简单到只要一句代码,下面我就详细的来介绍这个解析器的内幕,咋眼一看,就有种熟悉的感觉,不就是gson版本的xml解析器,没错,就是这样的。鸡鸡们我们一起来探索神奇的解析器吧!
初衷
- 简单
- 高效
- 稳定
功能
- 对象生成文档
- 文档抓换成对象
- 集合生成文档
- 文档转换成集合
- 哈希表生成文档
- 文档转换成哈希表
xml解析器使用到的核心技术
- 泛型类型编译时获取具体类型
- 反射
基本图示
具体细节分析
文档转换成对象
需要解析的xml文档如下:
<?xml version="1.0" encoding="UTF-8"?>
<province name="湖南">
<cities>
<city name="长沙" code="1001" />
<city>
<name>益阳</name>
<code>1002</code>
<regions>
<region>
<name>资阳区</name>
</region>
<region>
<name>赫山区</name>
</region>
</regions>
</city>
</cities>
<map>
<key name="aa">bb</key>
<key name="cc">dd</key>
</map>
<code>1000</code>
<introduce>
<title>古城</title>
<desc>古都</desc>
</introduce>
</province>
将改文档生成业务对象province的代码
Province province = new Xml().fromXml(new TypeToken<Province>() {}.getType(), xml);
对象生成文档
将上面反序列序对象序列化就是我们需要的文档，同样一句代码
String pXml = new Xml().toXml(province);
文档转换成集合
需要解析的文档如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!-- list,set-->
<list>
<book>
<name>java</name>
<author>goms</author>
</book>
<book>
<name>android</name>
<author>google</author>
</book>
</list>
将该文档生成集合对象ArrayList<Book> 的代码
ArrayList<Book> books = new Xml().fromXml(new TypeToken<ArrayList<Book>>() {}.getType(), booksXml);
集合生成文档
将上面反序列序对象序列化就是我们需要的文档，同样一句代码
String listXml = new Xml().toXml(books, new TypeToken<ArrayList<Book>>(){}.getType());
文档转换成哈希表
需要解析的文档如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!-- map -->
<map>
<key name="aa">bb</key>
<key name="cc">dd</key>
</map>
将该文档生成哈希表对象 HashMap<String,String> 的代码
HashMap<String, String> map = new Xml().fromXml(new TypeToken<HashMap<String, String>>() {}.getType(),mapXml);
哈希表生成文档
将上面反序列序对象序列化就是我们需要的文档，同样一句代码
String mXml = new Xml().toXml(map, new TypeToken<HashMap<String, String>>(){}.getType());
鸡鸡们看起来是不是有种很强悍的感觉,跟gson解析 new Gson().fromJson() 是不是很像的,有这种感觉绝没错的,这样 只要会用gson就会用xml解析器,学习成本大大减低,也就是我的初衷。哈哈哈哈......
目前该版本暂未实现的功能
- 哈希表对象存储
- 集合多级处理(这种场景很少)
- 解析器配置接口(主要提供更加灵活的业务处理能力)
下一版本的目标
- 完善功能
- 修复发现的bug
- 代码重构
- 代码性能优化
源码下载
记得扫描下面的二维码,加我微信,一起交流学习哦!
