1. 命名自動匹配
a. Model屬性名和服務(wù)器返回數(shù)據(jù)字段一致
{
@"id":"123",
@"name":"巧克力",
@"price":"6.66"
}
@interface ProductModel : BaseModel
@property (nonatomic, strong) NSString *id;
@property (nonatomic, strong) NSString *name;
@property (nonatomic, assign) float price;
@end
2. Model關(guān)聯(lián)（model含有其它model）
a. Model屬性名和服務(wù)器返回數(shù)據(jù)一致；
b. 關(guān)聯(lián)其它Model的屬性需要指定自身類型(例如:ProductModel *)
{
“order_id”:104,
“total_price”:110,
“product”: {
“id”:”123”,
“name”:”productName”,
“price”:”110”,
}
}
@interface OrderModel : BaseModel
@property (nonatomic, strong) NSString *order_id;
@property (nonatomic, assign) float total_price;
@property (nonatomic, strong) ProductModel *product;
@end
3. Model集合（Model含有其它model的集合）
a. NSArry后的就<>中包含一個協(xié)議,使用JSONModel必須實現(xiàn)這個協(xié)議!
b. 層級嵌套瓢棒，Model中包含其他Model集合,必須實現(xiàn)該協(xié)議
c. 包含其他Model集合的屬性需要指定層級類型和自身類型(例如：NSArray<ProductModel> *)
@protocol ProductModel
@end
@interface OrderModel : JSONModel
@property (nonatomic, strong) NSString *order_id;
@property (nonatomic, assign) float total_price;
@property (nonatomic, strong) NSArray<ProductModel> *products;
@end
4. 鍵映射
a. 在一個Model中獲取服務(wù)器返回數(shù)據(jù)不同層級的數(shù)據(jù);
b. 例如:order_id和name不在同一層級;
c. 采用KVC的方式來取值,并賦值給Model屬性(order_details.name ---> productName order_details.price.usd ---> price);
{
"order_id": 104,
"order_details" : [
{
"name": "name_#1",
"price": {
"usd": 12.95
}
}
]
}
@interface OrderModel : BaseModel
@property (nonatomic, strong) NSString *id;
@property (nonatomic, assign) float price;
@property (nonatomic, strong) NSString *productName;
@end
@implementation OrderModel
+ (JSONKeyMapper *)keyMapper
{
return [[JSONKeyMapper alloc] initWithDictionary:@{
@"order_id": @"id",
@"order_details.name": @"productName", @"order_details.price.usd": @"price"}];
}
@end
d．全局Global key mapping. (使所有的模型都具備)
JSONKeyMapper *keyMapper = [[JSONKeyMapper alloc] initWithDictionary:@{@"id":@"modelId"}];
[BaseModel setGlobalKeyMapper:keyMapper];
5. 設(shè)置下劃線自動轉(zhuǎn)駝峰
a. 自定義把下劃線字段解析為駝峰命名屬性
b. 場景:服務(wù)器數(shù)據(jù)返回下劃線命名字段可為Model中以駝峰命名的屬性相應(yīng)的賦值
c. mapperFromUpperCaseToLowerCase 大寫轉(zhuǎn)小寫
{
"order_id": 104,
"order_product" : @"Product#1",
"order_price" : 12.95
}
@interface OrderModel : BaseModel
@property (nonatomic, strong) NSString *orderId;
@property (nonatomic, assign) float orderPrice;
@property (nonatomic, strong) NSString *orderProduct;
@end
@implementation OrderModel
+ (JSONKeyMapper *)keyMapper
{
return [JSONKeyMapper mapperFromUnderscoreCaseToCamelCase];
}
@end
6. 可選屬性（屬性值可以為空或null）
a. 某些屬性值可以為空；
b. 防止由于服務(wù)器返回數(shù)據(jù)為空導(dǎo)致JSONModel異常（程序崩潰）脓杉；
eg: @property (nonatomic, strong) NSString<Optional> *urlString;
7. 忽略屬性（屬性值可以完全忽略）
a. 解析時完全忽略它；
b. 場景：該屬性不需要從服務(wù)器數(shù)據(jù)中獲取旦签；
eg: @property (nonatomic, strong) NSString<Ignore> *urlString;
8. 設(shè)置所有屬性可選（所有屬性值可以為空）
a. Model 的所有屬性值可以為空破托；
b. 防止由于服務(wù)器數(shù)據(jù)返回空導(dǎo)致JSONModel異常（程序崩潰）肪跋；
c. 官方建議盡量避免使用該方法(即使要全部屬性為可選，也盡量是在每個屬性那里標注為Optional)土砂；
eg:
@implementation HomeHotModel
+ (BOOL)propertyIsOptional:(NSString *)propertyName
{
return YES;
}
@end
9. 將Model導(dǎo)出字典或JSON字符串
a. 快速導(dǎo)出Model中所有屬性和屬性值州既；
eg:
HomeHotModel *model = [[HomeHotModel alloc] initWithString:jsonString error:nil];
//以字典形式導(dǎo)出
NSDictionary *dict = [model toDictionary];
//以字符串形式導(dǎo)出
NSString *string = [model toJSONString];
10. 自定義數(shù)據(jù)處理(JSON數(shù)據(jù)格式:string, number, array, object, 以及null)
a. 添加NSDate轉(zhuǎn)換:根據(jù)后臺返回時間戳格式進行相應(yīng)處理（eg：UIColor）；
b. 場景:內(nèi)嵌轉(zhuǎn)換,不能滿足需求,需要自定義萝映；
c. JSONModel支持類型如下圖：
eg:
#import "JSONValueTransformer+CustomTransformer.h"
@implementation JSONValueTransformer (CustomTransformer)
//時間戳轉(zhuǎn)NSDate
- (NSDate *)NSDateFromNSString:(NSString *)string
{
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setDateFormat:@"yyyy-MM-dd"];
NSDate *date = [formatter dateFromString:string];
return date;
}
//NSDate轉(zhuǎn)時間戳
- (NSString *)JSONObjectFromNSDate:(NSDate *)date
{
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setDateFormat:@"yyyy-MM-dd"];
NSString *dateStr = [formatter stringFromDate:date];
return dateStr;
}
@end
11. 延遲加載吴叶， 這種比較推薦，可以減少在網(wǎng)絡(luò)讀取時的性能消耗,關(guān)鍵字為： 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
//產(chǎn)品Model
@interface ProductModel : JSONModel
@property (nonatomic, strong) NSString *id;
@property (nonatomic, strong) NSString *name;
@property (nonatomic, assign) float price;
@end
//訂單Model
@interface OrderModel : JSONModel
@property (nonatomic, strong) NSString *order_id;
@property (nonatomic, assign) float total_price;
@property (nonatomic, strong) NSArray<ProductModel, ConvertOnDemand> *products;
@end
12. 模型的批處理序臂，即一次可以處理一批模型
NSArray *models = [OrderModel arrayOfObjectsFromDictionaries:jsonDatas error:nil];
