Swift的XMLCoder库怎么用 Codable协议解析XML

轻涛大大_3889

轻涛大大_3889

2026-02-06

793人浏览

原创

XMLCoder 不能直接用 Codable 解析任意 XML,因其仅支持结构清晰、可映射为 Swift 类型层次的 XML,不支持混合内容、PI、DTD、注释、默认命名空间等;需用 XMLText 处理纯文本节点,数组自动聚合同名元素,可选字段和嵌套结构按 Codable 规则处理。

swift的xmlcoder库怎么用 codable协议解析xml

XMLCoder 不能直接用 Codable 解析任意 XML

Swift 原生 Codable 协议只支持 JSON(通过 JSONEncoder/JSONDecoder),不支持 XML。XMLCoder 是第三方库,它**扩展了 Decoder 和 Encoder 协议**,让 Codable 类型能被用于 XML 编解码,但前提是 XML 结构必须能映射为 Swift 的类型层次 —— 它不是通用 XML 解析器(比如不能处理混合内容、PI、DTD 或任意嵌套文本节点)。

  • 它要求 XML 有清晰的层级结构,标签名与属性名需对应 Swift 属性名(或通过 @XMLKey 显式标注)
  • 不支持 XML 注释、处理指令、命名空间(除非手动配置 XMLDecoder.KeyEncodingStrategy 或自定义 KeyedDecodingContainer)
  • 默认把 XML 属性(attr="value")映射为 Swift 属性,把子元素映射为嵌套结构;文本内容需显式声明为 XMLText 类型

基础用法:定义 Codable 类型 + XMLDecoder.decode(_:from:)

先用 Swift 包管理器添加依赖:https://github.com/MaxDesiatov/XMLCoder,然后定义符合 Codable 的结构体。注意:XML 标签名和 Swift 属性名默认按 snake_case ↔ kebab-case 自动转换(如 user_name ↔ user-name),可通过 keyEncodingStrategy 调整。

import XMLCoder

struct User: Codable {
    let id: Int
    let name: String
    let isActive: Bool
    
    enum CodingKeys: String, CodingKey {
        case id = "user-id"
        case name = "full-name"
        case isActive = "active"
    }
}

let xml = """
<user user-id="123"><full-name>Alice</full-name><active>true</active></user>
"""

do {
    let user = try XMLDecoder().decode(User.self, from: xml.data(using: .utf8)!)
    print(user.id) // 123
} catch {
    print("Decode failed:", error)
}

解析带文本内容的元素(如 9.99)

如果 XML 元素只有纯文本(无子元素、无属性),必须用 XMLText 类型声明,否则解码会失败 —— 这是新手最常踩的坑。

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载
  • 错误写法:let price: Double → 解码报错 Expected element but found text
  • 正确写法:let price: XMLText,或更安全地用 XMLText 再手动转
struct Product: Codable {
    let name: String
    let price: XMLText<double> // ← 必须用 XMLText 包裹
}

let xml = "<product><name>Book</name><price>19.99</price></product>"
let product = try XMLDecoder().decode(Product.self, from: xml.data(using: .utf8)!)

print(product.price.value) // 19.99</double>

处理可选字段、数组、嵌套结构

数组对应多个同名子元素(如 AB),可选字段用 ?,嵌套结构直接用另一个 Codable 类型。XMLCoder 默认将重复元素自动聚合成数组,无需额外标注。

  • 空元素()会被解码为 [](如果类型是 [String])
  • 缺失元素默认为 nil(如果属性是可选型),否则触发解码错误
  • 若想忽略缺失字段而不报错,可设 decoder.keyNotFoundDecodingStrategy = .convertToNil
struct Order: Codable {
    let id: Int
    let items: [Item]
    let notes: String?
}

struct Item: Codable {
    let sku: String
    let qty: XMLText<int>
}

let xml = """
<order id="456"><items><item><sku>ABC</sku><qty>2</qty></item><item><sku>XYZ</sku><qty>1</qty></item></items><notes>Urgent</notes></order>
"""

let order = try XMLDecoder().decode(Order.self, from: xml.data(using: .utf8)!) // items 自动成数组</int>

XMLCoder 对命名空间、CDATA、属性与文本共存的支持较弱,真遇到这类复杂 XML,不如用 XMLParser(SAX)或 SWXMLHash(DOM 风格)更可控。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js git json github

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

2026.03.03

857

16

Swift编程与iOS/macOS应用开发教程合集
Swift编程与iOS/macOS应用开发教程合集

面向苹果生态开发者,系统讲解 Swift 语言核心与 iOS/macOS 应用开发,涵盖 Swift 语法基础、Xcode 开发环境搭建与项目管理、SwiftUI 声明式 UI 开发、UIKit 与 SwiftUI 混合开发策略、Combine 响应式编程框架、数据持久化(SwiftData/Core Data/UserDefaults)、网络请求与 JSON 解析、App 签名/打包/TestFlight 测试与 App Store

2026.06.03

1822

14

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3942

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1316

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4599

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7719

3

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

5264

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6837

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习