XML 里没有数组这个概念,列表是靠同名重复节点写的;转成 JSON 时这一串重复节点常常被落成单个对象,看着就像丢了数据。本站「XML转换」用的是自写的字符级解析,按结构直转、不猜语义,所以看到重复节点先数清条数再对答案。这一步在浏览器里完成,文件不离开本机、不用登录,也不占处理次数。
一、数组不会凭空出现:先理解 XML 怎么表达列表
一段列表在 XML 里长这样:同一个标签在一层里挨着出现好几次,比如三行 <item>。JSON 那边则是同名键对应一个数组,里面三个元素。这两者并不是一一直觉映射——同名节点只出现一次时,它到底是「一条数据」还是「一个只有一项的数组」,光看文件分不出来。这就是数组识别不出来的根子。
能按结构搬运标签,不能替你判断哪片该并成数组。
二、字符级解析:这一页只按结构直转
它不是语义转换。字符级解析是顺着标签的开闭一层层往下走,节点套节点就照原样翻成对象套对象;混合内容不插换行,为的就是不把语义打乱。所以同名节点是几个就出几个,不合并、不省略、也不补默认值。
| 动作 | 做什么 | 产物形态 |
|---|---|---|
| 格式化 | 按默认缩进(2)把标签排整齐 | 缩进规整的 XML |
| 压缩 | 去掉多余空白压成一坨 | 单行 XML |
| 校验 | 查标签是否成对、能否解析 | 结构与解析问题的提示 |
| 转 JSON | 按结构直转 | 对象与数组混排的 JSON |
| 提取 CDATA | 把 CDATA(一段按原样保存、不当标记解析的字符数据)里的文字取出来 | 纯文本 |
三、转完先做这一步:数同名节点的对账法
- 在原文里挑一个最扎手的重复标签,数它出现了 N 次。
- 到转出的 JSON 里找对应的那个键,看它是数组还是对象,数组的长度是不是 N。
- 若是对象而不是数组,说明原文里这个标签本来就只出现一次,别急着怀疑工具,回头再数一遍。
- 若数组长度对不上,多半是原文有嵌套同名标签被拉平了,把这段单独格式化一次再看层级。
要接着处理转出的 JSON,可以顺手粘进 JSON格式化 那一页做美化与校验,同样是浏览器里完成。
四、几种容易掉链子的场景
- 只出现一次的列表项:JSON 那边就是单个对象,这是结构直转的正常结果。想让程序统一按数组读,只能在业务代码里做兼容判断。
- 同名但不同层的标签:字符级解析按层级走,两层的同名各归各,别把它们看成同一串。
- 属性很多、正文很少:属性默认跟着节点走,量大时可先用属性提取把属性单独出成 CSV 或 JSON,见 XML转换。
- 混合内容(标签里夹一段散文本):这一页不插换行,就是为了保住这段散文本和标签的先后关系。
五、别把这几件事做错
- 别把结构直转当成语义识别:这一页不会猜「这几条应该是个列表」,猜是你那边的事。
- 别在原文里塞注释再指望原样回来:注释不参与结构含义,别当数据用。
- 别只看总数不看层级:同名标签套在同一层和套在两层里是两回事。
常见问题
问:能不能强制把某个同名节点转成数组?
答:不能,这一页不做语义猜测;只有一条数据的列表在 JSON 里就是对象,这是结构直转的固有结果。
问:文件会不会被传到别处?
答:不会,这一步在浏览器里完成,文件不离开本机,也不用登录。
问:转换会吃次数吗?
答:不会,这一页不占用任何处理次数。
问:一次能读多大的 XML?
答:以页面提示为准;读不动时先在原文里裁出要处理的那一段再走。
问:为什么我的数组少了几项?
答:先在原文数同名标签的条数,再比对 JSON 里的长度;对不上多半是嵌套或同名跨层的结构差异,不是解析器丢了。
问:能校验 JSON 里数组是否合期望吗?
答:能校验 JSON 结构能不能解析、给出出错位置,但不能替你断言某段该是数组还是对象——那是业务约定。
本站入口
这一步在站内是 XML转换,转 JSON 就在这一页的动作里选,产物是一段结构直转的 JSON 文本。
拿到 JSON 之后先按第三节数一遍同名节点的条数,再决定要不要接去美化、压缩或校验。