在iOS中，使用AFN进行表单数据上传的网络请求方法详解

最编程 2024-07-20 20:37:43

...

1.四种常见的 POST 提交数据方式对应的content-type取值

1.1application/x-www-form-urlencoded

这应该是最常见的 POST 提交数据的方式了。浏览器的原生 form 表单，如果不设置 enctype 属性，那么最终就会以 application/x-www-form-urlencoded 方式提交数据。请求类似于下面这样（无关的请求头在本文中都省略掉了）：

POST http://www.example.com HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8

title=test&sub%5B%5D=1&sub%5B%5D=2&sub%5B%5D=3
首先，Content-Type 被指定为 application/x-www-form-urlencoded；其次，提交的数据按照 key1=val1&key2=val2 的方式进行编码，key 和 val 都进行了 URL 转码。大部分服务端语言都对这种方式有很好的支持。
很多时候，我们用 Ajax 提交数据时，也是使用这种方式。例如 JQuery 和 QWrap 的 Ajax，Content-Type 默认值都是「application/x-www-form-urlencoded;charset=utf-8」。

multipart/form-data

这又是一个常见的 POST 数据提交的方式。我们使用表单上传文件时，必须让 form 的 enctyped 等于这个值。直接来看一个请求示例：

POST http://www.example.com HTTP/1.1
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryrGKCBY7qhFd3TrwA

------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="text"

title
------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="file"; filename="chrome.png"
Content-Type: image/png

PNG ... content of chrome.png ...
------WebKitFormBoundaryrGKCBY7qhFd3TrwA--
这个例子稍微复杂点。首先生成了一个 boundary 用于分割不同的字段，为了避免与正文内容重复，boundary 很长很复杂。然后 Content-Type 里指明了数据是以 mutipart/form-data 来编码，本次请求的 boundary 是什么内容。消息主体里按照字段个数又分为多个结构类似的部分，每部分都是以 --boundary 开始，紧接着内容描述信息，然后是回车，最后是字段具体内容（文本或二进制）。如果传输的是文件，还要包含文件名和文件类型信息。消息主体最后以 --boundary-- 标示结束。关于 mutipart/form-data 的详细定义，请前往 rfc1867 查看。

这种方式一般用来上传文件，各大服务端语言对它也有着良好的支持。

上面提到的这两种 POST 数据的方式，都是浏览器原生支持的，而且现阶段原生 form 表单也只支持这两种方式。但是随着越来越多的 Web 站点，尤其是 WebApp，全部使用 Ajax 进行数据交互之后，我们完全可以定义新的数据提交方式，给开发带来更多便利。

application/json

application/json 这个 Content-Type 作为响应头大家肯定不陌生。实际上，现在越来越多的人把它作为请求头，用来告诉服务端消息主体是序列化后的 JSON 字符串。由于 JSON 规范的流行，除了低版本 IE 之外的各大浏览器都原生支持 JSON.stringify，服务端语言也都有处理 JSON 的函数，使用 JSON 不会遇上什么麻烦。

JSON 格式支持比键值对复杂得多的结构化数据，这一点也很有用。记得我几年前做一个项目时，需要提交的数据层次非常深，我就是把数据 JSON 序列化之后来提交的。不过当时我是把 JSON 字符串作为 val，仍然放在键值对里，以 x-www-form-urlencoded 方式提交。

Google 的 AngularJS 中的 Ajax 功能，默认就是提交 JSON 字符串。例如下面这段代码：

var data = {'title':'test', 'sub' : [1,2,3]};
$http.post(url, data).success(function(result) {
...
});
最终发送的请求是：

POST http://www.example.com HTTP/1.1
Content-Type: application/json;charset=utf-8

{"title":"test","sub":[1,2,3]}
这种方案，可以方便的提交复杂的结构化数据，特别适合 RESTful 的接口。各大抓包工具如 Chrome 自带的开发者工具、Firebug、Fiddler，都会以树形结构展示 JSON 数据，非常友好。但也有些服务端语言还没有支持这种方式，例如 php 就无法通过 $_POST 对象从上面的请求中获得内容。这时候，需要自己动手处理下：在请求头中 Content-Type 为 application/json 时，从 php://input 里获得原始输入流，再 json_decode 成对象。一些 php 框架已经开始这么做了。

当然 AngularJS 也可以配置为使用 x-www-form-urlencoded 方式提交数据。如有需要，可以参考这篇文章。

text/xml

XML-RPC（XML Remote Procedure Call）。它是一种使用 HTTP 作为传输协议，XML 作为编码方式的远程调用规范。典型的 XML-RPC 请求是这样的：

POST http://www.example.com HTTP/1.1
Content-Type: text/xml

<methodcall>
<methodname>examples.getStateName</methodname>
<params>
<param>
<value><i4>41</i4></value>

</params>

</methodcall>

XML-RPC 协议简单、功能够用，各种语言的实现都有。它的使用也很广泛，如 WordPress 的 XML-RPC Api，搜索引擎的 ping 服务等等。JavaScript 中，也有现成的库支持以这种方式进行数据交互，能很好的支持已有的 XML-RPC 服务。不过，我个人觉得 XML 结构还是过于臃肿，一般场景用 JSON 会更灵活方便。

2.AFN请求相关

2.1.所有的网络请求,均有manager发起

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

2.2. 需要注意的是,默认提交请求的数据是二进制的,返回格式是JSON

1> 如果提交数据是JSON的,需要将请求格式设置为AFJSONRequestSerializer 
2> 如果返回格式不是JSON的,

2.3. 请求格式

 AFHTTPRequestSerializer            二进制格式 
 AFJSONRequestSerializer            JSON 
 AFPropertyListRequestSerializer    PList(是一种特殊的XML,解析起来相对容易)

2.4. 返回格式

 AFHTTPResponseSerializer           二进制格式 
 AFJSONResponseSerializer           JSON 
 AFXMLParserResponseSerializer      XML,只能返回XMLParser,还需要自己通过代理方法解析 
 AFXMLDocumentResponseSerializer (Mac OS X) 
 AFPropertyListResponseSerializer   PList 
 AFImageResponseSerializer          Image 
 AFCompoundResponseSerializer       组合

3.AFN发起请求

#pragma mark imagePickControllerDelegate
- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary<NSString *,id> *)info {
   
   [picker dismissViewControllerAnimated:YES completion:^{}];
   
   UIImage *image = [info objectForKey:UIImagePickerControllerEditedImage];
   NSString *access_toke = [[NSUserDefaults standardUserDefaults] objectForKey:@"user_access_token"];
   NSData *imageData = UIImageJPEGRepresentation(image, 0.6);
   CGFloat quality = 1.0;
   // 限定上传图片大小为100K
   while (imageData.length > 10 * 1024 && quality > 0.2) {
       quality -= 0.1;
       imageData = UIImageJPEGRepresentation(image, quality);
   }
//    NSString *imageBase64Str = [imageData utf8String];
   //[NSString stringWithUTF8String:[imageData bytes]];
   //[[NSString alloc]initWithData:imageData encoding:NSUTF8StringEncoding];
   
   
   AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
   manager.requestSerializer.timeoutInterval = 20;
   manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"text/plain", @"multipart/form-data", @"application/json", @"text/html", @"image/jpeg", @"image/png", @"application/octet-stream", @"text/json", nil];
   
   NSDictionary *dict = @{@"token":access_toke};
   
   NSString *url = @"http://api.cwaipo.cn/users/uploadUserImage";
   
   [manager POST:url parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {
       [formData appendPartWithFileData:imageData name:@"userImg" fileName:@"1.jpg" mimeType:@"image/jpg"];
   } progress:^(NSProgress * _Nonnull uploadProgress) {
       
   } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
       [NSNotificationCenter.defaultCenter postNotificationName:@"userUploadAvatarSuccess" object:nil];
       NSLog(@"上传成功%@",responseObject);
   } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
       NSLog(@"上传失败");
   }];
}

4.相关资料

4.1 AFN框架使用整理

4.2 AFNetwork 作用和用法详解

4.3 iOS里实现multipart/form-data格式上传文件

4.4 AFNetworking 详解以及通过 POST 方式上传数据

4.5 iOS之网络请求之AFN表单上传之form-data

4.6 AFNetworking 详解以及通过 POST 方式上传数据

上一篇：深入理解HTML基础002：详析form表单的奥秘

下一篇： Ant Design里的Form组件详解(第一篇)