iOS JSONModel解析数据成Model

转发自 http://blog.csdn.net/smking/article/details/40432287

 

JSONModel， Mantle

这两个开源库都是用来进行封装JSON->Model的， 想一想看， 直接向服务器发起一个请求，而后回来后，就是一个Model， 直接使用， 这是一个多么美好的事情。 感谢GitHub的开源精神。

 

那咱们开始吧。 

先说说这两个的差异。

这两个使用的方法其实都差很少， 详细的使用方法请直接GitHub上找， 仍是比较简单地。 就我我的来讲JSONModel相对起来使用较为简单，而Mantle使用起来略为复杂，可是Mantle彷佛比JSONModel更为强大。 

通常的项目，其实使用JSONModel就已经足够。 

 

 下面讲一下JSONModel的使用方法。 

@inteface MyModel : JSONModel

 

1. 使用JSONModel时，不须要额外去检查所要的服务器属性是否有返回。JSONModel的initWithDictionary方法会自动去进行检查并处理。

 

2. 有效性检查，若是指定的服务器返回的某个字段没有返回，并且又是必须的， 像下面这样写，则会抛出异常。

 

//this property is required

@property (strong, nonatomic) NSString* string;

由于默认这个值是必须的。

 

 

通常状况下，咱们不想由于服务器的某个值没有返回就使程序崩溃， 咱们会加关键字Optional.

 

//this one's optional

@property (strong, nonatomic) NSNumber<Optional>* number;

 

 

3. 原子数据， 以前多是以下面这样操做数据

 

if (jsonDict[@"name"])

labelName.text = jsonDict[@"name"];

else

[self showErrorMessageAndBailout];

 

这段代码会使得jsonDict[@"name"], 会被读取，而后进行有效性判断，最后再被使用。 换句话来讲，这里使用了三次， 而若是某些状况下，使用一次就已经出错，但却没法阻止它接下来的连续出错。

 

而若是使用JSONModel的属性，则只会保证上面只使用一次，就能够进行有效性的判断以及使用。（其实上面也能够作到，只须要把这个值取出来，存下来接着使用却可，可是代码会稍显麻烦）

同时读取一批数据以下面代码：

简单模型以下：

 

SimpleModel* model = [[SimpleModel alloc] initWithString:@"...json here..." error:nil];

 

 

复杂模型以下， 这里假设复杂模型包含了简单模型。主要是为了说明模型以前的包含状况下，照样能够进行解析。

 

SuperComplicatedModel* model = [[SuperComplicatedModel alloc] initWithString:@"...json here..." error:nil];

 

模型的批处理，即一次能够处理一批模型。

 

 

NSArray* models = [SuperComplicatedModel arrayOfObjectsFromDictionaries: jsonDatas error:nil];

 

 

 

4. 数据转换, OC <-> JSON

注意下面这张图：这意味着JSON的数据格式只有中间的部分, string,number, array, object, 以及null

例若有以下 ＪＳＯＮ数据：

 

{

   "first" : 1,

   "second": 35,

   "third" : 10034,

   "fourth": 10000

}

 

能够以下定义这个模型

 

 

<span style="color:rgb(166,19,144)"></span>

@interface NumbersModel:JSONModel

 

@property (assign,nonatomic) short first;

@property (assign,nonatomic) double second;

@property (strong,nonatomic) NSNumber* third;

@property (strong,nonatomic) NSString* fourth;

 

@end

注：JSON数据中， first为1,second为35, 可是它们却能够自动被转换成short， double类型。 对于10034, 以及10000会自动转换为NSNumber以及NSString。 这些都是JSONModel会自动进行的。 神奇吧！

 

 

5. 内嵌的数据转换， 在JSONValueTransformer类中，有各类内嵌的转换支持。以下面

 

{

    "purchaseDate" : "2012-11-26T10:00:01+02:00",

    "blogURL" : "http://www.touch-code-magazine.com"

}

 

分别是一个 日期类型，以及一个URL类型。

 

@interface SmartModel: JSONModel

 

@property (strong, nonatomic) NSDate* purchaseDate;

@property (strong, nonatomic) NSURL* blogUrl;

 

@end

 

<span style="color:rgb(166,19,144)"></span>

用上面这个模型，不须要其它代码，便可以获得想要的转换 。

 

这个JSONValueTransformer类中有以下支持的转换

 

NSMutableString <-> NSString

 

NSMutableArray <-> NSArray

NS(Mutable)Array <- JSONModelArray

NSMutableDictionary <-> NSDictionary

NSSet <-> NSArray

BOOL <-> number/string

string <-> number

string <-> url

string <-> time zone

string <-> date

number <-> date

 

6. 自定义数据转换， 显然上面的内嵌转换有时不能知足咱们的须要，因此咱们须要以下的自定义转换。

你须要作的就是自定义一个JSONValueTransformer的类别文件，以下：

 

@interface JSONValueTransformer(UIColor)

 

-(UIColor*)UIColorFromNSString:(NSString*)string;

-(id)JSONObjectFromUIColor:(UIColor*)color;

 

@end

 

 

而后再进行实现便可。

 

注意上面的命名是采用：

 

-(YourPropertyClass*)YourPropertyClassFromJSONObjectClass:(JSONObjectClass*)name;

 

 

例如：

 

-(UIColor*)UIColorFromNSString:(NSString*)string;

 

而要把这个类型转换为JSON，则像这样便可：（注下面这个id，能够修改也能够不用修改为NSString，由于必定知道这是一个nsstirng.  heqin:这里其实也可能会是其它类的，应该是根据特定状况来特定判断。）

 

-(id)JSONObjectFromYourPropertyClass:(YourPropertyClass*)color;

 

 

以下是另外一个例子：

@implementation JSONValueTransformer (CustomTransformer)

 

- (NSDate *)NSDateFromNSString:(NSString*)string {

    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];

    [formatter setDateFormat:APIDateFormat];

    return [formatter dateFromString:string];

}

 

- (NSString *)JSONObjectFromNSDate:(NSDate *)date {

    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];

    [formatter setDateFormat:APIDateFormat];

    return [formatter stringFromDate:date];

}

 

@end

 

 

 

7. 层级嵌套。

 

{

    "idImage": 1,

    "name": "house.jpg",

    "copyright": {"author":"Marin Todorov", "year":2012}

}

 

能够先定义以下的模型

@interface CopyModel: JSONModel

 

@property (strong, nonatomic) NSString* author;

@property (assign, nonatomic) int year;

 

@end

 

而后再定义模型：

#import "CopyModel.h"

@interface ImageModel: JSONModel

 

@property (assign, nonatomic) int idImage;

@property (strong, nonatomic) NSString* name;

@property (strong, nonatomic) CopyModel* copyright;

 

@end

而后在你获得的ImageModel后， 就会发现其中的CopyModel也有数据了。 

 

若是你想要一个数组的模型属性，以下便可。

 

@property (strong, nonatomic) NSArray<TweetModel>* tweets;

 

 

 

8. JSONModel转换为Dictioanry, JSONString. 

直接使用JSONModel的方法toDictioanry, 以及toJSONString便可。

 

9. 保存model数据

 

NSDictionary* object = [NSDictionary dictionaryWithContentsOfFile:filePath];

data = [[MyDataModel alloc] initWithDictionary: object];

//保存操做

[[data toDictionary] writeToFile:filePath atomically:YES];

 

 

10. Key mapping， 有时， 获得的数据不是在一个层级，以下：

 

{

    "order_id": 104,

    "order_details" : [

                       {

                           "name": "Product#1",

                           "price": {

                               "usd": 12.95

                           }

                       }

                       ]

}

 

 

其中的order_id与name就不是一个层级，但咱们仍然想在一个model中获得它们的数据。 以下：

 

@interface OrderModel : JSONModel

@property (assign, nonatomic) int id;

@property (assign, nonatomic) float price;

@property (strong, nonatomic) NSString* productName;

@end

 

@implementation OrderModel

 

+(JSONKeyMapper*)keyMapper

{

    return [[JSONKeyMapper alloc] initWithDictionary:@{

                                                       @"order_id": @"id",

                                                       @"order_details.name":@"productName",

                                                       @"order_details.price.usd":@"price" // 这里就采用了KVC的方式来取值，它赋给price属性

                                                       }];

}

 

@end

 

 

 

11. 全局Global key mapping. (使全部的模型都具有)， 我的以为这个并非很是通用，由于若是真是须要全部模型都具有这个keyMapper的转换，则直接继承一个基类就好了。

 

[JSONModel setGlobalKeyMapper:[

                               [JSONKeyMapper alloc] initWithDictionary:@{

                                                                         @"item_id":@"ID",

                                                                          @"item.name":@"itemName"

                                                                          }]

 ];

 

12. 自动把下划线方式的命名转为驼峰命名属性。还有相似的，如大写转为小写的方法：mapperFromUpperCaseToLowerCase

 

{

    "order_id": 104,

    "order_product" : @"Product#1",

    "order_price" : 12.95

}

 

生成的模型

 

@interface OrderModel : JSONModel

 

@property (assign, nonatomic) int orderId;

@property (assign, nonatomic) float orderPrice;

@property (strong, nonatomic) NSString* orderProduct;

 

@end

 

@implementation OrderModel

 

+(JSONKeyMapper*)keyMapper

{

    return [JSONKeyMapper mapperFromUnderscoreCaseToCamelCase];

}

 

@end

 

13. 可选属性，建议尽可能使用这种方式来避免异常。

 

{

    "id": "123",

    "name": null,

    "price": 12.95

}

 

 

生成的模型以下：

 

@interface ProductModel : JSONModel

@property (assign, nonatomic) int id;

@property (strong, nonatomic) NSString<Optional>* name;

@property (assign, nonatomic) float price;

@property (strong, nonatomic) NSNumber<Optional>* uuid;

@end

 

@implementation ProductModel

@end

经过上面的optional的方式， 咱们能够给这个类添加一个isSuccess方法，该方法中判断name和uuid是否存在来决定是否从服务器成功取数据。 而不是把这两个属性设置为required，能够有效避免异常。

 

 

14. Ignore属性， 会使得解析时会彻底忽略它。 通常状况下，忽略的属性主要用在该值不从服务器获取，而是经过后面的代码进行设置。

 

{

    "id": "123",

    "name": null

}

 

模型为：

 

@interface ProductModel : JSONModel

@property (assign, nonatomic) int id;

@property (strong, nonatomic) NSString<Ignore>* customProperty;

@end

 

@implementation ProductModel

@end

 

能够用下面方法，使当前类的所有属性都为可选，官网上说尽可能避免这样的使用， （我的以为官网的意思是指，尽可能避免用来面方法来指定全部的属性为可选，即便要所有属性为可选，也尽可能是在每一个属性那里标注为Optional）

 

@implementation ProductModel

+(BOOL)propertyIsOptional:(NSString*)propertyName

{

    return YES;

}

@end

 

15. 延迟加载， 这种比较推荐，能够减小在网络读取时的性能消耗：关键字为： ConvertOnDemand

 

{

    "order_id": 104,

    "total_price": 103.45,

    "products" : [

                  {

                      "id": "123",

                      "name": "Product #1",

                      "price": 12.95

                  },

                  {

                      "id": "137",

                      "name": "Product #2",

                      "price": 82.95

                  }

                  ]

}

 

使用模型：

 

@protocol ProductModel

@end

 

@interface ProductModel : JSONModel

@property (assign, nonatomic) int id;

@property (strong, nonatomic) NSString* name;

@property (assign, nonatomic) float price;

@end

 

@implementation ProductModel

@end

 

@interface OrderModel : JSONModel

@property (assign, nonatomic) int order_id;

@property (assign, nonatomic) float total_price;

@property (strong, nonatomic) NSArray<ProductModel, ConvertOnDemand>* products;

@end

 

@implementation OrderModel

@end

 

16. 使用JSONHttpClient进行请求。 

 

//add extra headers

[[JSONHTTPClient requestHeaders] setValue:@"MySecret" forKey:@"AuthorizationToken"];

 

//make post, get requests

[JSONHTTPClient postJSONFromURLWithString:@"http://mydomain.com/api"

                                   params:@{@"postParam1":@"value1"}

                               completion:^(id json, JSONModelError *err) {

                                   

                                   //check err, process json ...

                                   

                               }];

 

好了， 因此的JSONModel的使用方法都已经在这里了， 综合了官网的使用方法