Codable组合@propertyWrapper实现编解码默认值

前言

swift的数据编解码,我们可以使用多种方案,常见的有用苹果自带的Codable和三方HandyJSONswiftyJson等都很好用。

个人觉得能够用官方提供的就尽量用,但是使用Codable的一个很大问题就是不能设置默认值,所以常在模型里面会有很多的可选值出现,导致我们在使用时会随处都要解包,而且还有个很大的问题是如果,在json数据中出现了我们模型中不对应的类型或者缺少,我们的解码就会完全失败。

面临这个问题,我们就能使用苹果提供的@propertyWrapper属性包装来处理,其中喵神已经做了很全面的说明:使用 Property Wrapper 为 Codable 解码设定默认值,如果只关心实现方案,就可以直接看我这里。

开始

1、弄一个属性包装

/// 让需要有默认值的,遵循这个协议,提供默认值的能力,就是让模型必须有个静态属性
protocol DefaultValue {
    associatedtype DefValue: Codable, DefaultValue
    static var defaultValue: DefValue { get }
}
/// 属性包装
@propertyWrapper
struct Default<T: DefaultValue> {
    var wrappedValue: T.DefValue
    
}

2、因为编解码是要实现Codable的,所以让Default遵循Codable协议,实现init(from decoder: Decoder) throws {}这个方法,在失败时传入我们的默认值T.defaultValue

extension Default: Codable {
    init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        wrappedValue = (try? container.decode(T.DefValue.self)) ?? T.defaultValue
    }
}

3、在解码时会调用到KeyedDecodingContainer中的各种decode方法,例如:func decode(Double.Type, forKey: KeyedDecodingContainer<K>.Key) -> Double,我们就需要在KeyedDecodingContainerDefault扩展一个解码方法,也是在解码失败给他传入我们的默认值

extension KeyedDecodingContainer {
    func decode<T>(
        _ type: Default<T>.Type,
        forKey key: Key
    ) throws -> Default<T> where T: DefaultValue {
        try decodeIfPresent(type, forKey: key) ?? Default(wrappedValue: T.defaultValue)
    }
}

4、然后就是为我们的常用类型做一些默认值的扩展,这里我列出了一些常用默认值,可以直接copy,其中要注意的就是数组和字典,他们是有泛型。

// MARK: Dictionary默认值扩展
extension Dictionary: DefaultValue where Key: Codable, Value: DefaultValue & Codable {
    
    static var defaultValue: [Key: Value] { get { return [Key: Value]() } }
}

// MARK: Array默认值扩展
extension Array: DefaultValue where Element: DefaultValue & Codable {
    static var defaultValue: [Element] { get { return [] } }
}

// MARK: Float默认值扩展
extension Float: DefaultValue {
    static var defaultValue: Float = 0
}
// MARK: Double默认值扩展
extension Double: DefaultValue {
    static var defaultValue: Double = 0
}
// MARK: Bool默认值扩展
extension Bool: DefaultValue {
    static let defaultValue = false
    enum True: DefaultValue {
        static let defaultValue = true
    }
}

// MARK: String默认值扩展
extension String: DefaultValue {
    static let defaultValue = ""
}
extension String {
    enum Empty: DefaultValue {
        static let defaultValue = ""
    }
}

extension Int: DefaultValue {
    static let defaultValue = 0
    enum NegativeOne: DefaultValue {
        static let defaultValue = -1
    }
}

// MARK: 取别名
extension Default {
    //Bool
    typealias True = Default<Bool.True>
    typealias False = Default<Bool>
    
    //String
    typealias EmptyString = Default<String>
    
    /// Int
    typealias ZeroInt = Default<Int>
}

5、现在我们的Codable终于是能支持默认值了,使用方法如下:

class FSDefStuct: Codable, DefaultValue {
    @Default<Array> var arr: [FSDefStuctArr] = .defaultValue
    @Default<FSDefStuctBody> var body: FSDefStuctBody = .defaultValue
    @Default<Int> var id: Int = .defaultValue

    static let defaultValue = FSDefStuct()
    required init() {}
}

class FSDefStuctBody: Codable, DefaultValue {
    @Default<String> var Auth: String = .defaultValue
    @Default<String> var name: String = .defaultValue

    static let defaultValue = FSDefStuctBody()
    required init() {}
}

class FSDefStuctArr: Codable, DefaultValue {
    @Default<String> var name: String = .defaultValue
    @Default<MyType> var type: MyType = .defaultValue

    static let defaultValue = FSDefStuctArr()
    required init() {}
}

enum MyType: Int, Codable, DefaultValue {
    case swift
    case OC
    case undefine
    static let defaultValue = MyType.undefine
}

private let testJson = #"{"id": 12345, "body": {"name": "abc", "Auth": "erd"}, "arr": [{"type": 0, "name":"swift"},{"type": 1, "name":"OC"},{"type": 5, "name":"Java"}]}"#

如上面的{"type": 5, "name":"Java"}就是没在我的定义范围内,就会默认转为case undefine,其他的可以将上面testJson中任意删除掉一些字段,或写为null做测试。

是不是很开心,but打印下我们编解码的东西,会看到是如下:

{
  "arr" : {
    "wrappedValue" : [
      {
        "name" : {
          "wrappedValue" : "swift"
        },
        "type" : {
          "wrappedValue" : 0
        }
      },
      {
        "name" : {
          "wrappedValue" : "OC"
        },
        "type" : {
          "wrappedValue" : 1
        }
      },
      {
        "name" : {
          "wrappedValue" : "Java"
        },
        "type" : {
          "wrappedValue" : 2
        }
      }
    ]
  },
  "id" : {
    "wrappedValue" : 12345
  },
  "body" : {
    "wrappedValue" : {
      "name" : {
        "wrappedValue" : "abc"
      },
      "Auth" : {
        "wrappedValue" : "erd"
      }
    }
  }
}

怎么会变成这样???,这就是属性包装帮你做的事情,但是谁都不想要这种效果。这里其实是编码时出的问题,我们只扩展了用于解码的KeyedDecodingContainer,所以我们还需要扩展一下编码KeyedEncodingContainer,在编码时直接取wrappedValue里边的值就行了。

extension KeyedEncodingContainer {
    mutating func encode<T>(
        _ value: Default<T>,
        forKey key: Self.Key
    ) throws where T : Encodable & DefaultValue {
        try encodeIfPresent(value.wrappedValue, forKey: key)
    }
}

这样就能转json时出现我们想要的效果了

{
  "arr" : [
    {
      "name" : "swift",
      "type" : 0
    },
    {
      "name" : "OC",
      "type" : 1
    },
    {
      "name" : "Java",
      "type" : 2
    }
  ],
  "id" : 12345,
  "body" : {
    "name" : "abc",
    "Auth" : "erd"
  }
}

到此还没完,作为cv大法的coder们,肯定觉得是如果这样手写模型好累啊,所以我这里就借用JSONConverter增加了一个DefaultCodableBuilder.swift文件。

import Foundation

class DefaultCodableBuilder: BuilderProtocol {
    func isMatchLang(_ lang: LangType) -> Bool {
        return  lang == .DefualtCodable
    }
    
    func propertyText(_ type: PropertyType, keyName: String, strategy: PropertyStrategy, maxKeyNameLength: Int, typeName: String?) -> String {
        assert(!((type == .Dictionary || type == .ArrayDictionary) && typeName == nil), " Dictionary type the typeName can not be nil")
        let tempKeyName = strategy.processed(keyName)
        var str = ""
        switch type {
        case .String, .Null:
            str = "\t<String> var \(tempKeyName): String\n"
        case .Int:
            str = "\t<Int> var \(tempKeyName): Int\n"
        case .Float:
            str = "\t<Float> var \(tempKeyName): Float\n"
        case .Double:
            str = "\t<Double> var \(tempKeyName): Double\n"
        case .Bool:
            str = "\t<Bool> var \(tempKeyName): Bool\n"
        case .Dictionary:
            str = "\t<\(typeName!)> var \(tempKeyName): \(typeName!)\n"
        case .ArrayString, .ArrayNull:
            str = "\t<Array> var \(tempKeyName): [String]\n"
        case .ArrayInt:
            str = "\t<Array> var \(tempKeyName): [Int]\n"
        case .ArrayFloat:
            str = "\t<Array> var \(tempKeyName): [Float]\n"
        case .ArrayDouble:
            str = "\t<Array> var \(tempKeyName): [Double]\n"
        case .ArrayBool:
            str = "\t<Array> var \(tempKeyName): [Bool]\n"
        case .ArrayDictionary:
            str = "\t<Array> var \(tempKeyName): [\(typeName!)]\n"
        }

        str.insert(contentsOf: "@Default", at: str.index(str.startIndex, offsetBy: 1))
        str.insert(contentsOf: " = .defaultValue", at: str.index(str.endIndex, offsetBy: -1))

        return str
    }
    
    func contentParentClassText(_ clsText: String?) -> String {
       return StringUtils.isEmpty(clsText) ? ": Codable" : ": \(clsText!)"
    }
    
    func contentText(_ structType: StructType, clsName: String, parentClsName: String, propertiesText: inout String, propertiesInitText: inout String?, propertiesGetterSetterText: inout String?) -> String {
        if structType == .class {
            return "\nclass \(clsName)\(parentClsName), DefaultValue {\n\(propertiesText)\n\tstatic let defaultValue = \(clsName)()\n\trequired init() {}\n}\n"
        } else {
            propertiesText.removeLastChar()
            return "\nstruct \(clsName)\(parentClsName), DefaultValue {\n\(propertiesText)\n\tstatic let defaultValue = \(clsName)(\(propertiesInitText!.substring(from: 2)))\n}\n"
        }
    }
    
    func fileExtension() -> String {
        return "swift"
    }
    
    func fileImportText(_ rootName: String, contents: [Content], strategy: PropertyStrategy, prefix: String?) -> String {
        return"\nimport Foundation\n"
    }
}

这样就能卡卡的转模型了。


转Class

转Struct

至此完成,喜欢的觉得有用的点个赞!!!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,724评论 6 479
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,104评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,142评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,086评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,076评论 5 370
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,914评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,220评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,871评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,318评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,834评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,951评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,574评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,162评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,162评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,383评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,349评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,652评论 2 343

推荐阅读更多精彩内容