1. mj_keyValues
將模型轉化為字典。
Person *person = [[Person alloc] init];
person.name = @"John";
person.age = 22;
NSDictionary *dict = [person mj_keyValues];
2. mj_objectWithKeyValues
將字典轉化為模型
NSDictionary *dict = @{@"name":@"John", @"age": @22};
Person *person = [Person mj_objectWithKeyValues:dict];
3. mj_keyValuesArrayWithObjectArray
將數組里的模型轉化為字典數組。
NSArray *persons = @[person1, person2];
NSArray *dictArray = [Person mj_keyValuesArrayWithObjectArray:persons];
4. mj_objectArrayWithKeyValuesArray
將數組里的字典轉化為模型數組。
NSArray *dictArray = @[@{@"name":@"John", @"age": @22}, @{@"name":@"Jane", @"age": @20}];
NSArray *persons = [Person mj_objectArrayWithKeyValuesArray:dictArray];
5. mj_replacedKeyFromPropertyName
屬性名和字典名映射的方法，如果模型中的屬性名和字典的key不一樣，你可以使用這個方法來映射。
@implementation Person
+ (NSDictionary *)mj_replacedKeyFromPropertyName {
return @{@"personId" : @"id"}; // 將模型中的personId對應到字典中的id
return @{@"doge" : [Doge class]};
}
@end
6. mj_ignoredPropertyNames
用于忽略模型中的某些屬性，不進行字典和模型的轉換。
@implementation Person
+ (NSArray *)mj_ignoredPropertyNames {
return @[@"internalId"]; // 忽略'internalId'屬性
}
@end
7. mj_objectClassInArray
在字典數組轉模型數組的時候，告知數組中的字典應轉為何種模型。
@implementation Person
+ (NSDictionary *)mj_objectClassInArray {
return @{@"friends" : [Friend class]}; // 字典數組'friends'對應的模型是'Friend'
}
@end
8. mj_setupNewValueFromOldValue
你可以使用這個方法來處理一些特殊的數據格式，通常在類的+load方法或者+initialize方法中調用。這樣可以保證在模型被使用之前，已經設置好了轉換規則，+initialize方法是Objective-C中的一個特殊方法，當類或其子類接收到第一條消息之前，運行時會自動調用這個方法。也就是說，這個方法是在類的第一個方法被調用之前調用的，我們通常利用這個方法來進行一些初始化設置。
@implementation Person
+ (void)initialize {
[Person mj_setupNewValueFromOldValue:^id(id object, id oldValue, MJProperty *property) {
// 如果屬性是一個數組，并且我們希望將數組中的每個元素轉換為整數
if ([property.name isEqualToString:@"arrayOfStrings"] && [oldValue isKindOfClass:[NSArray class]]) {
NSMutableArray *newArray = [NSMutableArray array];
for (NSString *numberString in oldValue) {
[newArray addObject:@([numberString intValue])];
}
return newArray;
}
// 如果屬性是一個字典，我們想將它轉換為一個自定義對象
else if ([property.name isEqualToString:@"dictionaryProperty"] && [oldValue isKindOfClass:[NSDictionary class]]) {
return [CustomObject mj_objectWithKeyValues:oldValue];
}
// 如果屬性是一個字符串，我們想將它轉換為NSURL
else if ([property.name isEqualToString:@"urlString"] && [oldValue isKindOfClass:[NSString class]]) {
return [NSURL URLWithString:oldValue];
}
// 如果屬性是一個整數，我們想將它轉換為NSNumber
else if ([property.name isEqualToString:@"integerProperty"] && [oldValue isKindOfClass:[NSString class]]) {
return @([oldValue integerValue]);
}
// 如果屬性是一個JSON字符串，我們想將它轉換為字典
else if ([property.name isEqualToString:@"jsonString"] && [oldValue isKindOfClass:[NSString class]]) {
NSData *jsonData = [oldValue dataUsingEncoding:NSUTF8StringEncoding];
NSDictionary *jsonDict = [NSJSONSerialization JSONObjectWithData:jsonData options:NSJSONReadingMutableContainers error:nil];
return jsonDict;
}
return oldValue;
}];
}
@end
9. mj_setupAllowedPropertyNames
這個方法讓你指定哪些模型屬性應該被包含在轉換過程中。
+ (NSArray *)mj_ignoredPropertyNames {
return @[@"internalId"]; // 忽略'internalId'屬性
}
10. copyWithZone
opyWithZone: 是 NSCopying 協議的方法，你需要在你的模型類中實現這個協議才能使用這個方法。MJExtension 提供了 mj_copy 方法，它可以幫助你輕松地實現深拷貝。
首先，你的模型類需要遵循 NSCopying 協議：
@interface CustomObject : NSObject<NSCopying>
@property (nonatomic, copy) NSString *property1;
@property (nonatomic, strong) NSMutableArray *property2;
// other properties
@end
@implementation CustomObject
+ (void)initialize {
[CustomObject mj_setupNewValueFromOldValue:^id(id object, id oldValue, MJProperty *property) {
if ([property.name isEqualToString:@"property2"] && [oldValue isKindOfClass:[NSMutableArray class]]) {
return [oldValue mutableCopy]; // 對可變數組進行深拷貝
}
return oldValue;
}];
}
- (id)copyWithZone:(NSZone *)zone {
return [self mj_copy];
}
@end
在這個例子中，我們假設Person對象有一個friends數組，它是一個NSMutableArray，我們想要對它進行深復制。copyItems:YES表示我們想要復制數組中的每個元素，而不僅僅是引用它們。
