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
代码重构
代码性能优化

源码下载

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

简单强大的xml解析器