简单强大的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文档如下:

<province name="湖南">
    <cities>
        <city name="长沙" code="1001" />
        <city>
            <name>益阳name>
            <code>1002code>
            <regions>
                <region>
                    <name>资阳区name>
                region>
                <region>
                    <name>赫山区name>
                region>
            regions>
        city>
    cities>
    <map>
        <key name="aa">bbkey>
        <key name="cc">ddkey>
    map>
    <code>1000code>
    <introduce>
        <title>古城title>
        <desc>古都desc>
    introduce>
province>

将改文档生成业务对象province的代码
java
Province province = new Xml().fromXml(new TypeToken() {}.getType(), xml);


对象生成文档

将上面反序列序对象序列化就是我们需要的文档，同样一句代码

String pXml = new Xml().toXml(province);

文档转换成集合

需要解析的文档如下:

<list>
    <book>
        <name>javaname>
        <author>gomsauthor>
    book>
    <book>
        <name>androidname>
        <author>googleauthor>
    book>
list>

将该文档生成集合对象ArrayList 的代码
java
ArrayList books = new Xml().fromXml(new TypeToken>() {}.getType(), booksXml);


集合生成文档

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


文档转换成哈希表

需要解析的文档如下:

<map>
    <key name="aa">bbkey>
    <key name="cc">ddkey>
map>

将该文档生成哈希表对象 HashMap 的代码

HashMap map = new Xml().fromXml(new TypeToken>() {}.getType(),mapXml);

哈希表生成文档

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


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

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

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

下一版本的目标

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

源码下载

• 下载
• github查看

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