NSURLSession/NSURLConnection的上传文件方法(已做了更新)

最好的学习方法就是 领悟 + 证悟。

此篇文章的理论基础主要是与HTTP网络通信协议相关。为集中精力,可以先把TCP/IP协议这些置之不理,也就是先只关注HTTP的请求和响应的结构。HTTP完整的原理内容就此略过。在此只略提相关内容。文中涉及的设计源码可以通过这里获取 https://github.com/wuqingjian2015/uploadHelper,有意者可以去看看。

 

HTTP是干什么用的呢?

先考虑一下以下应用过程:

  1. 从客户端向服务器端发起一个请求。
  2. 服务器端处理请求
  3. 服务器端发送一个响应。

那么,如果应用上面过程来实现上传文件这个功能,需要做到几方面:

  1. 要上传的文件需要捆绑在这个请求里面。
  2. 服务器端能够理解该请求,作出相关处理:如能提取出文件内容,存放在某一个文件目录下;如能提取当中某些指令,调用相关的指令处理程序。
  3. 服务器端发送一个响应,客户端应该能够理解该响应内容。

HTTP协议就是解决以上这些问题的。它定义了请求体结构和响应体结构。只要客户端或服务端遵守这个标准,它就能与任何遵守这一标准的应用程序通信。

如果再想实地观察一下符合HTTP标准的请求体和响应体“长”什么样,可以用一些抓包工具。我用了Wireshark和Charles。如果你的是网页应用,可以在IE上按F12键调出开发工具窗口的网络Tab。

在这里,我们只关注请求,了解响应StatusCode是200表示正常。

对于请求,因为iOS会自动设置其他内容,如果咱们不设置的话。下面只讨论其中的

  1. 上传到的目标地址
  2. 请求标头中的Content-Type
  3. 以及请求正文的内容

如何设置目标地址?在创建NSURLRequest时,指定URL即可。如,

NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:self.targetURL];
设置目标地址URL

  接下来,我们需要设置Content-Type的值为:multipart/form-data,同时制定boundary的值,该boundary会在设置请求正文时用到。到此为止,我们得到了这样的一些代码:

 1 -(NSURLRequest *)createRequestHeader
 2 
 3 {
 4 
 5     NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:self.targetURL]; //指定目标地址
 6 
 7     //创建http header请求标头内容
 8 
 9     //  Content-Type := multipart/form-data; boundary=---------------827292(任意)
10 
11     //  Content-Length := (文件长度)
12 
13     NSString *contentType = [NSString stringWithFormat:@"multipart/form-data; boundary=%@", self.boundary];
14 
15     [request setValue:contentType forHTTPHeaderField:@"Content-Type"]; //设置Content-Type
16 
17     [request setHTTPMethod:@"post"];//设置Method为POST
18 
19     return request;
20 
21 }
创建请求表头

  下面再来看请求正文怎么设置。在iOS中,由NSURLRequest.HTTPBody属性来指定,其为NSData类型。谨记:这个有固定的格式,该格式必须正确,否则服务器端无法取得正确的内容。而这个问题无法通过抓包工具中体现出来。如下:

格式:

beginBoundary

Content-Disposition: form-data; name="<服务器端需要知道的名字>"; filename="<服务器端这个传上来的文件名>"
Content-Type: application/zip --根据不同的文件类型选择不同的值

<空行> 

<二进制数据>

endBoundary

 

范例:

----KenApp299912318
Content-Disposition: form-data; name="<服务器端需要知道的名字>"; filename="<服务器端这个传上来的文件名>"
Content-Type: application/zip --根据不同的文件类型选择不同的值

<空行>

<二进制数据>

----KenApp299912318--
范例

有代码有真相:

 

 1 -(NSData*)createDataForRequestHTTPBodyForSource
 2 
 3 {
 4 
 5     NSMutableString *bodyHead = [[NSMutableString alloc] init];
 6 
 7     NSMutableData *data = [[NSMutableData alloc] init];
 8 
 9     
10 
11     NSString *fileName = [self.sourceURL lastPathComponent];
12 
13     NSString *name=@"uploadFile";
14 
15     
16 
17     NSData *fileContent = [NSData dataWithContentsOfURL:self.sourceURL];
18 
19     //创建http body请求体内容
20 
21     //  第一行: --827292
22 
23     [bodyHead appendString:self.beginBoundary];
24 
25     // [body appendFormat:@"--------------------"]
26 
27     //  Content-Disposition: form-data; name="uploadFile"; filename="xxxx.ext"
28 
29     [bodyHead appendFormat:@"Content-Disposition: form-data; name=\"%@\"; filename=\"%@\"\r\n",name,fileName];
30 
31     //  Content-Type: application/x-zip-compressed
32 
33     //  (空行)
34 
35     [bodyHead appendFormat:@"Content-Type: application/zip\r\n\r\n"];
36 
37     //  (二进制数据)
38 
39     [data appendData:[bodyHead dataUsingEncoding:NSUTF8StringEncoding]];
40 
41     [data appendData:fileContent];
42 
43     //  最后一行:827292--
44 
45     
46 
47     [data appendData:[self.endBoundary dataUsingEncoding:NSUTF8StringEncoding]];
48 
49     
50 
51     return data;
52 
53 }
范例代码

   到目前为止,咱们知道怎么设置请求标头和请求正文了。怎么用上这些结果呢?在这里,分两种情况

  1. 如果是用NSURLConnection的话, 我们需要在同一个NSURLRequest中设置好这两者。再调用factory method [NSURLConnection connectionWithRequest: delegate:];
  2. 如果是用NSURLSession中uploadTask的话,需要在NSURLRequest中设置请求标头(如下requestWithHeader),同时在NSData中设置请求正文(如下requestHTTPBody)。代码例子如下,其中SSUploadHelper封装了以上提到的处理过程。
/范 例

  SSUploadHelper *uploadHelper = [[SSUploadHelper alloc] initWithTarget:[NSURL URLWithString:@"http://192.168.31.172:5012/ArchFlow/upload"] forSource:self.downloadedLocation];

    NSURLSessionUploadTask *uploadTask = [self.ephemeralSession uploadTaskWithRequest:[uploadHelper requestWithHeader] fromData:[uploadHelper requestHTTPBody] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {

        

        NSLog(@"Got response %@ with error %@.\n", response, error);

        NSLog(@"DATA:\n%@\nEND DATA\n",

              [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);

    }];

    

    [uploadTask resume];

//
View Code

   至此,客户端的设计基本完成了。为了在服务器端看到上传到的文件,咱们需要搭建一个服务器环境了。我个人实现了一个基于Python的REST的微服务器,在处理到ArchFlow/upload的POST请求中,从request中获取文件,并保存到本地目录下。这是我在软件架构时用到的工具服务器,在此基础上作的临时上传文件功能。(我已经上传一个版本到https://github.com/wuqingjian2015/uploadHelper,感兴趣的朋友可以在此基础上摆弄一下。)

//功能测试:

在服务器启动的过程中,执行以上客户端代码,可以看到文件被拷贝到目标目录下。

注意事项:

boundary的格式值得加倍注意,在请求标头中指明的boundary,必须用到请求正文中。

剩下的就是耐心调试了。Good Luck!

 

转载于:https://www.cnblogs.com/Kenwuqingjian/p/5378201.html

你可能感兴趣的:(NSURLSession/NSURLConnection的上传文件方法(已做了更新))