ModelSwift 0.2.1

ModelSwift 0.2.1

测试测试过
Lang语言 SwiftSwift
许可证 MIT
发布最近发布2017年3月
SwiftSwift 版本3.0
SPM支持 SPM

hujewelz 维护。



  • hujewelz

ModelSwift

ModelSwift 可以将 json(或 Data)转换为 Swift 中的模型。

用法

⚠️为了将 json(或 Data)转换为模型,模型类必须是 NSObject 的子类。

⚠️如果存储的属性是 Int、Float、Double 等,则不应是可选的。

示例

class User: NSObject {
    var name: String?
    var age = 0 // not var age: Int?
    var desc: String?
}

class Repos: NSObject {
    var title: String?
    var owner: User?
    var viewers: [User]?
}

您可以将 json 键映射到属性名,就像这样

// JSON
{
 "title": "ModelSwift",
 "owner": { "name": "hujewelz", "age": 23, "description": "iOS Developer" },
 "viewers": [
     { "name": "hujewelz", "age": 23, "description": "iOS Developer"},
     { "name": "bob", "age": 24 },
     { "name": "jobs", "age": 54 }
 ]
}

将模型属性映射到不同的 JSON 键

var desc: String?
...

extension User: Replacable {
    var replacedProperty: [String : String] {
        return ["desc": "description" ]
    }
}

对象类型的属性

var owner: User? // an object
...

extension Repos: Reflectable {
    var reflectedObject: [String : AnyClass] {
        return ["owner": User.self]
    }
}

数组中的属性

var viewers: [User]? // an object array
...

extension Repos: ObjectingArray {
    var objectInArray: [String : AnyClass] {
        return ["viewers": User.self]
    }
}

忽略的属性

extension User: Ignorable {
/// the store properties can not to be converted.
    var ignoredProperty: [String] {
    return ["name"]
    }

}

如果 json 中对象的类型无法与模型属性匹配,它可以被转换。

例如。

// JSON
{
    "name": "jewelz"
    "age": "24"     // string => Int
    "isNew": "1223" // string => Bool
}

// model

var name: String?
var age = 0         // 24 
var isNew = false  // true

当我们从服务器获取数据时,我们可以使用 `func ~(lhs: Any, rhs: T.Type) -> T?` 或 `func &(lhs: Any, rhs: T.Type) -> [T]?` 来将它转换为模型或模型数组

// convert to a model object
if let repos = dict ~> Repos.self {
    print(repos)
}

// convert to a model array
if let users = array => User.self {
    print(users)
}

要运行示例项目,请首先从仓库克隆项目,然后在 Example 目录中运行 `pod install`。

要求

  • iOS 8.0+
  • Xcode 8.1+
  • Swift 3.0+

作者

hujewelz

许可证

ModelSwift 在 MIT 许可证下可用。有关更多信息,请参阅 LICENSE 文件。