Android实战技巧之五十三：dom4j&xstream

Dom4J和XStream是Java平台上使用较广的XML开源包。
Dom4J的特点就是简单易用，而我选择XStream的原因就是XML转换Java类。

在Android平台上解析XML的手段有三种，DOM、SAX、PULL。但不论哪一种，解析一个XML都要写大篇的代码，
如果稍有改动，连杀人大心都有。

在移动平台上，内存和网络带宽是瓶颈。有些程序是为了追求性能的极致而不则手段，而有些程序繁重的编码是横在程序员面前大阻碍，在我们经历的项目中，使用简单易用的工具去简化繁重的XML和Json解析是当务之急。所以，上述两个工具用在Android平台是个不错的选择。另一个优势，我们大服务器端也是Java开发，前后两端使用相同的工具，对项目还是相当有益的。

版本要求

Dom4J和XStream都是开源项目，在github上均可找到源码，那么根据我们的要求，可以下载相应的版本编译。
XStream比较特殊，高版本为Java8编译，目前Android Studio尚不支持，我这里直接降版本使用，xstream-1.4.7可以平顺运行。

最简单需求

1、将下述xml内容存到一个map中

<access>
<access_token>243656dfjjfxcbbaccess_token>
<expires_in>360expires_in>
access>

常见场景为解析这种一层的简单的xml，直接用最简单的版本解析出来，而不是像以前我的做法，对应写解析代码。
此时用Dom4J来对应，解析例子如下：

    public Map<String, String> parseXml(String file) throws Exception {
        Map<String, String> map = new HashMap<String, String>();

        SAXReader reader = new SAXReader();
        InputStream input = new FileInputStream(file);
        Document document = reader.read(input);
        Element root = document.getRootElement();

        List<Element> elementList = root.elements();

        for (Element e : elementList){
            Log.d(TAG, "name: " + e.getName() + " text: " + e.getText());
            map.put(e.getName(), e.getText());
        }

        return map;
    }

2、将上述xml转成Java类
这个肯定要用XStream啦，例子如下：

    private XStream mXStream = null;

    public XStreamProcessor() {
        mXStream = new XStream(new DomDriver());
    }


    public void parseXml(String file) throws Exception {
        InputStream input = new FileInputStream(file);
        mXStream.alias("access", Access.class);
        Access access = (Access)mXStream.fromXML(input);
        Log.d(TAG, access.toString());
    }

个人感觉，这两个库用起来实在是太容易了。在应对复杂xml也许会有些不足，但是就目前我的应用场景来说，简单使用压倒一切。

其余代码

我建了两个类，上面的XStreamProcessor功能就是那么单一，xml文件生成的任务放在了Dom4jProcessor中。

public String buildXML(){
        Log.d(TAG,"buildXML");
        StringWriter xmlWriter = new StringWriter();
        Access access = new Access("243656dfjjfxcbb", "360");

        try {
            Document doc = DocumentHelper.createDocument();
            doc.setXMLEncoding("utf-8");

            Element element = doc.addElement("access");
            element.addAttribute("author", "linc");
            element.addAttribute("date", "2016-06-11");
            element.addComment("dom4j tester");

            Element elementToken = element.addElement("access_token");
            elementToken.addText(access.getAccess_token());

            Element elementExpire = element.addElement("expires_in");
            elementExpire.addText(access.getExpires_in());

            OutputFormat outputFormat = new OutputFormat();
            outputFormat.setEncoding("utf-8");
            outputFormat.setIndent(false);
            outputFormat.setNewlines(true);
            outputFormat.setTrimText(true);

            XMLWriter output = new XMLWriter(xmlWriter, outputFormat);
            output.write(doc);
            output.close();
        } catch (Exception e) {
            Log.e(TAG,"build failed: "+e.getMessage());
        }
        Log.d(TAG,xmlWriter.toString());
        try {
            saveToSDCard("access",xmlWriter.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
        return xmlWriter.toString();
    }

    private void saveToSDCard(String filename, String filecontent)throws Exception{
        File file = new File(Environment.getExternalStorageDirectory(),filename);
        FileOutputStream outStream = new FileOutputStream(file);
        outStream.write(filecontent.getBytes());
        outStream.close();
    }

后记

在程序性能与编码复杂度上，我们会根据实际情况做一个权衡，并不是运行性能压倒一切。

参考：
1、《XStream 读取文件内容转换成JAVA对象》：http://www.ibm.com/developerworks/cn/xml/x-xstream/
2、http://blog.csdn.net/sunboy_2050/article/details/7521605
3、《android 中XML和对象转换利器Xstream的使用》：http://blog.csdn.net/shimiso/article/details/7743639