JavaScript

关注公众号 jb51net

关闭
首页 > 网络编程 > JavaScript > xml2js解析XML数据

使用xml2js库进行XML数据解析

作者:泯泷

这篇文章主要为大家介绍了使用xml2js库进行XML数据解析用法详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

引言

解析XML文件是开发中常见的需求之一。为了以一种简单易用的方式访问XML数据,你可能不想编译一个C解析器,而是想寻找一个更方便的解决方案。那么,xml2js就是你需要的工具!xml2js是一个简单的XML到JavaScript对象转换器,支持双向转换。它使用了sax-js和xmlbuilder-js这两个工具库。

安装

最简单的安装xml2js的方式是使用npm。只需执行npm install xml2js,npm将会下载xml2js及其所有依赖。

xml2js也可以通过Bower进行安装,只需执行bower install xml2js,Bower将会下载xml2js及其所有依赖。

用法

由于你是一位非常聪明的开发者,所以不需要过多的教程指导。解析XML应该是一件简单的事情,我们直接通过一些示例进行学习。

简短用法

你希望尽可能简单、轻松地解析XML吗?使用以下代码:

var parseString = require('xml2js').parseString;
var xml = "<root>Hello xml2js!</root>"
parseString(xml, function (err, result) {
    console.dir(result);
});

这真是再简单不过了,对吧?这个方法适用于xml2js的0.2.3版本及以上。使用CoffeeScript时,代码如下:

CoffeeScript 可能比较小众,但是官方文档有举例了相关内容,故本文进行保留。

{parseString} = require 'xml2js'
xml = "<root>Hello xml2js!</root>"
parseString xml, (err, result) ->
    console.dir result

如果你需要一些特殊的选项,也不用担心,xml2js支持许多选项(见下文),你可以将这些选项作为第二个参数进行指定:

parseString(xml, {trim: true}, function (err, result) {
});

实例方法

如果你之前一直使用xml-simple或者自己封装的方法来处理XML,那么从0.1.11版本开始,xml2js为你添加了以下方法:

var fs = require('fs'),
    xml2js = require('xml2js');
var parser = new xml2js.Parser();
fs.readFile(__dirname + '/foo.xml', function(err, data) {
    parser.parseString(data, function (err, result) {
        console.dir(result);
        console.log('Done');
    });
});

看吧,没有事件监听器!

你还可以使用CoffeeScript来进一步减少代码的冗余:

fs = require 'fs',
xml2js = require 'xml2js'
parser = new xml2js.Parser()
fs.readFile __dirname + '/foo.xml', (err, data) ->
  parser.parseString data, (err, result) ->
    console.dir result
    console.log 'Done.'

但是,如果你忘记使用new关键字创建一个新的Parser对象会怎么样?从0.2.8开始,你也可以不使用这个关键字。从0.2.8开始,你可以不使用它,在这种情况下,xml2js会帮助你添加它,以保证不会再出现意外和莫名其妙的bug!

Promise 用法

var xml2js = require('xml2js');
var xml = '<foo></foo>';
// 1. With parser
var parser = new xml2js.Parser(/* options */);
parser.parseStringPromise(xml).then(function (result) {
  console.dir(result);
  console.log('Done');
})
.catch(function (err) {
  // Failed
});
// 2. Without parser
xml2js.parseStringPromise(xml /*, options */).then(function (result) {
  console.dir(result);
  console.log('Done');
})
.catch(function (err) {
  // Failed
});

使用 XML 构建器

自 0.4.0 版本起,xml2js 还支持使用对象来构建 XML。下面是一个示例:

const xml2js = require('xml2js');
const obj = {name: "Super", Surname: "Man", age: 23};
const builder = new xml2js.Builder();
const xml = builder.buildObject(obj);

上述代码将生成如下的 XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<root>
  <name>Super</name>
  <Surname>Man</Surname>
  <age>23</age>
</root>

通过设置 cdata 选项为 true,可以支持写入 CDATA。

指定属性

使用 xml2js,你可以指定 XML 元素的属性。下面是一个示例:

const xml2js = require('xml2js');
const obj = {root: {$: {id: "my id"}, _: "my inner text"}};
const builder = new xml2js.Builder();
const xml = builder.buildObject(obj);

上述代码将生成如下的 XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<root id="my id">my inner text</root>

添加 xmlns 属性

xml2js 还支持在生成的 XML 中添加 XML 命名空间前缀和 URI 对,通过使用 xmlns 属性。

在根元素上声明默认命名空间的示例:

const obj = { 
  Foo: {
    $: {
      "xmlns": "http://foo.com"
    }   
  }
};

通过调用 buildObject(obj) 方法,将生成以下 XML:

<Foo xmlns="http://foo.com"/>

在非根元素上声明非默认命名空间的示例:

const obj = {
  'foo:Foo': {
    $: {
      'xmlns:foo': 'http://foo.com'
    },
    'bar:Bar': {
      $: {
        'xmlns:bar': 'http://bar.com'
      }
    }
  }
};

通过调用 buildObject(obj) 方法,将生成以下 XML:

<foo:Foo xmlns:foo="http://foo.com">
  <bar:Bar xmlns:bar="http://bar.com"/>
</foo:Foo>

处理属性、标签名和值

自 0.4.1 版本起,你可以选择提供解析器的属性名和标签名处理器,以及元素值处理器(自 0.4.14 版本起,还可以提供属性值处理器)。

下面是一个示例,演示如何将属性名和标签名转换为大写:

function nameToUpperCase(name) {
  return name.toUpperCase();
}
// 将所有属性和标签名及其值转换为大写
parseString(xml, {
  tagNameProcessors: [nameToUpperCase],
  attrNameProcessors: [nameToUpperCase],
  valueProcessors: [nameToUpperCase],
  attrValueProcessors: [nameToUpperCase]
}, function (err, result) {
  // 处理后的数据
});

tagNameProcessors 和 attrNameProcessors 选项接受一个函数数组,函数的签名如下:

function (name) {
  // 对 `name` 做一些处理
  return name;
}

attrValueProcessors 和 valueProcessors 选项接受一个函数数组,函数的签名如下:

function (value, name) {
  // `name` 将是节点名或属性名
  // 对 `value` 做一些处理,可以根据节点或属性名自定义处理方式
  return value;
}

xml2js 提供了一些内置的处理器,可以在 lib/processors.js 文件中找到:

xml2js 提供了强大的功能,使得在 Node.js 应用程序中解析和构建 XML 变得简单而灵活。无论你是需要解析复杂的 XML 文档,还是需要构建自定义的 XML 输出,xml2js 都是一个值得尝试的工具。

参考文档:

Leonidas-from-XIV/node-xml2

js: XML to JavaScript object converter.

以上就是使用xml2js库进行XML数据解析的详细内容,更多关于xml2js解析XML数据的资料请关注脚本之家其它相关文章!

您可能感兴趣的文章:
阅读全文