说明:本文示例代码发送的请求均为http请求,需要对info.plist文件进行配置。如何配置,请参考https://github.com/HanGangAndHanMeimei/iOS9AdaptationTips
一、简单说明
在iOS9.0之后,以前使用的NSURLConnection过期,苹果推荐使用NSURLSession来替换NSURLConnection完成网路请求相关操作。
NSURLSession的使用非常简单,先根据会话对象创建一个请求Task,然后执行该Task即可。
NSURLSessionTask本身是一个抽象类,在使用的时候,通常是根据具体的需求使用它的几个子类。关系如下:
二、发送GET请求
使用NSURLSession发送GET请求的方法和NSURLConnection类似,整个过程如下:
1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供),GET请求参数直接跟在URL后面
2)创建请求对象(默认包含了请求头和请求方法【GET】),此步骤可以省略
3)创建会话对象(NSURLSession)
4)根据会话对象创建请求任务(NSURLSessionDataTask)
5)执行Task
6)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)
示例代码:
发生GET请求第一种方法
func GET1()
{
//对请求路径的说明
//http://120.25.226.186:32812/login?username=520it&pwd=520&type=JSON
//协议头+主机地址+接口名称+?+参数1&参数2&参数3
//协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login)+?+参数1(username=520it)&参数2(pwd=520)&参数3(type=JSON)
//GET请求,直接把请求参数跟在URL的后面以?隔开,多个参数之间以&符号拼接
//1.确定请求路径
var url: NSURL = NSURL(string: "http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON")!
//2.创建请求对象
//请求对象内部默认已经包含了请求头和请求方法(GET)
var request: NSURLRequest = NSURLRequest(URL: url)
//3.获得会话对象
var session: NSURLSession = NSURLSession.sharedSession()
//4.根据会话对象创建一个Task(发送请求)
/*
第一个参数:请求对象
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值
*/
var dataTask: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) in
if(error == nil){
//6.解析服务器返回的数据
//说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
var dict:NSDictionary? = nil
do {
dict = try NSJSONSerialization.JSONObjectWithData(data!, options: NSJSONReadingOptions.init(rawValue: 0)) as! NSDictionary
} catch {
}
print("%@",dict)
}
}
//5.执行任务
dataTask.resume()
}
发生GET请求第二种方法
func GET2()
{
//1.确定请求路径
var url: NSURL = NSURL(string: "http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON")!
//2.获得会话对象
var session: NSURLSession = NSURLSession.sharedSession()
//3.根据会话对象创建一个Task(发送请求)
/*
第一个参数:请求路径
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值
注意:
1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET)
2)如果要发送的是POST请求,则不能使用该方法
*/
var dataTask: NSURLSessionDataTask = session.dataTaskWithURL(url) { (data, response, error) in
//5.解析数据
var dict:NSDictionary? = nil
do {
dict = try NSJSONSerialization.JSONObjectWithData(data!, options: NSJSONReadingOptions.init(rawValue: 0)) as! NSDictionary
} catch {
}
print("%@",dict)
}
//4.执行任务
dataTask.resume()
}
执行结果:
此处打印的值是一个字典,字典中success这个key对应的value打印出来为Unicode编码的,如果想输出中文,可以为NSDictionary提供一个分类,重写系统中的方法。
//字典分类中重写系统的方法
func descriptionWithLocale(locale: AnyObject,level: NSInteger) ->NSString
{
//初始化可变字符串
var string: NSMutableString = NSMutableString()
//拼接开头[
string += "["
[string appendString:@"["];
//拼接字典中所有的键值对
[self enumerateKeysAndObjectsUsingBlock:^(id _Nonnull key, id _Nonnull obj, BOOL * _Nonnull stop) {
[string appendFormat:@"%@:",key];
[string appendFormat:@"%@",obj];
}];
//拼接结尾]
[string appendString:@"]"];
return string
}
三、发送POST请求
使用NSURLSession发送POST请求的方法和NSURLConnection类似,整个过程如下:
1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供)
2)创建可变的请求对象(因为需要修改),此步骤不可以省略
3)修改请求方法为POST
4)设置请求体,把参数转换为二进制数据并设置请求体
5)创建会话对象(NSURLSession)
6)根据会话对象创建请求任务(NSURLSessionDataTask)
7)执行Task
8)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)
示例代码:
//发送POST请求NSURLSession
func POST()
{
//对请求路径的说明
//http://120.25.226.186:32812/login
//协议头+主机地址+接口名称
//协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login)
//POST请求需要修改请求方法为POST,并把参数转换为二进制数据设置为请求体
//1.创建会话对象
var session: NSURLSession = NSURLSession.sharedSession()
//2.根据会话对象创建task
var url: NSURL = NSURL(string: "http://120.25.226.186:32812/login")!
//3.创建可变的请求对象
var request: NSMutableURLRequest = NSMutableURLRequest(URL: url)
//4.修改请求方法为POST
request.HTTPMethod = "POST"
//5.设置请求体
request.HTTPBody = "username=520it&pwd=520it&type=JSON".dataUsingEncoding(NSUTF8StringEncoding)
//6.根据会话对象创建一个Task(发送请求)
/*
第一个参数:请求对象
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值
*/
var dataTask: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) in
//if(error == nil){
//8.解析数据
//说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
var dict:NSDictionary? = nil
do {
dict = try NSJSONSerialization.JSONObjectWithData(data!, options: NSJSONReadingOptions.init(rawValue: 0)) as! NSDictionary
} catch {
}
print("%@",dict)
//}
}
//5.执行任务
dataTask.resume()
}
四、NSURLSession代理方法简单介绍
有的时候,我们可能需要监听网络请求的过程(如下载文件需监听文件下载进度),那么就需要用到代理方法。接下来通过代码简单说明NSURLSession中普通网络请求会涉及代理方法的使用
private var _responseData: NSMutableData!
var responseData: NSMutableData!{
get{
if _responseData == nil {
_responseData = NSMutableData()
}
return _responseData
}
set{
self._responseData = newValue
}
}
//当点击控制器View的时候会调用该方法
override func touchesBegan(touches: Set<UITouch>, withEvent event: UIEvent?)
{
self.delegateTest()
}
//发送请求,代理方法
func delegateTest()
{
//1.确定请求路径
var url: NSURL = NSURL(string: "http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON")!
//2.创建请求对象
//请求对象内部默认已经包含了请求头和请求方法(GET)
var request: NSURLRequest = NSURLRequest(URL: url)
//3.获得会话对象,并设置代理
/*
第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置
第二个参数:谁成为代理,此处为控制器本身即self
第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列
[NSOperationQueue mainQueue] 主队列: 代理方法在主线程中调用
[[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用
*/
var session: NSURLSession = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration(), delegate: self, delegateQueue: NSOperationQueue.mainQueue())
//4.根据会话对象创建一个Task(发送请求)
var dataTask: NSURLSessionTask = session.dataTaskWithRequest(request)
//5.执行任务
dataTask.resume()
}
//1.接收到服务器响应的时候调用该方法
func URLSession(session: NSURLSession, dataTask: NSURLSessionDataTask, didReceiveResponse response: NSURLResponse, completionHandler: (NSURLSessionResponseDisposition) -> Void) {
//在该方法中可以得到响应头信息,即response
print("didReceiveResponse--%@",NSThread.currentThread)
//注意:需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据
//默认是取消的
/*
NSURLSessionResponseCancel = 0, 默认的处理方式,取消
NSURLSessionResponseAllow = 1, 接收服务器返回的数据
NSURLSessionResponseBecomeDownload = 2,变成一个下载请求
NSURLSessionResponseBecomeStream 变成一个流
*/
completionHandler(NSURLSessionResponseDisposition.Allow)
}
//2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次
func URLSession(session: NSURLSession, dataTask: NSURLSessionDataTask, didReceiveData data: NSData) {
print("didReceiveData--%@",NSThread.currentThread)
//拼接服务器返回的数据
self.responseData.appendData(data)
}
//3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值
func URLSession(session: NSURLSession, task: NSURLSessionTask, didCompleteWithError error: NSError?) {
print("didCompleteWithError--%@",NSThread.currentThread)
if (error == nil) {
//解析数据,JSON解析请参考http://www.cnblogs.com/wendingding/p/3815303.html
var dict:NSDictionary? = nil
do {
dict = try NSJSONSerialization.JSONObjectWithData(self.responseData, options: NSJSONReadingOptions.init(rawValue: 0)) as! NSDictionary
} catch {
}
print("%@",dict)
}
}
代码执行结果: