讲师中心 微信公众号
AI工具推荐 视频效率加速

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

轻涛大大_3889

轻涛大大_3889

发布时间:2026-02-06 11:00:11

|

773人浏览过

|

来源于php中文网

原创

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 调整。

YiHui GIT MONITOR
YiHui GIT MONITOR

通用Git项目监控工具,支持GitHub、GitLab、Gitee等所有平台,自动检测、添加/删除仓库更新并生成变更摘要。

下载
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 类型声明,否则解码会失败 —— 这是新手最常踩的坑。

  • 错误写法:let price: Double → 解码报错 Expected element but found text
  • 正确写法:let price: XMLText<double></double>,或更安全地用 XMLText<string></string> 再手动转
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

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

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

  • 空元素(<tags></tags>)会被解码为 [](如果类型是 [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 自动成数组
XMLCoder 对命名空间、CDATA、属性与文本共存的支持较弱,真遇到这类复杂 XML,不如用 XMLParser(SAX)或 SWXMLHash(DOM 风格)更可控。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

837

2026.03.03

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

1402

2026.06.03

json数据格式
json数据格式

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

2195

2023.08.07

json是什么
json是什么

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

3442

2023.08.23

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

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

1156

2023.10.13

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

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

3939

2025.09.10

string转int
string转int

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

6719

2023.08.02

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

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

4724

2024.04.01

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

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

精品课程

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

共101课时 | 21.2万人学习

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

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn