iOS-GET、POST请求方法：NSURLSession篇

╰半夏微凉° 2023-10-17 00:57 10阅读 0赞

![Post\_Danmark500.jpg][Post_Danmark500.jpg]

NSURLConnection，在iOS 9被宣布弃用，本文不使用NSURLConnection进行网络编程，有兴趣的童鞋可以参考：

[iOS开发 GET、POST请求方法（NSURLConnection篇）][iOS_ GET_POST_NSURLConnection]

介绍：NSURLSession，为iOS7中的新网络接口，是在2013年的WWDC上，由Apple提出的NSURLConnection继任者的：NSURLSession。

NSURLSession，与NSURLConnection是并列的，且可以支持后台相关的网络操作的新特性；与NSURLConnection不同的是，NSURLSession把NSURLConnection替换成NSURLSession, NSURLSessionConfiguration，NSURLSessionTask。

NSURLSession一般分别两部操作：第一，通过NSURLSession的实例创建task；第二，执行task；

而NSURLSessionTask，也就是task，可以把它当作所谓的任务。

NSURLSessionTask是一个抽象子类，它有三个具体的子类是可以直接使用的：NSURLSessionDataTask，NSURLSessionUploadTask和NSURLSessionDownloadTask。这三个类应用的三个基本网络任务：获取数据、上传文件、下载文件。与数据有关的NSURLSessionDataTask也可以胜任上传下载的任务，所以经常使用到。

————示例————–

**一、GET方法**

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 </td> 
 <td style="vertical-align:baseline;"> <code>//&nbsp;1.创建一个网络路径</code> <code>NSURL&nbsp;*url&nbsp;=&nbsp;[NSURL&nbsp;URLWithString:[NSString&nbsp;stringWithFormat:@</code><code>"<a href="http://172.16.2.254/php/phonelogin?yourname=%25@&amp;yourpas=%25@&amp;btn=login" rel="nofollow">http://172.16.2.254/php/phonelogin?yourname=%@&amp;yourpas=%@&amp;btn=login</a>"</code><code>,yourname,yourpass]];</code> <code>//&nbsp;2.创建一个网络请求</code> <code>NSURLRequest&nbsp;*request&nbsp;=[NSURLRequest&nbsp;requestWithURL:url];</code> <code>//&nbsp;3.获得会话对象</code> <code>NSURLSession&nbsp;*session&nbsp;=&nbsp;[NSURLSession&nbsp;sharedSession];</code> <code>//&nbsp;4.根据会话对象，创建一个Task任务：</code> <code>NSURLSessionDataTask&nbsp;*sessionDataTask&nbsp;=&nbsp;[session&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSData&nbsp;*&nbsp;_Nullable&nbsp;data,&nbsp;NSURLResponse&nbsp;*&nbsp;_Nullable&nbsp;response,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSLog(@</code><code>"从服务器获取到数据"</code><code>);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/*</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>对从服务器获取到的数据data进行相应的处理：</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>NSDictionary&nbsp;*dict&nbsp;=&nbsp;[NSJSONSerialization&nbsp;JSONObjectWithData:data&nbsp;options:(NSJSONReadingMutableLeaves)&nbsp;error:nil];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//&nbsp;5.最后一步，执行任务（resume也是继续执行）:</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[sessionDataTask&nbsp;resume];</code> </td> 
 </tr> 
 </tbody> 
</table>

**二、POST方法**

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 </td> 
 <td style="vertical-align:baseline;"> <code>//&nbsp;1.创建一个网络路径</code> <code>NSURL&nbsp;*url&nbsp;=&nbsp;[NSURL&nbsp;URLWithString:[NSString&nbsp;stringWithFormat:@</code><code>"<a href="http://172.16.2.254/php/phonelogin" rel="nofollow">http://172.16.2.254/php/phonelogin</a>"</code><code>]];</code> <code>//&nbsp;2.创建一个网络请求，分别设置请求方法、请求参数</code> <code>NSMutableURLRequest&nbsp;*request&nbsp;=[NSMutableURLRequest&nbsp;requestWithURL:url];</code> <code>request.HTTPMethod&nbsp;=&nbsp;@</code><code>"POST"</code><code>;</code> <code>NSString&nbsp;*args&nbsp;=&nbsp;[NSString&nbsp;stringWithFormat:@</code><code>"yourname=%@&amp;yourpass=%@&amp;btn=login"</code><code>,yourname,yourpass];</code> <code>request.HTTPBody&nbsp;=&nbsp;[args&nbsp;dataUsingEncoding:NSUTF8StringEncoding];</code> <code>//&nbsp;3.获得会话对象</code> <code>NSURLSession&nbsp;*session&nbsp;=&nbsp;[NSURLSession&nbsp;sharedSession];</code> <code>//&nbsp;4.根据会话对象，创建一个Task任务</code> <code>NSURLSessionDataTask&nbsp;*sessionDataTask&nbsp;=&nbsp;[session&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSData&nbsp;*&nbsp;_Nullable&nbsp;data,&nbsp;NSURLResponse&nbsp;*&nbsp;_Nullable&nbsp;response,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> <code>NSLog(@</code><code>"从服务器获取到数据"</code><code>);</code> <code>/*</code> <code>对从服务器获取到的数据data进行相应的处理.</code> <code>*/</code> <code>NSDictionary&nbsp;*dict&nbsp;=&nbsp;[NSJSONSerialization&nbsp;JSONObjectWithData:data&nbsp;options:(NSJSONReadingMutableLeaves)&nbsp;error:nil];</code> <code>}];</code> <code>//5.最后一步，执行任务，(resume也是继续执行)。</code> <code>[sessionDataTask&nbsp;resume];</code> </td> 
 </tr> 
 </tbody> 
</table>

**三、NSURLSessionDataDelegate代理方法**

从前面两种方法中，我们都可以看出，相比NSURLConnection，NSURLSession提供了block方式处理返回数据的简便方式，但是，如果项目需要在网络请求数据的过程中，要做进一步的处理的话，需要调用NSURLSession的代理方法。

通常，使用代理方法需要先设置代理对象，但是通过查看NSURLSessionDataDelegate文档，我们可以看到如下，代理属性delegate为只读状态。

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 </td> 
 <td style="vertical-align:baseline;width:688px;"> <code>@property&nbsp;(nullable,&nbsp;readonly,&nbsp;retain)&nbsp;id&nbsp;&nbsp;delegate;</code> </td> 
 </tr> 
 </tbody> 
</table>

那么我们需要怎样设置代理对象呢？下面我们通过代码演示关于代理方法的使用：

首先在文件开头添加代理协议，

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 </td> 
 <td style="vertical-align:baseline;width:688px;"> <code>#import</code> <code>@interface&nbsp;ViewController&nbsp;:&nbsp;UIViewController&nbsp;&nbsp;&nbsp;</code><code>//遵循代理协议</code> <code>@end</code> </td> 
 </tr> 
 </tbody> 
</table>

主方法的编写如下：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 </td> 
 <td style="vertical-align:baseline;"> <code>//&nbsp;1.delegateQueue参数表示协议方法将会在(NSOperationQueue)队列里面执行。（session的delegate属性是只读的,所以使用如下方法设置代理。）</code> <code>NSURLSession&nbsp;*session&nbsp;=&nbsp;[NSURLSession&nbsp;sessionWithConfiguration:[NSURLSessionConfiguration&nbsp;defaultSessionConfiguration]</code> <code>delegate:self</code> <code>delegateQueue:[[NSOperationQueue&nbsp;alloc]&nbsp;init]];</code> <code>//&nbsp;2.创建任务(因为要使用代理方法,就不需要block方式的初始化了)</code> <code>NSURL&nbsp;*url&nbsp;=&nbsp;[NSURL&nbsp;URLWithString:[NSString&nbsp;stringWithFormat:@</code><code>"<a href="http://172.16.2.254/php/phonelogin?yourname=%25@&amp;yourpass=%25@&amp;btn=login" rel="nofollow">http://172.16.2.254/php/phonelogin?yourname=%@&amp;yourpass=%@&amp;btn=login</a>"</code><code>,yourname,yourpass]];</code> <code>NSURLSessionDataTask&nbsp;*task&nbsp;=&nbsp;[session&nbsp;dataTaskWithRequest:[NSURLRequest&nbsp;requestWithURL:url]];</code> <code>//&nbsp;3.执行任务</code> <code>[task&nbsp;resume];</code> </td> 
 </tr> 
 </tbody> 
</table>

关于代理行为：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 </td> 
 <td style="vertical-align:baseline;"> <code>#pragma&nbsp;mark&nbsp;--&nbsp;NSURLSessionDataDelegate//&nbsp;1.接收到服务器的响应</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session&nbsp;dataTask:(NSURLSessionDataTask&nbsp;*)dataTask&nbsp;didReceiveResponse:(NSURLResponse&nbsp;*)response&nbsp;completionHandler:(void&nbsp;(^)(NSURLSessionResponseDisposition))completionHandler&nbsp;{ </code> <code>//【注意：此处需要允许处理服务器的响应，才会继续加载服务器的数据。&nbsp;若在接收响应时需要对返回的参数进行处理(如获取响应头信息等),那么这些处理应该放在这个允许操作的前面。】</code> <code>completionHandler(NSURLSessionResponseAllow);</code> <code>}</code> <code>//&nbsp;2.接收到服务器的数据（此方法在接收数据过程会多次调用）</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session&nbsp;dataTask:(NSURLSessionDataTask&nbsp;*)dataTask&nbsp;didReceiveData:(NSData&nbsp;*)data&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//&nbsp;处理每次接收的数据，例如每次拼接到自己创建的数据receiveData</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[self.receiveData&nbsp;appendData:data];</code> <code>}</code> <code>//&nbsp;3.3.任务完成时调用（如果成功，error&nbsp;==&nbsp;nil）</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session&nbsp;task:(NSURLSessionTask&nbsp;*)task&nbsp;didCompleteWithError:(NSError&nbsp;*)error&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>if</code><code>(error&nbsp;==&nbsp;nil){ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/*</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>请求完成,成功或者失败的处理</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>else</code><code>{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSLog(@</code><code>"请求失败:%@"</code><code>,error);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

**四、NSURLSessionDownloadTask**

**1.NSURLSessionDownloadTask：文件下载任务**

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 </td> 
 <td style="vertical-align:baseline;"> <code>//&nbsp;1.创建网路路径</code> <code>NSURL&nbsp;*url&nbsp;=&nbsp;[NSURL&nbsp;URLWithString:@</code><code>"<a href="http://172.16.2.254/php/phonelogin/image.png" rel="nofollow">http://172.16.2.254/php/phonelogin/image.png</a>"</code><code>]&nbsp;;</code> <code>//&nbsp;2.获取会话</code> <code>NSURLSession&nbsp;*session&nbsp;=&nbsp;[NSURLSession&nbsp;sharedSession];</code> <code>//&nbsp;3.根据会话，创建任务</code> <code>NSURLSessionDownloadTask&nbsp;*task&nbsp;=&nbsp;[session&nbsp;downloadTaskWithURL:url&nbsp;completionHandler:^(NSURL&nbsp;*location,&nbsp;NSURLResponse&nbsp;*response,&nbsp;NSError&nbsp;*error)&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/*</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>a.location是沙盒中tmp文件夹下的一个临时url,文件下载后会存到这个位置,由于tmp中的文件随时可能被删除,所以我们需要自己需要把下载的文件移动到其他地方:pathUrl.</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>b.response.suggestedFilename是从相应中取出文件在服务器上存储路径的最后部分，例如根据本路径为，最后部分应该为：“image.png”</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSString&nbsp;*path&nbsp;=&nbsp;[[NSSearchPathForDirectoriesInDomains(NSCachesDirectory,&nbsp;NSUserDomainMask,&nbsp;YES)&nbsp;lastObject]&nbsp;stringByAppendingPathComponent:response.suggestedFilename];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSURL&nbsp;*pathUrl&nbsp;=&nbsp;[NSURL&nbsp;fileURLWithPath:path];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//&nbsp;剪切文件</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[[NSFileManager&nbsp;defaultManager]&nbsp;moveItemAtURL:location&nbsp;toURL:pathUrl&nbsp;error:nil];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}];</code> <code>//&nbsp;4.启动任务</code> <code>[task&nbsp;resume];</code> </td> 
 </tr> 
 </tbody> 
</table>

**2.NSURLSessionDownloadDelegate代理方法：**

首先添加协议

代理方法如下：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 </td> 
 <td style="vertical-align:baseline;"> <code>//&nbsp;1.每次写入调用(会调用多次)</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session&nbsp;downloadTask:(NSURLSessionDownloadTask&nbsp;*)downloadTask&nbsp;didWriteData:(int64_t)bytesWritten&nbsp;totalBytesWritten:(int64_t)totalBytesWritten&nbsp;totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//&nbsp;可在这里通过已写入的长度和总长度算出下载进度</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>CGFloat&nbsp;progress&nbsp;=&nbsp;1.0&nbsp;*&nbsp;totalBytesWritten&nbsp;/&nbsp;totalBytesExpectedToWrite;&nbsp;NSLog(@</code><code>"%f"</code><code>,progress);</code> <code>}</code> <code>//&nbsp;2.下载完成时调用</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>downloadTask:(NSURLSessionDownloadTask&nbsp;*)downloadTask</code> <code>didFinishDownloadingToURL:(NSURL&nbsp;*)location&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//&nbsp;&nbsp;这里的location也是一个临时路径,需要自己移动到需要的路径(caches下面)</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSString&nbsp;*filePath&nbsp;=&nbsp;[[NSSearchPathForDirectoriesInDomains(NSCachesDirectory,&nbsp;NSUserDomainMask,&nbsp;YES)&nbsp;lastObject]&nbsp;stringByAppendingPathComponent:downloadTask.response.suggestedFilename];</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[[NSFileManager&nbsp;defaultManager]&nbsp;moveItemAtURL:location&nbsp;toURL:[NSURL&nbsp;fileURLWithPath:filePath]&nbsp;error:nil];</code> <code>}</code> <code>//&nbsp;3.请求成功/失败（如果成功，error为nil）</code> <code>-&nbsp;(void)URLSession:(NSURLSession&nbsp;*)session&nbsp;task:(NSURLSessionTask&nbsp;*)task&nbsp;didCompleteWithError:(NSError&nbsp;*)error&nbsp;{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>if</code><code>(error&nbsp;==&nbsp;nil){ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/*</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>请求完成,成功或者失败的处理</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>else</code><code>{ </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>NSLog(@</code><code>"请求失败:%@"</code><code>,error);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

**五、NSURLSessionUploadTask**

**1. NSURLSessionUploadTask上传文件的方式有2种:**

*  GET方法：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 </td> 
 <td style="vertical-align:baseline;"> <code>NSURLSessionUploadTask&nbsp;*task&nbsp;=[[NSURLSession&nbsp;sharedSession]&nbsp;uploadTaskWithRequest:request&nbsp;fromFile:fileName</code> <code>completionHandler:^(NSData&nbsp;*data,&nbsp;NSURLResponse&nbsp;*response,&nbsp;NSError&nbsp;*error)&nbsp;{}];</code> </td> 
 </tr> 
 </tbody> 
</table>

POST方法：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:baseline;"> 1 2 3 4 </td> 
 <td style="vertical-align:baseline;"> <code>[[NSURLSession&nbsp;sharedSession]&nbsp;uploadTaskWithRequest:request&nbsp;fromData:body</code> <code>completionHandler:^(NSData&nbsp;data,&nbsp;NSURLResponse&nbsp;response,&nbsp;NSError&nbsp;*error)&nbsp;{ </code> <code>&nbsp;&nbsp;</code><code>NSLog(@</code><code>"-------%@"</code><code>,&nbsp;[NSJSONSerialization&nbsp;JSONObjectWithData:data&nbsp;options:kNilOptions&nbsp;error:nil]);</code> <code>}];</code> </td> 
 </tr> 
 </tbody> 
</table>

不同的点，在于，用post方法需要添加网络路径的请求体body，而在实际开发中，上传文件一般使用post方式，更加安全可靠。

**其他：**

当然，对于使用NSURLSession开发的项目来说，还有更多的方式可以执行，需要我们在日常开发过程多多发现，以便更好地使用这个较新的网络接口，例如AFNetWorking2.0版本之后，就有了基于NSURLSession的封装运用，具体的有兴趣的童鞋可以去github了解下。

本文作者：伯乐在线 - [啊左~][Link 1]

[Post_Danmark500.jpg]: https://imgconvert.csdnimg.cn/aHR0cDovL2NjLmNvY2ltZy5jb20vYXBpL3VwbG9hZHMvMjAxNjA1MzEvMTQ2NDY4MzM1NzEzNjIyNy5qcGc
[iOS_ GET_POST_NSURLConnection]: http://www.cocoachina.com/ios/20160601/16547.html
[Link 1]: http://www.jobbole.com/members/Azuo