iOS MJExtension 插件實現模型數據轉換

一、MJExtension簡介

MJExtension是一個iOS開發中常用的第三方庫，它可以將JSON格式的數據轉化為OC對象。MJExtension的自定義轉換方法和快速地將OC對象轉為JSON格式的數據。使用MJExtension可以大大減少一些重複性的工作，提高開發效率。

MJExtension可以在github上直接下載，也可以使用CocoaPods進行引入，具體方法可參照官方文檔。下面我們將介紹MJExtension的使用方法。

二、如何使用MJExtension

在使用MJExtension之前，需要對我們需要的OC對象進行擴展。

以MJExtension默認做法舉例，對象擴展代碼示例如下：

#import "Person.h"
#import 

@implementation Person
MJExtensionCodingImplementation 
@end

其中，MJExtensionCodingImplementation就是對象擴展的一部分。在使用過程中，一定要注意，在需要轉換的OC對象中的.h文件中進行對象擴展，否則我們會發現在進行轉換時編譯會報出一些類似「unrecognized selector sent to instance…」這樣的錯誤。

接下來我們來實踐一下如何使用MJExtension。

在實際開發中，我們一般是通過JSON格式的字元串或者字典（NSDictionary）來構建OC對象的。MJExtension針對這兩種情況都提供了相應的API。

1、將JSON格式的字元串轉成OC對象

首先，在.h文件中包含MJExtension.h文件，代碼示例如下：

#import 
#import "Person.h"

現在假設我們已經有一個JSON格式的字元串，我們可以使用下面的代碼將其轉換成OC對象。

NSString *jsonString = @"{\"name\":\"琳琳\",\"age\":26}";
Person *p = [Person mj_objectWithKeyValues:jsonString];

2、將NSDictionary對象轉成OC對象

在進行NSDictionary對象轉換時，我們需要將對象中所有的鍵值對進行提取，並將其轉換成對應的OC對象。可以使用下面的代碼實現：

NSDictionary *dict = @{@"name":@"小明",@"age":@20};
Person *p = [Person mj_objectWithKeyValues:dict];

你可能會發現，在NSDictionary對象轉換中鍵值對的鍵值類型必須是OC對象，如NSString、NSNumber等，否則將會出現錯誤。

三、MJExtension高級特性

1、忽略轉換欄位

有些時候，在轉換OC對象時，我們需要忽略一些對象不需要的欄位，此時可以使用MJExtension提供的 ignoreKeysInCoding 方法。

例如：

+ (NSArray *)mj_ignoredCodingPropertyNames {
    return @[@"address"];
}

此例中，代碼返回一個包含字元串「address」的NSArray，表示在進行對象轉換時忽略「address」欄位。

2、字典和模型的轉換

在經常進行JSON對象轉換時，有時還需要對需要轉換的數據類型進行更進一步的處理。這時，可以使用MJExtension提供的字典和模型的轉換方法。

正如我們所知，在字典和模型轉換時，我們需要書寫一些代碼。在使用MJExtension時，我們可以利用一些設置來避免這種重複性的工作。例如：

+ (NSDictionary *)mj_objectClassInArray {
    return @{
             @"dataList": @"Person"
            };
}

此例中，代碼告訴MJExtension每當它在轉換字典到模型時遇到”dataList”這個欄位，它應該把”dataList”欄位里的數據轉換成名為”Person”的類型。

3、時間戳和時間格式轉換

iOS中經常需要在JSON數據中處理時間戳和字元串。MJExtension為這些工作也提供了比較完善的支持。

1）將模型對象的NSDate類型欄位轉成指定格式的NSString類型。

+ (NSDictionary *)mj_replacedKeyFromPropertyName {
    return @{
             @"dateTime" : @"dt"
            };
}
+ (NSDictionary *)mj_dateFormatters {
    return @{
             @"dateTime" : @"yyyy-MM-dd HH:mm:ss"
            };
}

MJExtension提供了mj_dateFormatters API，可以將NSDate類型的欄位直接轉換成指定格式的NSString類型。以上兩塊代碼告訴MJExtension哪個NSDate欄位應該在何時被按照哪種格式轉換成NSString類型。如這裡所示，如果Person.h文件中存在一個名為「dt」的NSDate欄位，那麼它會被轉換成yyyy-MM-dd HH:mm:ss這樣的格式。

2）將JSON數據中的時間戳直接轉成NSDate對象。

+ (NSDictionary *)mj_replacedKeyFromPropertyName {
    return @{
             @"time" : @"t"
            };
}
+ (NSDictionary *)mj_objectClassInArray {
    return @{
             @"dataList": @"Person"
            };
}
+ (NSDictionary *)mj_dateObjectClassInArray {
    return @{
             @"dataList": [Person class]
            };
}

以上代碼告訴MJExtension，在JSON數據中將名為「t」的時間戳直接轉換成NSDate類型欄位。代碼中的mj_objectClassInArray表示思路同2）。

總結

通過本文的介紹，相信大家已經對MJExtension有了一定的了解。它可以在iOS的開發中有很多的用處，可以大大提高我們的開發效率，減少我們編寫代碼的重複性工作。因此，在開發中使用MJExtension也是非常明智的選擇。