RestKitMapper 0.1.1

RestKitMapper 0.1.1

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布日期上次发布2015年1月

Ilya Obshadko维护。



  • Ilya Obshadko

概览

RestKitMapper 是围绕 RestKit 的包装器,RestKit 是一个流行的 Objective-C 框架,用于 REST API 访问。其主要目的是隐藏 RestKit 配置复杂度,将 REST API 调用包装在简单直观的方法中。

特性

RestKitMapper 允许您声明性地配置 RestKit 映射。支持的 RestKit 功能包括

  • 属性映射和主键
  • 基于路径的动态映射
  • 对关系的完全支持
  • 请求对象映射
  • 错误响应映射

入门指南

要开始使用 RestKitMapper,您应该完全理解 RestKit 概念(特别是 RestKit 映射)。如果您还没有这样做,请阅读 RestKit 文档。安装很简单

  • 将 RestKitMapper 添加到您的 Podfile 中(如果您还不熟悉 CocoaPods,这是一个开始的好理由)然后运行 pod install
  • 复制并编辑 RestKitMapper 配置文件(示例文件位于 RestKitMapper 项目目录中的 Config/RestKitMapper.plist。将其放置在项目文件层次结构中的任何位置。
  • 包含并初始化 RestKitMapper 和您的应用程序
#include <RestKitMapper/RestKitMapper.h>

- (void)initializeRestKitMapperDefaults
{
  [RKMRestKitMapper configureWithFileName:@"RestKitMapperConfig"
                    serverBaseUrl:@"https://my.server:8080"
                    contextUrl:@"/api/v2"
                    modelName:@"MyModelName"];
}

- (void)callMyRestApiMethod
{
  RKMRestKitMapper *restKitMapper = [RKMRestKitMapper sharedInstance];
  [restKitMapper get: @"/relative_api_url" cached: NO withParams: nil success: ^(id result) {
    NSArray *items = result; // result normally contains NSArray of retrieved entities
    // handle results
    self.tableItems = items;
    [self.tableView reloadData];
  } failure:^(NSError *error) {
    // handle error
    NSLog("REST error: %@", error);
  }];
}

更多信息

作者

Ilya Obshadko