Unirest for Objective-C 技术文档

1. 安装指南

Unirest for Objective-C 是一个轻量级的 HTTP 库，支持多种请求方式。以下是安装 Unirest for Objective-C 的步骤：

• 手动安装：从 GitHub 下载 Unirest for Objective-C 库的源码，将下载的文件夹导入到你的项目中。

• 使用 CocoaPods 安装：

  1. 在项目目录中创建一个 Podfile 文件。

  2. 编辑 Podfile 文件，添加以下内容：

     platform :ios, '5.0'
     pod 'Unirest', '~> 1.1.4'
     

  3. 执行以下命令安装依赖：

     pod install
     

  4. 确保打开的是 Xcode 的 workspace 而不是项目文件。

• 启用 ARC：Unirest-Obj-C 库需要你的 Xcode 项目启用 ARC。在 Xcode 项目或目标的构建设置中，选择 Objective-C Automatic Reference Counting 选项。

2. 项目使用说明

Unirest for Objective-C 支持多种 HTTP 请求方法，包括 GET、POST、PUT、PATCH 和 DELETE。以下是创建请求的基本步骤：

NSDictionary* headers = @{@"accept": @"application/json"};
NSDictionary* parameters = @{@"parameter": @"value", @"foo": @"bar"};

UNIHTTPJsonResponse *response = [[UNIRest post:^(UNISimpleRequest *request) {
  [request setUrl:@"http://httpbin.org/post"];
  [request setHeaders:headers];
  [request setParameters:parameters];
}] asJson];

Unirest for Objective-C 同样支持异步请求，允许你的应用在后台获取或更新数据时保持响应。

3. 项目 API 使用文档

Unirest for Objective-C 提供了一系列的方法来创建不同类型的 HTTP 请求。以下是部分方法的列表：

+(UNIHTTPRequest*) get:(void (^)(UNISimpleRequestBlock*)) config;
+(UNIHTTPRequestWithBody*) post:(void (^)(UNISimpleRequestBlock*)) config;
+(UNIHTTPRequestWithBody*) postEntity:(void (^)(UNIBodyRequestBlock*)) config;
// ... 更多方法

每个方法都接受一个配置块，用于设置请求的 URL、头部和参数/主体。以下是执行请求的一些示例：

• 同步请求：

  UNIHTTPJsonResponse *response = [[UNIRest post:^(UNISimpleRequest *request) {
    [request setUrl:@"http://httpbin.org/post"];
    [request setHeaders:headers];
    [request setParameters:parameters];
  }] asJson];
  

• 异步请求：

  [[UNIRest post:^(UNISimpleRequest *request) {
    [request setUrl:@"http://httpbin.org/post"];
    [request setHeaders:headers];
    [request setParameters:parameters];
  }] asJsonAsync:^(UNIHTTPJsonResponse* response, NSError *error) {
    // 异步回调
  }];
  

• 取消异步请求：

  UNIUrlConnection *asyncConnection = [[UNIRest get:^(UNISimpleRequest *request) {
    [request setUrl:@"http://httpbin.org/get"];
  }] asJsonAsync:^(UNIHTTPJsonResponse *response, NSError *error) {
    // Do something
  }];
  
  [asyncConnection cancel]; // 取消请求
  

4. 项目安装方式

请参考上文中的“安装指南”部分，了解如何通过手动下载或使用 CocoaPods 安装 Unirest for Objective-C 库。