Swift Codable协议实战:快速、简单、高效地完成JSON和Model转换!

这篇具有很好参考价值的文章主要介绍了Swift Codable协议实战:快速、简单、高效地完成JSON和Model转换!。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

Swift Codable协议实战:快速、简单、高效地完成JSON和Model转换!

前言

CodableSwift 4.0 引入的一种协议,它是一个组合协议,由 DecodableEncodable 两个协议组成。它的作用是将模型对象转换为 JSON 或者是其它的数据格式,也可以反过来将 JSON 数据转换为模型对象。

EncodableDecodable 分别定义了 encode(to:)init(from:) 两个协议函数,分别用来实现数据模型的归档和外部数据的解析和实例化。最常用的场景就是刚提到的 JSON 数据与模型的相互转换,但是 Codable 的能力并不止于此。

简单应用

在实际开发中,Codable 的使用非常方便,只需要让模型遵循 Codable 协议即可:

struct GCPerson: Codable {
    var name: String
    var age: Int
    var height: Float // cm
    var isGoodGrades: Bool
}

接下来编写数据编码和解码的方法:

func encodePerson() {
	let person = GCPerson(name: "XiaoMing", age: 16, height: 160.5, isGoodGrades: true)
	let encoder = JSONEncoder()
	encoder.outputFormatting = .prettyPrinted // 优雅永不过时,json会好看点哟
	do {
		let data = try encoder.encode(person)
		let jsonStr = String(data: data, encoding: .utf8)
		textView.text = jsonStr
		print(jsonStr as Any)
	} catch let err {
		print("err", err)
	}
}

func decodePerson() {
	let jsonStr = "{\"age\":16,\"isGoodGrades\":1,\"name\":\"XiaoMing\",\"height\":160.5}"
	guard let data = jsonStr.data(using: .utf8) else {
		print("get data fail")
		return
	}
	let decoder = JSONDecoder()
	do {
		let person = try decoder.decode(GCPerson.self, from: data)
		print(person)
	} catch let err {
		print("err", err)
	}
}

上面例子的输出:

Optional("{\n  \"age\" : 16,\n  \"isGoodGrades\" : true,\n  \"name\" : \"XiaoMing\",\n  \"height\" : 160.5\n}")
GCPerson(name: "XiaoMing", age: 16, height: 160.5, isGoodGrades: false)

应该有眼尖的童鞋是发现了,我将 JSONEncoderoutputFormatting 设置为了 prettyPrinted,这会让它输出的时候会美观一下,比如将它们放置在 UITextView 视图中作对比:

Swift Codable协议实战:快速、简单、高效地完成JSON和Model转换!

这里指的 default 是在没有设置 outputFormatting 的默认情况

CodingKeys 字段映射

如果属性名称与 JSON 数据中的键名不一致,需要使用 Swift 语言中的 CodingKeys 枚举来映射属性名称和键名。CodingKeys 是一个遵循了 CodingKey 协议的枚举,它可以用来描述 Swift 对象的属性与 JSON 数据中的键名之间的映射关系。

struct Address: Codable {
    var zipCode: Int
    var fullAddress: String
    
    enum CodingKeys: String, CodingKey {
        case zipCode = "zip_code"
        case fullAddress = "full_address"
    }
}

数据编码和解码的方法与前面的大同小异:

func encodeAddress() {
	let address = Address(zipCode: 528000, fullAddress: "don't tell you")
	let encoder = JSONEncoder()
	encoder.outputFormatting = .prettyPrinted // 优雅永不过时,json会好看点哟
	do {
		let data = try encoder.encode(address)
		let jsonStr = String(data: data, encoding: .utf8)
		textView.text.append("\n\n")
		textView.text = textView.text.appending(jsonStr ?? "")
		print(jsonStr as Any)
	} catch let err {
		print("err", err)
	}
}

func decodeAddress() {
	let jsonStr = "{\"zip_code\":528000,\"full_address\":\"don't tell you\"}"
	guard let data = jsonStr.data(using: .utf8) else {
		print("get data fail")
		return
	}
	let decoder = JSONDecoder()
	do {
		let address = try decoder.decode(Address.self, from: data)
		print(address)
	} catch let err {
		print("err", err)
	}
}

此时的输出为:

Optional("{\n  \"zip_code\" : 528000,\n  \"full_address\" : \"don\'t tell you\"\n}")
Address(zipCode: 528000, fullAddress: "don\'t tell you")

从控制台日志可以看出,Address 模型中的的 zipCodefullAddress 属性字段已被替换为 zip_codefull_address,值得注意的是,使用 CodingKeys 映射后就只能使用映射后的字段名称。

数据类型匹配

Swift 中的数据类型需要与 JSON 数据中的数据类型匹配,否则将无法正确地进行解码。如果数据类型不匹配,则会进入到 catch 代码块,意味着解码失败。

let jsonStr = "{\"age\":16,\"isGoodGrades\":1,\"name\":\"XiaoMing\",\"height\":160.5}"

在上面的例子中,将 isGoodGrades 的值改为1,此时输出的错误内容为:

err typeMismatch(Swift.Bool, Swift.DecodingError.Context(codingPath: [CodingKeys(stringValue: "isGoodGrades", intValue: nil)], debugDescription: "Expected to decode Bool but found a number instead.", underlyingError: nil))

由此引出,Bool 型只支持 truefalse,其它一概不认。

注意:只要是其中一个数据字段不能解析,则整条解析失败。

Date 和 Optional 可选类型

在使用 Codable 对 Date 和 Optional 属性进行编解码时,有些细节是需要了解的。

Codable 默认启用的时间策略是 deferredToDate,即从 UTC时间2001年1月1日0时0分0秒 开始的秒数,对应 Date 类型中 timeIntervalSinceReferenceDate 这个属性。比如 702804983.44863105 这个数字解析后的结果是 2023-04-10 07:34:17 +0000

在这儿把时间策略设置为 secondsSince1970,因为这个会比上面的要常用。我们需将 JSONEncoderdateEncodingStrategy 设置为 secondsSince1970JSONDecoder 也是相同的设置。

在设置 Optional 可选类型时,在编码时,为空的属性不会包含在 JSON 数据中。在解码时,直接不传或将值设定为 \"null\" / \"nil\" / null 这三种值也能被解析为 nil

struct Activity: Codable {
    var time: Date
    var url: URL?
}

编码解码的工作:

func encodeActivity() {
	let activity = Activity(time: Date(), url: URL(string: "https://www.baidu.com"))
	let encoder = JSONEncoder()
	encoder.outputFormatting = .prettyPrinted // 优雅永不过时,json会好看点哟
	encoder.dateEncodingStrategy = .secondsSince1970 // 秒
	do {
		let data = try encoder.encode(activity)
		let jsonStr = String(data: data, encoding: .utf8)
		textView.text.append("\n\n")
		textView.text = textView.text.appending(jsonStr ?? "")
		print(jsonStr as Any)
	} catch let err {
		print("err", err)
	}
}

func decodeActivity() {
//        let jsonStr = "{\"time\":528000,\"url\":111}" // 即便是 Optional 的属性也要对应的数据类型,否则还是会解析失败
	let jsonStr = "{\"time\":1681055185}" // Optional类型的属性字段,直接不传也是nil
	//        let jsonStr = "{\"time\":528000,\"url\":null}" // 以下三种也能被解析为nil,\"null\" / \"nil\" / null
	guard let data = jsonStr.data(using: .utf8) else {
		print("get data fail")
		return
	}
	let decoder = JSONDecoder()
	decoder.dateDecodingStrategy = .secondsSince1970 // 秒
	do {
		let activity = try decoder.decode(Activity.self, from: data)
		print(activity)
	} catch let err {
		print("err", err)
	}
}

此时的输出为:

Optional("{\n  \"url\" : \"https:\\/\\/www.baidu.com\",\n  \"time\" : 1681057020.835813\n}")
Activity(time: 2023-04-09 15:46:25 +0000, url: nil)

自定义编解码

有时候前后端定义的模型不同时,有可能会需要用到自定义编解码,以此来达成“统一”。

比如我们现在有一个 Dog 模型,sex 字段为 Bool 型,在后端的定义为 0 和 1,此时我们需要将它们给转换起来,可以是 false 为 0,true 为 1。

struct Dog: Codable {
    var name: String
    var sex: Bool // 0/false女 1/true男
    
    init(name: String, sex: Bool) {
        self.name = name
        self.sex = sex
    }
    
    // 必须实现此枚举,在编码解码方法中需要用到
    enum CodingKeys: CodingKey {
        case name
        case sex
    }

    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        self.name = try container.decode(String.self, forKey: .name)
        // 取出来int后再转换为Bool
        let sexInt = try container.decode(Int.self, forKey: .sex)
        sex = sexInt == 1
    }
    
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(self.name, forKey: .name)
        // 将sex属性以int类型编码
        try container.encode(sex ? 1 : 0, forKey: .sex)
    }
}

在编码的时候将 sex 从 Bool 型转换为 Int 型,解码时则反过来。编解码的工作依旧与前面的大致一样:

func encodeDog() {
	let dog = Dog(name: "Max", sex: true)
	let encoder = JSONEncoder()
	encoder.outputFormatting = .prettyPrinted // 优雅永不过时,json会好看点哟
	do {
		let data = try encoder.encode(dog)
		let jsonStr = String(data: data, encoding: .utf8)
		textView.text.append("\n\n")
		textView.text = textView.text.appending(jsonStr ?? "")
		print(jsonStr as Any)
	} catch let err {
		print("err", err)
	}
}

func decodeDog() {
	let jsonStr = "{\"name\":\"Max\",\"sex\":1}"
	guard let data = jsonStr.data(using: .utf8) else {
		print("get data fail")
		return
	}
	let decoder = JSONDecoder()
	do {
		let dog = try decoder.decode(Dog.self, from: data)
		print(dog)
	} catch let err {
		print("err", err)
	}
}

此时的日志输出为:

Optional("{\n  \"name\" : \"Max\",\n  \"sex\" : 1\n}")
Dog(name: "Max", sex: true)

总结

CodableSwift 中非常方便的一个协议,可以帮助我们快速进行数据的编码和解码,提高了开发效率和代码可读性。当然使用不当也会造成严重的灾难,所以我为大家整理了以下几点使用时的注意事项,希望能对大家有所帮助:

  1. 嵌套的数据结构也需要遵循 Codable 协议。
  2. Bool 型只支持 truefalse
  3. Optional 类型修饰的属性字段,直接不传是 nil,或将值设定为以下三种也能被解析为 nil\"null\" / \"nil\" / null
  4. 可以使用自定义的编码器和解码器来进行转换。

Demo

我把代码放在了 github 上面,可以到这儿下载:GarveyCalvin/iOS-Travel。

谢谢你这么好看还关注我,大家一起进步吧。

关于作者

博文作者:GarveyCalvin
公众号:凡人程序猿
本文版权归作者所有,欢迎转载,但必须保留此段声明,并给出原文链接,谢谢合作!文章来源地址https://www.toymoban.com/news/detail-424041.html

到了这里,关于Swift Codable协议实战:快速、简单、高效地完成JSON和Model转换!的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Python 中的 JSON 操作:简单、高效的数据交换格式

    在现代的数据交换和存储中,JSON(JavaScript Object Notation)作为一种轻量级的数据交换格式,备受青睐。它不仅易于阅读和理解,还可以灵活地表达和存储高维数据。本文将介绍如何在 Python 中操作 JSON 文件,实现数据的序列化和反序列化。 JSON 格式采用键值对的方式表达信息

    2024年02月10日
    浏览(71)
  • 如何高效优雅的完成一次机器学习服务部署?一文详解部署难点以及实战案例

    伴随着ChatGPT的大火,很多人也逐渐认识到人工智能正在逐步由底层建筑上升到交互服务,其实在没有兴起ChatGPT时,人工智能技术就已经发展的比较成熟了。像是现在机器学习以及深度学习都已经普及在各大高校社区了,而且市场上已经有非常多的目标识别、图像检测等计算

    2023年04月15日
    浏览(39)
  • ChatGPT4和python完美融合,快速完成数据分析与可视化、人工智能建模及论文高效撰写

    2022年11月30日,可能将成为一个改变人类历史的日子——美国人工智能开发机构OpenAI推出了聊天机器人ChatGPT3.5,将人工智能的发展推向了一个新的高度。2023年4月,更强版本的ChatGPT4.0上线,文本、语音、图像等多模态交互方式使其在各行各业的应用呈现了更多的可能性。202

    2024年02月03日
    浏览(72)
  • 【快速开始】一个简单的Flask-SocketIO应用,完成后端推送消息接收与关闭

    本人使用环境及版本: Anaconda: 虚拟环境: Python版本:3.8.13 安装包及版本: Flask-SocketIO :5.3.4 eventlet :0.33.3 创建app.py文件(文件名随意,不过要与后面的运行脚本中指定的文件保持一致) cmd 或者 linux控制台运行即可 此时能看到如下图所示 此时访问http://0.0.0.0:5200(0.0.0

    2024年02月13日
    浏览(55)
  • Swift CustomStringConvertible 协议的使用

    目录 一、前言 二、使用场景 1. 整型类型的枚举使用 2. Class类型的使用 原文地址:https://zhanglei.blog.csdn.net/article/details/125715772 先看一下Swift标准库中对 CustomStringConvertible 协议的定义 从声明中我们可以看到协议中只包含了一个 description 的只读属性 ,而且通过协议命名也可以窥

    2023年04月21日
    浏览(25)
  • 车联网场景中 JT/T 808 协议终端免开发快速接入阿里云 IoT 物联网平台实战

    车联网场景中 JT/T 808协议 是一种在中国广泛应用的车载终端通信协议,用于车辆与监控中心之间的数据通信。 01 JT/T808 协议 JT/T808 协议是指交通部颁布的《 道路运输车辆卫星定位系统终端通讯协议及数据格式 》,广泛应用于车辆远程监管、物流管理、车辆安防等领域。它为

    2024年02月04日
    浏览(65)
  • 测试工具分享:高效完成测试工作!

    说在前头 大家🐒啊,我是小🍬,小伙伴们一般都叫我苏苏。我在软件 测试 行业有5年的经验,目前是一家小公司技术部门的测试主管。 在社会上,特别是技术圈, 大家会有刻板印象:测试工作的含金量不高 。因为大家觉得测试不重要,导致给测试的薪水也偏低;这又反向

    2024年02月02日
    浏览(50)
  • IOS-UIAlertController简单使用-Swift

    UIAlertControlle时IOS的对话框控制器(警报控制器),简单使用方法如下: 步骤都一样,先是创建UIAlertController,然后创建UIAlertAction,再将UIAlertAction添加到UIAlertController中,最后显示对话框。 效果如图: 效果如图: 注意preferredStyle为.actionSheet 效果如图:

    2024年01月18日
    浏览(46)
  • 使用SpringBoot一小时快速搭建一个简单后台管理(增删改查)(超详细教程) 各大技术基础教学、实战项目开发教学

     最近也是临近期末了,各种的期末大作业,后台管理也是很多地方需要用到的,为了方便大家能快速上手,快速搭建一个简单的后台管理,我花了两天时间整理了一下 我会从0开始介绍,从数据库的设计到前端页面的引入最后到后端代码的编写,你只需要会一点前端的基础和

    2023年04月13日
    浏览(92)
  • Swift的高级语法特性,如可选类型、闭包、枚举、泛型、协议、扩展等

    Swift是一门现代化的编程语言,具有许多高级语法特性,下面我们来逐一介绍。 1. 可选类型(Optional) Swift中的可选类型是一种特殊的类型,它可以表示一个值是存在或不存在的。在声明一个可选类型时,需要在类型名称后面加上一个问号(?)来表示这个类型是可选的。例如

    2024年02月04日
    浏览(36)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包