【iOS】JSONModel及其使用

JSONModel的基本介绍

JSONModel是json转model的第三方开源库。当我们向服务器发送一个请求之后，通过JSONModel把数据转成model中的属性就可以很方便的供给我们使用了。

JSONModel的安装

方法同安装Masonry，具体详见

在这里再简单叙述一次：

1. 打开终端， cd到文件目录（可将文件直接拖进去）
2. 终端输入 touch PodFile创建新文件
3. 打开PodFile文件并将其内容设为

platform:ios,‘9.0’
target ‘(文件名称)’ do
pod ‘JSONModel’
end

4. 保存并关闭文件，终端输入pod install

等待安装完成。

JSONModel的使用

基本使用

给出一个接口，我们开始网络请求：

https://news-at.zhihu.com/api/4/news/latest

打开我们已经导入JSONModel库的项目，创建一个Model类。

• 这个类是继承于JSONModel类的
• 将请求的JSON数据在Model.h中声明为属性

#import "JSONModel.h"



@interface Model : JSONModel

@property (nonatomic, assign) int status;
@property (nonatomic, copy) NSString* msg;
@property (nonatomic, copy) NSString* latest;



@end

注意这里的msg不能擅自写成message，否则请求到的数据不能按照键-值对来匹配，就不能让我们的属性接收到请求来的信息

然后是网络请求数据：

#import "ViewController.h"
#import "Model.h"

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.

    NSString* json = @"http://news-at.zhihu.com/api/4/version/ios/2.3.0";

    json = [json stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];

    NSURL* testURL = [NSURL URLWithString:json];

    NSURLRequest* testRequest = [NSURLRequest requestWithURL:testURL];
    NSURLSession* testSession = [NSURLSession sharedSession];
    NSURLSessionDataTask* testDataTask = [testSession dataTaskWithRequest:testRequest completionHandler:^(NSData* _Nullable data, NSURLResponse* _Nullable response, NSError* _Nullable error) {
       //以及自行创建好的类
        Model* country = [[Model alloc]initWithData:data error:nil];
        NSLog(@"%@", country);


    }];
    //任务启动
    [testDataTask resume];
    
 
    
}

请求到的数据如下：

如果传过来的JSON合法，你所定义的所有的属性都会与该JSON的值想对应，甚至JSONModel会尝试去转换数据为你期望的类型 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

集合、嵌套类型数据：

应对集合、嵌套类型数据，我们可以在一个文件里写多个类，然后将类转为数组

在ModelA.h

@protocol StoriesModel
@end

@protocol  Top_StoriesModel
@end



#import "JSONModel.h"

NS_ASSUME_NONNULL_BEGIN



@interface ModelA : JSONModel
@property (nonatomic, copy) NSString *date;
//将另外两个类转为数组
@property (nonatomic, copy) NSArray<StoriesModel>* stories;
@property (nonatomic, copy) NSArray<Top_StoriesModel>* top_stories;
@end

@interface StoriesModel : JSONModel
@property (nonatomic, copy) NSString* title;
@property (nonatomic, copy) NSString* ga_prefix;
@property (nonatomic, copy) NSString* type;
@property (nonatomic, copy) NSString* image_hue;
@property (nonatomic, copy) NSString* id;
@end

@interface Top_StoriesModel : JSONModel
@property (nonatomic, copy) NSString* title;
@property (nonatomic, copy) NSString* ga_prefix;
@property (nonatomic, copy) NSString* type;
@property (nonatomic, copy) NSString* image_hue;
@property (nonatomic, copy) NSString* id;
@end








NS_ASSUME_NONNULL_END

在Model A.m中完成类的实现

#import "ModelA.h"



@implementation ModelA
+ (BOOL)propertyIsOptional:(NSString *)propertyName {
    return YES;
}
@end

@implementation Top_StoriesModel

+ (BOOL) propertyIsOptional:(NSString *)propertyName {
    return YES;
}

@end

@implementation StoriesModel

+ (BOOL) propertyIsOptional:(NSString *)propertyName {
    return YES;
}

@end

注意：

• 方法+(BOOL)propertyIsOptional:(NSString *)propertyName 的作用是不想因为服务器的某个值没有返回(nil)就使程序崩溃， 我们会加关键字Optional，如果不想每一条属性都添加，我们也可以在.m文件中重写方法 这个就是重写了方法

比如第一个API的msg如果版本已经最新了，那么msg就没有返回值 如果不写就会造成程序的崩溃

• iOS9引入了新特性：App Transport Security (ATS)，新特性要求App内访问的网络必须使用HTTPS协议。
  但是现在公司的项目使用的是HTTP协议，使用私有加密方式保证数据安全。现在也不能马上改成HTTPS协议传输。

解决方法就是在info中添加方法：

• 获取镶嵌数组中的元素

直接用点语法会报错：

我们可以再声明一下需要的被嵌套的model，然后给其赋值，就可以直接调用了

@property (nonatomic, copy) StoriesModel * stories;

self->_stories = country.stories[0];
NSLog(@"%@", self->_stories.title);

• key设置全局键映射（应用于所有Model）实现于.m文件，用于给变量换名字

+ (JSOMKeyMapper) keyMapper {
	return [[JSON alloc] initwithModelToJSONDictionary:@{
														@"ID":@"id",
														@"imageStr":@"image"
														}];
}