json报文怎么转成xml报文

从JSON到XML：报文转换的实用指南**

在当今信息爆炸的时代,不同系统、不同平台之间的数据交换与集成已成为常态，JSON（JavaScript Object Notation）和XML（eXtensible Markup Language）作为两种主流的数据交换格式，各自拥有广泛的应用场景，JSON以其轻量级、易读易写的特性在Web开发中占据主导地位，而XML则凭借其严格的语法和强大的扩展能力在企业级应用、文档处理等领域仍有不可替代的作用，JSON报文与XML报文之间的转换方法，对于开发者来说是一项重要的技能，本文将详细介绍如何将JSON报文转换为XML报文。

理解JSON与XML的基本结构

在进行转换之前,首先需要回顾一下JSON和XML的基本结构，以便更好地理解转换的映射关系。

• JSON (JavaScript Object Notation):

  • 数据以键值对（key-value pair）的形式存在。
  • 数据由大括号 包裹，表示一个对象（Object）。
  • 数组（Array）由方括号 [] 包裹，元素可以是值、对象或数组。
  • 值可以是字符串（用双引号 ）、数字、布尔值（true/false）、null、对象或数组。
  • 示例：

    {
      "name": "张三",
      "age": 30,
      "isStudent": false,
      "address": {
        "city": "北京",
        "district": "朝阳区"
      },
      "hobbies": ["阅读", "游泳", "编程"]
    }

• XML (eXtensible Markup Language):

  • 数据以标签（Tags）的形式组织，形成树状结构。
  • 标签成对出现,有开始标签（如 <name>）和结束标签（如 </name>）。
  • 标签可以包含属性（如 <person id="1">）和文本内容。
  • 有且仅有一个根元素（Root Element），所有其他元素都嵌套在根元素之下。
  • 示例（对应上面的JSON）：

    <root>
      <name>张三</name>
      <age>30</age>
      <isStudent>false</isStudent>
      <address>
        <city>北京</city>
        <district>朝阳区</district>
      </address>
      <hobbies>
        <hobby>阅读</hobby>
        <hobby>游泳</hobby>
        <hobby>编程</hobby>
      </hobbies>
    </root>

JSON转XML的核心映射规则

将JSON转换为XML,本质上就是将JSON的树状结构映射到XML的树状结构，以下是一些核心的映射规则：

1. JSON对象 -> XML元素：

   • JSON的最外层对象通常映射为XML的根元素（<root>）。
   • 对象的每个键（key）映射为一个XML元素标签（tag），标签名通常直接使用键名（需注意XML标签命名规范，如不能以数字开头，不能包含空格等，必要时需进行转义或替换）。
   • 对象的值（value）映射为XML元素的内容（text content）。

2. JSON数组 -> XML元素序列：

   • JSON数组映射为一个父XML元素,数组中的每个元素映射为一个或多个子XML元素。
   • 数组的名称会作为父元素的标签名,数组中的每个对象或值会作为子元素，JSON中的 "hobbies": ["阅读", "游泳"] 可以转换为 <hobbies><hobby>阅读</hobby><hobby>游泳</hobby></hobbies>，如果数组元素是对象，则对象的每个键值对会成为子元素的子元素或属性。

3. JSON值类型 -> XML内容类型：

   • 字符串（String）：直接作为XML元素的文本内容。
   • 数字（Number）：直接作为XML元素的文本内容（通常不区分整数和浮点数，XML会自动处理）。
   • 布尔值（Boolean）：转换为字符串 "true" 或 "false" 作为XML元素的文本内容。
   • null：可以转换为空元素（如 <element/>）或特定标记（如 <element>null</element>），具体取决于需求。

4. XML命名空间与属性：

   • 简单的JSON转XML通常不涉及XML命名空间（Namespace）。
   • 如果需要,可以将JSON对象的某些键值对映射为XML元素的属性（attribute）而不是子元素，这通常需要根据预先定义的规则或需求来判断。{"id": "1", "name": "张三"} 可以转换为 <person id="1">张三</person> 或 <person><id>1</id><name>张三</name></person>。

JSON转XML的实现方法

实现JSON到XML的转换有多种途径,可以根据项目需求、技术栈和个人偏好选择。

使用编程语言库（推荐）

大多数现代编程语言都提供了成熟的库来处理JSON和XML,使得转换变得非常简单。

JavaScript/Node.js

• 场景：前端浏览器环境或Node.js后端环境。

• 常用库：

  • xmlbuilder-js: 可以直接通过JavaScript对象构建XML。
  • json2xml: 专门用于JSON转XML的库。

• 示例 (使用 xmlbuilder-js):

  const builder = require('xmlbuilder');
  const jsonData = {
    name: "张三",
    age: 30,
    isStudent: false,
    address: {
      city: "北京",
      district: "朝阳区"
    },
    hobbies: ["阅读", "游泳", "编程"]
  };
  const xml = builder.create('root', { version: '1.0', encoding: 'UTF-8' })
    .ele('name').txt(jsonData.name).up()
    .ele('age').txt(jsonData.age.toString()).up() // 数字转字符串
    .ele('isStudent').txt(jsonData.isStudent.toString()).up()
    .ele('address')
      .ele('city').txt(jsonData.address.city).up()
      .ele('district').txt(jsonData.address.district).up()
    .up()
    .ele('hobbies')
      .ele('hobby').txt("阅读").up()
      .ele('hobby').txt("游泳").up()
      .ele('hobby').txt("编程").up()
    .end({ pretty: true });
  console.log(xml);

  输出结果与前面的XML示例类似，对于数组，xmlbuilder 需要手动循环添加元素。json2xml 等库可能能自动处理数组的嵌套。

Python

• 场景：后端开发、数据处理脚本。

• 常用库：

  • xml.etree.ElementTree: Python标准库，适合构建和操作XML。
  • dicttoxml: 专门用于Python字典（JSON本质是字典）转XML的库。

• 示例 (使用 dicttoxml):

  from dicttoxml import dicttoxml
  from xml.dom.minidom import parseString
  json_data = {
    "name": "张三",
    "age": 30,
    "isStudent": False,
    "address": {
      "city": "北京",
      "district": "朝阳区"
    },
    "hobbies": ["阅读", "游泳", "编程"]
  }
  # custom_root 指定根元素名，item_func 可以自定义数组元素标签名
  xml_data = dicttoxml(json_data, custom_root='root', item_func=lambda x: 'hobby')
  # 美化输出
  dom = parseString(xml_data)
  pretty_xml = dom.toprettyxml(indent="  ")
  print(pretty_xml)

  注意：dicttoxml 默认会将数组元素包装在 <item> 标签中，通过 item_func 可以自定义。

Java

• 场景：企业级应用、Android开发。

• 常用库：

  • Jackson: 除了处理JSON，也提供了XML处理能力。
  • Gson: 主要处理JSON，配合其他XML库使用。
  • javax.xml.bind (JAXB): Java标准库，但主要用于Java对象与XML的绑定。

• 示例 (使用 Jackson):

  import com.fasterxml.jackson.databind.ObjectMapper;
  import com.fasterxml.jackson.dataformat.xml.XmlMapper;
  public class JsonToXmlConverter {
      public static void main(String[] args) throws Exception {
          String json = "{\"name\":\"张三\",\"age\":30,\"isStudent\":false,\"address\":{\"city\":\"北京\",\"district\":\"朝阳区\"},\"hobbies\":[\"阅读\",\"游泳\",\"编程\"]