简单强大的xml解析器

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的代码
java
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> 的代码
java
ArrayList<Book> books = new Xml().fromXml(new TypeToken<ArrayList<Book>>() {}.getType(), booksXml);


集合生成文档

将上面反序列序对象序列化就是我们需要的文档，同样一句代码
java
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);

哈希表生成文档

将上面反序列序对象序列化就是我们需要的文档，同样一句代码
java
String mXml = new Xml().toXml(map, new TypeToken<HashMap<String, String>>(){}.getType());


鸡鸡们看起来是不是有种很强悍的感觉,跟gson解析 new Gson().fromJson() 是不是很像的,有这种感觉绝没错的,这样 只要会用gson就会用xml解析器,学习成本大大减低,也就是我的初衷。哈哈哈哈……

目前该版本暂未实现的功能

• 哈希表对象存储
• 集合多级处理(这种场景很少)
• 解析器配置接口(主要提供更加灵活的业务处理能力)

下一版本的目标

• 完善功能
• 修复发现的bug
• 代码重构
• 代码性能优化

源码下载

• 下载
• github查看

记得扫描下面的二维码,加我微信,一起交流学习哦!