ObjectMapper的使用

关于ObjectMapper

关于这个第三方库,我也是最近才接触到,在转到swift的项目当中,其实很长时间都在寻找一个适合库来做网络请求回来的JSON解析,但一直都没有找到较好的,所以之前的项目一直都是手动字典转模型,最近发现了一个轻巧又实用的库--而且再多层嵌套,也可以用几句代码完成转换,简直可以媲美OC中字典转模型的第三方框架.

Github的地址为:https://github.com/Hearst-DD/ObjectMapper

本文主要是翻译github的内容,大家如果英文阅读能力较好的可以自己翻看英文文档

基本使用方法

如果一个类或者结构体的接口实现了Mappable接口的时,便可以支持映射,然后还需要实现协议中的两个接口:

 init?(_ map: Map)mutating 
 func mapping(map: Map)

ObjectMapper实用了一个操作符 "<-"来定义成员变量的映射和JSON的转换.

class User: Mappable {
 //这里要定义好需要转换的内容相对于的字段和类型,以后日后方便赋值转换
var username: String?
var age: Int?
var weight: Double!
var array: [AnyObject]?
var dictionary: [String : AnyObject] = [:]
var bestFriend: User?                       // Nested User object
var friends: [User]?                        // Array of Users
var birthday: NSDate?

required init?(_ map: Map) {
    
}

// Mappable
func mapping(map: Map) {
  //根据字典中的内容用"<-"操作符号来映射相应的内容,将其转换到定义好的成员变量中
    username    <- map["username"]
    age         <- map["age"]
    weight      <- map["weight"]
    array       <- map["arr"]
    dictionary  <- map["dict"]
    bestFriend  <- map["best_friend"]
    friends     <- map["friends"]
    birthday    <- (map["birthday"], DateTransform())
 }
}
 //结构体的话也是执行相应的操作
struct Temperature: Mappable {
var celsius: Double?
var fahrenheit: Double?

init?(_ map: Map) {
    
}

mutating func mapping(map: Map) {
    celsius     <- map["celsius"]
    fahrenheit  <- map["fahrenheit"]
 }
}

唔,一旦你的类接口定义了Mappable,那么你这个类就可以调用简答的方法进行字典转模型的转换啦.

转换一个JSON成相应的类模型:

 let user = User(JSONSting:jsonString)

转换一个模型成相应的字符串:

 let jsonString = user.toJSONString(prettyPrint:true)

除了这种转换方式,Mapper.swfit类还提供了�扩展的方法也可以进行同样的转换:

  // 字典转模型
 let user = Mapper<User>().map(JSONString: JSONString)
 //字典转模型
 let JSONString = Mapper().toJSONString(user, prettyPrint: true)

ObjectMapper支持以下的数据类型

• Int
• Bool
• Double
• Float
• String
• RawRepresentable(Enums)
• Array<AnyObject>
• Dictionary<String, AnyObject>
• Object<T: Mappable>
• Array<T: Mappable>
• Array<Array<T: Mappable>>
• Set<T: Mappable>
• Dictionary<String, T: Mappable>
• Dictionary<String, Array<T: Mappable>>
• Optionals of all the above

Mappable Protocol

mutating func mapping(map: Map)
这个函数里面定义了映射所需要指向的字符串,当解析JSON的过程中,创建好实例对象以后会去执行这个函数,当生成JSON的过程中,这个函数是唯一一个可以被叫做对象.

init?(_ map: Map)

//翻译未完成,待续...其实ObjectMapper的使用非常简单,只要字符串和相对应的Object一一对应即可...