RestKit — описание одной из возможностей

Привет Хабр!

Предыстория



Давно заметил, что на хабре нет ни одной статьи о такой замечательной библиотеке как RestKit, написанной на Objective-C и предоставляющая прекрасные возможности для работы с RESTful-сервисами. Поэтому и пришла идея опубликовать краткое описание некоторых возможностей библиотеки, тем более что уже вышла совершенно новая её версия использующая за основу AFNetworking библиотеку для работы с HTTP. В статье описывается одна из важнейших для меня функциональностей — маппинг объектов.

Процесс установки библиотеки подробно описан на на странице проекта на GitHub'е. Так же библиотека доступка в Pod'ах:
$ cat Podfile
platform :ios, '5.0'

pod 'RestKit', '~> 0.20.0pre'

Приступим к делу


Обойдёмся без теории, ибо статья всё-таки для тех, кто понимает, хотя бы, что такое REST и зачем он нужен.

Инициализация


При старте приложения необходимо установить начальные параметры для синглтонов работающих с HTTP и занимающихся мапингом объектов:
NSURL *baseURL = [NSURL URLWithString:kServerHost];
AFHTTPClient* client = [[AFHTTPClient alloc] initWithBaseURL:baseURL];
RKObjectManager *objectManager = [[RKObjectManager alloc] initWithHTTPClient:client];
[RKObjectManager setSharedManager:objectManager];


Маппинг объектов

Для начала нам необходимо описать класс в котором будут храниться данные (куда будут мапиться):
@interface TaskListSuccess : NSObject

@property(nonatomic, copy) NSString *created_at;
@property(nonatomic, copy) NSString *updated_at;
@property(nonatomic, copy) NSString *user_id;
@property(nonatomic, copy) NSString *ID;
@property(nonatomic, copy) NSString *title;
@property(nonatomic, copy) NSString *time;

@end

Далее необходимо добавить правило для ответов по каким запросам будет использоваться данный класс и по какому правилу мапятся объекты:
RKObjectMapping* successAuthResult = [RKObjectMapping mappingForClass:[TaskListSuccess class]];
[successAuthResult addAttributeMappingsFromDictionary:@{ 
     // задаются ассоциации полей JSON(XML) к параметрам класса
     @"created_at": @"created_at",
     @"updated_at": @"updated_at",
     @"user_id": @"user_id",
     @"id": @"ID",
     @"title": @"title",
     @"time": @"time",
}];
 
// Набор статус-кодов, при которых запрос является успешно выполненым.
NSIndexSet *successStatusCodes = RKStatusCodeIndexSetForClass(RKStatusCodeClassSuccessful); 
    
RKResponseDescriptor 
           *responseDescriptor = [RKResponseDescriptor responseDescriptorWithMapping:successAuthResult
                                                                      pathPattern:@"tasks"
                                                                            keyPath:nil
                                                                     statusCodes:successStatusCodes];
[[RKObjectManager sharedManager] addResponseDescriptor:responseDescriptor];

Параметр pathPattern класса RKResponseDescriptor описывает шаблон пути, для маппинга которого будет использоваться наш класс.
Далее необходимо отправить сам запрос:
RKObjectManager *objectManager = [RKObjectManager sharedManager];

[objectManager getObject:nil 
                   path:@"tasks" 
                   parameters:nil 
                   success:^(RKObjectRequestOperation *operation, RKMappingResult *mappingResult) {
       //Тут происходит обработка данных
       ...
} failure:^(RKObjectRequestOperation *operation, NSError *error) {
       //Тут необходимо обрабатывать ошибки
       ...
}];

Это простейший запрос, иногда нам необходимо больше гибкости в настройке запроса, тогда делать можно, например, следующим образом:
RKObjectManager *objectManager = [RKObjectManager sharedManager];
NSMutableURLRequest *urlRequest = [objectManager requestWithObject:nil 
                                  method:RKRequestMethodPOST 
                                  path:@"tasks"
                                  parameters:nil];
[urlRequest setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
    
RKObjectRequestOperation *operation = [objectManager objectRequestOperationWithRequest:urlRequest 
                      success:^(RKObjectRequestOperation *operation, RKMappingResult *mappingResult) {
       //Тут происходит обработка данных
       ...
} failure:^(RKObjectRequestOperation *operation, NSError *error) {
       //Тут необходимо обрабатывать ошибки
       ...
}];
    
[objectManager enqueueObjectRequestOperation:operation];

Объект класса RKObjectRequestOperation содежит все возможные параметры, которые мы можем устанавливать как нам угодно.

Outro


Статья ознакомительная и направлена на то, что бы понять актуально ли описывать эту библиотеку далее, тем более, что есть очень хорошая документация на английском языке. В общем, если данная тема интересует, то можно будет к ней вернуться и описать другие возможности библотеки, а так же рассказать о личных шишках, набитых во время её использования.

Стоит ли описывать библиотеку далее?

Возможности:
  • работа с CoreData
  • работа с многостараничными запросами (пагинация)
  • более сложны маппинг с использование нескольких сущностей в одном запросе
  • и др.


Всего доброго! Мир!
  • +2
  • 12,8k
  • 4
Поделиться публикацией

Комментарии 4

    0
    Стоит дать больше примеров использования библиотеки, возможно в сравнении с теми методами, которые используются в реализациях сейчас большинством разработчиков.

    Мир!
      +1
      Идея хорошая, мне нравится, примеров было бы больше, но пока что непонятно нужно ли оно вообще.
        0
        Конечно нужно. Я использую в большинстве случаем просто AFNetworking, сейчас очень большой проект, много моделей, хочу использовать RestKit по полной, до этого только в небольших проектах использовал, интересно было. Хочу посмотреть как люди реально ей пользуются, может что новое узнаю. Спасибо за статью.
          +1
          Я смотрю по добавленному в избранное — люди добавляют, значит действительно необходимо. Следовательно будет описывать далее. Благодарю за осмысленный комментарий!

    Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.

    Самое читаемое