浅谈使用RestKit将服务器的Json直接映射为本地对象

RestKit是一个主要用于iOS上网络通信的开源框架，除了发送请求与接受响应这些基本功能外，还附带coredata，以及将远程JSON映射为本地对象的功能。目前版本0.9.3，coredata还不是很稳定，他的coredata的demo页面在4.3.3实机下直接导致程序crash，但是其JSON映射为本地对象的功能是十分强大的。

首先，RestKit要求我们在客户端定义一个Model类，用于存储数据和处理业务逻辑。远程JSON中各键将直接映射为Model中各成员变量。对应每一个模型都要定义一个对应的Model类，这是强制的。

强制定义模型带来的好处是我们只需要写一次字典中的key，不再会因为字典的key拼错导致程序crash了。

RestKit使用起来省时省力，但是思维方式和ASIHTTP差异不小，以下举一例说明。

1、

假设服务器上的JSON数据如下：

{ "id": 1234, "name": "Personal Checking", "balance": 5013.26, "transactions": [ {"id": 1, "payee": "Joe Blow", "amount": 50.16}, {"id": 2, "payee": "Grocery Store", "amount": 200.15}, {"id": 3, "payee": "John Doe", "amount": 325.00}, {"id": 4, "payee": "Grocery Store", "amount": 25.15}] }

 

我们用来存储此JSON的对象的类名为SimpleAccount，其中包含六个成员：

_accountID用来对应JSON的id；

_name对应JSON的name；

_balance对应JSON的balance；

_transactionCount对应JSON的transactions数组中元素的数量；

_averageTransactionAmount对应JSON里transactions各元素的amount值的平均数；

_distinctPayees是将JSON里transactions中各元素的payee的值取出来后拼接而成的数组。

 

首先在Model的.h里定义好我们的数据成员，在.m里写好synthesize：

@interface SimpleAccount : NSObject { NSNumber* _accountID; NSString* _name; NSNumber* _balance; NSNumber* _transactionsCount; NSNumber* _averageTransactionAmount; NSArray*  _distinctPayees; } @property (nonatomic, retain) NSNumber* accountID; @property (nonatomic, retain) NSString* name; @property (nonatomic, retain) NSNumber* balance; @property (nonatomic, retain) NSNumber* transactionsCount; @property (nonatomic, retain) NSNumber* averageTransactionAmount; @property (nonatomic, retain) NSArray*  distinctPayees; @end @implementation SimpleAccount @synthesize accountID = _accountID; @synthesize name = _name; @synthesize balance = _balance; @synthesize transactionsCount = _transactionsCount; @synthesize averageTransactionAmount = _averageTransactionAmount; @synthesize distinctPayees = _distinctPayees; @end

2、

在恰当的时机（比如viewDidAppear中）做JSON键到Model成员变量的映射，然后开始请求数据。

@”id”,@”accountID”,把本Model中的accountID属性映射为JSON的id键对应的值；name和balance属性同理。

@”transactions.@count”,@transactionsCount”,取JSON中transactions数组的元素数。

@”[e-mail]”,@averageTransactionAmount”,取JSON中transactions的各元素的amount的值的平均数。

@”[e-mail]”,@”distinctPayees”,将JSON里transactions中各元素的payee的值取出来后拼接而成的数组。

@”[e-mail]”这种写法比较诡异，可以理解成调用transactions对象的avg方法，传入参数是amount。

代码如下

RKObjectMapping* mapping = [RKObjectMapping mappingForClass:[SimpleAccount class]]; [mapping mapKeyPathsToAttributes: @"id", @"accountID", @"name", @"name", @"balance", @"balance", @"transactions.@count", @"transactionsCount", @"[e-mail]", @"averageTransactionAmount", @"[e-mail]", @"distinctPayees", nil];

3、

定义好映射之后，就可以开始向服务器请求数据了。

[RKObjectManager sharedManager]返回一个单件的RKObjectManager。在初始化时向里面存入服务器的URL；

loadObjectResourcePath指定需要请求的JSON数据在服务器中的相对路径（服务器地址已经储存在RKObjectManage里，所以无需在此指定）；

objectClass指定映射成的对象的类；

delegate指定接受回调的对象，在请求完成时，此对象的- (void)objectLoader:(RKObjectLoader*)objectLoader didLoadObjects:(NSArray*)objects会被调用。

- (void)workWithKVC { [[RKObjectManager sharedManager] loadObjectsAtResourcePath:@"/accounts.json" objectClass:[SimpleAccount class] delegate:self]; }

4、

最后是回调方法，若收到的JSON根为数组，则返回数组。根不是数组，则返回一个count为1的数组，所以回调收到的objects是NSArray*类型的。

- (void)objectLoader:(RKObjectLoader*)objectLoader didLoadObjects:(NSArray*)objects { SimpleAccount* account = [objects objectAtIndex:0]; // Will output "The count is 4" NSLog(@"The count is %@", [account transactionsCount]); // Will output "The average transaction amount is 150.115" NSLog(@"The average transaction amount is %@", [account averageTransactionAmount]); // Will output "The distinct list of payees is: Joe Blow, Grocery Store, John Doe" NSLog(@"The distinct list of payees is: %@", [[account distinctPayees] componentsJoinedByString:@", "]); }

参考资料http://mobile.tutsplus.com/tutorials/iphone/advanced-restkit-development_iphone-sdk/

以上

–OpenThread