打造Moya便捷解析库,提供RxSwift拓展

一、概述

1、相信大家在使用Swift开发时,Moya是首选的网络工具,在模型解析这一块,Swift版模型解析的相关第三方库有很多,本人最习惯用的就是SwiftyJSON。 2、下面会开始讲解整个主要的开发功能与思想。 3、以下内容是基于大家会使用Moya和SwiftJSON的前提下所著,还不会的同学可以先简单了解后再来阅读本篇文章哦~

二、功能开发与思想讲解

1、尝试模型解析

Moya请求服务器返回的数据以Response类返回给我们,那我们就给Response类做一个扩展,这里以解析模型为例

// 需要传入一个参数,告知我们要转换出什么模型
public func mapObject<T: Modelable>(_ type: T.Type) -> T {
    // 模型解析过程
    。。。
  
    return T
}

Q: 那中间的解析过程该怎么写呢? A: 可以让开发者遵守某个协议,实现指定的转换方法并描述转换关系。其转换过程我们不需要知道,交给开发者即可。

那接着我们来定义一个协议Modelable,并声明转换方法

public protocol Modelable {
    mutating func mapping(_ json: JSON)
}

开发者创建一个MyMoel的结构体,遵守协议Modelable,并实现mapping,书写转换关系

struct MyModel: Modelable {
    var _id = ""
    
    mutating func mapping(_ json: JSON) {
        self._id = json["_id"].stringValue
    }
}

以目前的现状来分析一下:mapObject可以让开发者传入模型类型,而我们的协议方法却并非是个类方法。那我们需要先得到这个模型类型的对象,再来调用mapping方法

2、模型解析的驱动开发

Q: 怎么得到这个对象? A: 可以在协议中声明一个初始化方法来创建对象。是的,我们在mapObject中创建对应模型类型的对象,调用mapping方法来转换数据,再把模型对象传出去即可。

那我们在Modelable中声明一个init方法,并传入一个参数,区别于其它初始化方法

public protocol Modelable {
    mutating func mapping(_ json: JSON)
    init(_ json: JSON)
}

OK,现在把mapObject方法补齐模型解析过程

public func mapObject<T: Modelable>(_ type: T.Type) -> T {
    let modelJson = JSON(data)["modelKey"]
    // 模型解析过程
    var obj = T.init(modelJson)
    obj.mapping(modelJson)
    return obj
}

3、自定义解析键名

Q: 这样是搞定解析了,但是网络请求回来的json格式错综复杂,有什么办法可以让开发者来自行指定model对应的键名呢? A: 嗯嗯,既然解析过程是在 Response 扩展里操作的,那我们可以通过协议定义键名属性,并且使用 Runtime 给Response动态添加一个属性,来记录遵守协议后的相应类名

public protocol ModelableParameterType {
    /// 请求成功时状态码对应的值
    static var successValue: String { get }
    /// 状态码对应的键
    static var statusCodeKey: String { get }
    /// 请求后的提示语对应的键
    static var tipStrKey: String { get }
    /// 请求后的主要模型数据的键
    static var modelKey: String { get }
}
// MARK:- runtime
extension Response {
    private struct AssociatedKeys {
        static var lxf_modelableParameterKey = "lxf_modelableParameterKey"
    }
    var lxf_modelableParameter: ModelableParameterType.Type {
        get {
            let value = objc_getAssociatedObject(self, &AssociatedKeys.lxf_modelableParameterKey) as AnyObject
            guard let type = value as? ModelableParameterType.Type else { return NullParameter.self }
            return type
        } set {
            objc_setAssociatedObject(self, &AssociatedKeys.lxf_modelableParameterKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
        }
    }
}

这里有个坑:_SwiftValue问题 (献上 参考链接) 如果我们存储的不是OC对象,那么objc_getAssociatedObject取出来的值的类型统统为_SwiftValue,直接as? ModelableParameterType.Type绝对是nil,需要在取出来后as AnyObject再转换为其它类型才会成功~~

现在开发者就可以创建一个类来遵守ModelableParameterType协议,并自定义解析键名

struct NetParameter : ModelableParameterType {
    static var successValue: String { return "false" }
    static var statusCodeKey: String { return "error" }
    static var tipStrKey: String { return "errMsg" }
    static var modelKey: String { return "results" }
}

4、插件注入

Q: 厉害了,不过要在什么时机下存储这个自定义键名的NetParameter? A: 额,这个~~~ 哦,对了,可以通过Moya提供的插件机制!

翻出Moya中的Plugin.Swift,找到这个process方法,看看方法说明。

/// 在结束之前,可以被用来修改请求结果
/// Called to modify a result before completion.
func process(_ result: Result<Moya.Response, MoyaError>, target: TargetType) -> Result<Moya.Response, MoyaError>

那好,我们也做一个插件MoyaMapperPlugin给开发者使用,在创建MoyaMapperPlugin时把自定义解析键名的类型传进来

public struct MoyaMapperPlugin: PluginType {
    var parameter: ModelableParameterType.Type
    
    public init<T: ModelableParameterType>(_ type: T.Type) {
        parameter = type
    }
    
    // modify response
    public func process(_ result: Result<Response, MoyaError>, target: TargetType) -> Result<Response, MoyaError> {
        _ = result.map { (response) -> Response in
            // 趁机添加相关数据 
            response.lxf_modelableParameter = parameter
            return response
        }
        return result
    }
}

使用:开发者在创建MoyaProvider对象时,顺便注入插件。(OS: 这一步堪称“注入灵魂”)

MoyaProvider<LXFNetworkTool>(plugins: [MoyaMapperPlugin(NetParameter.self)])

5、总结

以上就是主要的踩坑过程了。模型数组解析和指定解析也跟这些差不多的,这里就不再赘述。本人已经将其封装成一个开源库 MoyaMapper,包含了上述已经和未曾说明的功能,下面会讲解如何去使用。以上部分可以称为开胃菜,目的就是平滑过渡到下面MoyaMapper的具体使用。

可能单单使用MoyaMapper的默认子库Core,作用体会上并不会很深。但是,如果你也是使用RxSwift来开发项目的话,请安装'MoyaMapper/Rx'吧,绝对一个字:「爽」

二、MoyaMapper的使用

MoyaMapper是基于Moya和SwiftyJSON封装的工具,以Moya的plugin的方式来实现间接解析,支持RxSwift

1、定义并注入自定义键名类

  1. 定义一个遵守ModelableParameterType协议的结构体
// 各参数返回的内容请参考上面JSON数据对照图
struct NetParameter : ModelableParameterType {
    static var successValue: String { return "false" }
    static var statusCodeKey: String { return "error" }
    static var tipStrKey: String { return "" }
    static var modelKey: String { return "results" }
}

此外,这里还可以做简单的路径处理,以应付各种情况,以'>'隔开

// 假设返回的json数据关于请求状态的相关数据如下所示,
error: {
    'errorStatus':false
    'errMsg':'error Argument type'
}
// 我们指明解析路径:error对象下的errMsg字段,一层层表示下去即可
static var tipStrKey: String { return "error>errMsg" }
  1. 以plugin的方式传递给MoyaProvider
// MoyaMapperPlugin这里只需要传入类型
MoyaProvider<LXFNetworkTool>(plugins: [MoyaMapperPlugin(NetParameter.self)])

2、定义解析模型

创建一个遵守Modelable协议的结构体

struct MyModel: Modelable {
    
    var _id = ""
    ...
    
    init(_ json: JSON) { }
    
    mutating func mapping(_ json: JSON) {
        self._id = json["_id"].stringValue
        ...
    }
}

遵守Modelable协议,实现协议的两个方法,在`mapping`方法中描述模型字段的具体解析

3、解析数据

0x00 请求结果与模型解析

// Result
public func mapResult(params: ModelableParamsBlock? = nil) -> MoyaMapperResult

// Model
public func mapObject<T: Modelable>(_ type: T.Type, modelKey: String? = nil) -> T
// Result+Model
public func mapObjResult<T: Modelable>(_ type: T.Type, params: ModelableParamsBlock? = nil) -> (MoyaMapperResult, T)

// Models
public func mapArray<T: Modelable>(_ type: T.Type, modelKey: String? = nil) -> [T]
// Result+Models
public func mapArrayResult<T: Modelable>(_ type: T.Type, params: ModelableParamsBlock? = nil) -> (MoyaMapperResult, [T])

上面的五个方法,观其名,知其意,这里就不过多解释了,主要注意两点:

  • result
// 元祖类型
// 参数1:根据statusCodeKey取出的值与successValue是否相等
// 参数2:根据tipStrKey取出的值
result:(Bool, String)
  • params
// params: ModelableParamsBlock? = nil
// 这里只有在特殊场景下才需要使用到。如:项目中需要在某处使用特定接口,但是返回的json格式跟自己项目的不一样,并且只有这么一两处用得着该额外接口,那就需要我们这个参数了,以Block的方式返回解析参数类型。

0x01、特定解析

// Model
public func toJSON(modelKey: String? = nil) -> JSON
// 获取指定路径的值
public func fetchJSONString(path: String? = nil, keys: [JSONSubscriptType]) -> String

这两个方法,如果没有指定路径,默认都是针对modelKey的

// fetchJSONString(keys: <[JSONSubscriptType]>)
1、通过 keys 传递数组, 该数组可传入的类型为 Int 和 String
2、默认是以 modelKey 所示路径,来获取相应的数值。如果modelKey并非是你所想要使用的解析路径,可以使用下方的重载方法重新指定路径即可

// response.fetchJSONString(path: <String?>, keys: <[JSONSubscriptType]>)

MoyaMapper也提供了Rx子库,为方便RxSwift的流式编程下便捷解析数据

MoyaMapper默认只安装Core下的文件
pod 'MoyaMapper'

RxSwift拓展
pod 'MoyaMapper/Rx'

具体使用还不是很明白的同学可以下载并运行Example看看

如果MoyaMapper有什么不足的地方,欢迎提出issues,感谢大家的支持

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏LhWorld哥陪你聊算法

【Linux篇】--awk的使用

awk是一个强大的文本分析工具。相对于grep的查找,sed的编辑,awk在其对数据分析并生成报告时,显得尤为强大。 简单来说awk就是把文件逐行的读入,(空格...

1242
来自专栏Kirito的技术分享

JAVA 拾遗--Future 模式与 Promise 模式

写这篇文章的动机,是缘起于微信闲聊群的一场讨论,粗略整理下,主要涉及了以下几个具体的问题: 同步,异步,阻塞,非阻塞的关联及区别。 JAVA 中有 callb...

2.3K8
来自专栏進无尽的文章

简述OC语言

对于一门语言的学习是需要时间领悟的,而对于一些原理性的问题,我们需要清楚其核心思想,知其然而知其所以然,这样才能有利于自己的后续发展。本文只是简述,没有面面具到...

1282
来自专栏偏前端工程师的驿站

JS魔法堂:Data URI Scheme介绍

一、前言                                   上周五公司内部的Any Topic Conf.上我和同事们分享了这个主题,有同事说...

2147
来自专栏极客猴

Django 学习笔记之模型高级用法(上)

前面有两篇文章简单介绍 Django 的模型,这一部分算是基础知识。我自己近期也总做了下总结,将花大概两篇的篇幅来分享下模型的一些高级用法。

633
来自专栏木木玲

Netty 源码解析 ——— AdaptiveRecvByteBufAllocator

2852
来自专栏IT杂记

通过Java程序提交通用Mapreduce任务并获取Job信息

背景 我们的一个业务须要有对MR任务的提交和状态跟踪的功能,须要通过Java代码提交一个通用的MR任务(包括mr的jar、配置文件、依赖的第三方jar包),并且...

9755
来自专栏阿杜的世界

Spring中bean的scope

Spring容器中的bean具备不同的scope,最开始只有singleton和prototype,但是在2.0之后,又引入了三种类型:request、sess...

842
来自专栏Golang语言社区

Go基础系列:channel入门

channel用于goroutines之间的通信,让它们之间可以进行数据交换。像管道一样,一个goroutine_A向channel_A中放数据,另一个goro...

1034
来自专栏LinXunFeng的专栏

打造Moya便捷解析库,提供RxSwift拓展

1、相信大家在使用Swift开发时,Moya是首选的网络工具,在模型解析这一块,Swift版模型解析的相关第三方库有很多,本人最习惯用的就是SwiftyJSON...

22011

扫码关注云+社区