NSURLSession入门及应用(请求管理器开发)

2017-01-14 15:50:29来源:http://www.jianshu.com/p/1523d7cfa9b1作者:Jabber_YQ人点击

前言

现如今几乎所有的app都需要联网,而一个app中也可能存在上百个接口,我最早学习的时候,都是直接用AFN在VC中访问服务器的,这样做虽然暂时简单了开发,但是却使得VC变成了垃圾桶,当遇到问题时也会很头疼。下面我来分享个较好的方法,自定义一个请求管理器。


NSURLSession的简单使用

磨刀不误砍柴工,作为一个想着进步的程序员,不可能一辈子都用AFN,而了解掌握一些系统的类也是尤为重要的。
从iOS9.0开始,NSURLConnection就被苹果废除了,取而代之的是NSURLSession,那么我们就来学习一下NSURLSession的使用吧。


一、Get请求
1.Get简单方法
- (void)get
{
// 获得NSURLSession对象
NSURLSession *session = [NSURLSession sharedSession];

// 创建请求
NSString *urlStr = @"http://music.163.com/api/playlist/detail?id=108970502";
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:urlStr]];
// 创建任务
NSURLSessionDataTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
NSLog(@"%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]);
}];
// 启动任务
[task resume];
}

2.Get代理方法 <NSURLSessionDataDelegate>
- (void)getDelegate
{
// 获得NSURLSession对象
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
// 创建请求
NSString *urlStr = @"http://music.163.com/api/playlist/detail?id=108970502";
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:urlStr]];
// 创建任务
NSURLSessionDataTask *task = [session dataTaskWithRequest:request];
// 启动任务
[task resume];
}
// 接收到服务器的响应
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
// 需要允许处理服务器的响应,才会继续接收服务器返回的数据
completionHandler(NSURLSessionResponseAllow);
}

// 接收到服务器的数据(可能会被调用多次)
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
NSLog(@"%@", data);
}

// 请求成功或者失败(如果失败,error有值)
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
}

二、Post请求
1.Post简单方法
    // 获得NSURLSession对象
NSURLSession *session = [NSURLSession sharedSession];
// 创建请求
NSString *urlStr = @"http://music.163.com/api/playlist/detail?id=108970502";
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlStr]];
request.HTTPMethod = @"POST"; // 请求方法
// 创建任务
NSURLSessionDataTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
NSLog(@"%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]);
}];
// 启动任务
[task resume];

2.Post代理方法

和get的代理方法类似,只是需要改变request的请求方法以及请求体。


三、download
1.download简单方法
    // 获得NSURLSession对象
NSURLSession *session = [NSURLSession sharedSession];
// 获得下载任务
NSURLSessionDownloadTask *task = [session downloadTaskWithURL:[NSURL URLWithString:@"http://m2.music.126.net/2ExmqXDnHZDH8qAORqRhew==/7978056373223494.mp3"] completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
// 文件将来存放的真实路径
NSString *file = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename];
// 剪切location的临时文件到真实路径
NSFileManager *mgr = [NSFileManager defaultManager];
[mgr moveItemAtURL:location toURL:[NSURL fileURLWithPath:file] error:nil];
}];
// 启动任务
[task resume];

这边下载后的文件后保存在location地址,我们需要做的是把这个文件移动到指定的位置。


2.download代理方法<NSURLSessionDownloadDelegate>
- (void)downloadDelegate
{
// 获得NSURLSession对象
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
// 获得下载任务
NSURLSessionDownloadTask *task = [session downloadTaskWithURL:[NSURL URLWithString:@"http://m2.music.126.net/2ExmqXDnHZDH8qAORqRhew==/7978056373223494.mp3"]];
// 启动任务
[task resume];
}

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
}
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{
NSLog(@"didResumeAtOffset");
}
/**
* 每当写入数据到临时文件时,就会调用一次这个方法
* totalBytesExpectedToWrite:总大小
* totalBytesWritten: 已经写入的大小
* bytesWritten: 这次写入多少
*/
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
NSLog(@"%f", 1.0 * totalBytesWritten / totalBytesExpectedToWrite);
}
// 下载完毕就会调用一次这个方法
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
NSString *file = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
NSFileManager *mgr = [NSFileManager defaultManager];
[mgr moveItemAtURL:location toURL:[NSURL fileURLWithPath:file] error:nil];
}

四、upload
1.upload简单方法
- (void)upload
{
// 获得NSURLSession对象
NSURLSession *session = [NSURLSession sharedSession];
// 创建"可变"请求对象
NSURL *url = [NSURL URLWithString:@"http://6:32812/upload"];
NSMutableURLRequest *request =[NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"POST";
// 设置请求头,告诉服务器本次长传的时文件信息 // 这一块的内容是不变的!
NSString *contentType = [NSString stringWithFormat:@"multipart/form-data; boundary=%@",bound];
[request setValue:contentType forHTTPHeaderField:@"Content-Type"];
// 设置请求体,拼接文件传输格式
NSMutableString *bodyHeaderStr = [NSMutableString stringWithFormat:@"--%@/r/n",bound];
[bodyHeaderStr appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@/r/n",@"userfile",@"JSON"];
[bodyHeaderStr appendString:@"Content-Type: application/octet-stream/r/n/r/n"];//两个换行
NSData *fileData = [NSData dataWithContentsOfFile:@"本地文件路径"];
NSMutableString *bodyFooterStr = [NSMutableString stringWithFormat:@"/r/n--%@--",bound];
//拼接成二进制数据
NSMutableData *bodyData = [NSMutableData data];
[bodyData appendData:[bodyHeaderStr dataUsingEncoding:NSUTF8StringEncoding]];
[bodyData appendData:fileData];
[bodyData appendData:[bodyFooterStr dataUsingEncoding:NSUTF8StringEncoding]];
NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:request fromData:bodyData completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
// 解析服务器返回的数据
NSLog(@"%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding]);
}];
//发送请求
[uploadTask resume];
}

2.uploadDelegate
// 主要代码
- (void)uploadDelegate
{
// 获得NSURLSession对象
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
}
/*
bytesSent:本次上传的数据大小
totalBytesSent:已经上传数据的总大小
totalBytesExpectedToSend:文件的总大小
*/
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
{
NSLog(@"%f",1.0 * totalBytesSent /totalBytesExpectedToSend);
}

上传较为麻烦,如果嫌麻烦可以直接使用第三方框架。


自定义请求管理器

既然NSURLSession基本会用了,那么我们就可以用它做一个请求管理器了。
首先先新建一个继承NSObject的类:YQRequestManager。然后思考这个管理器需要完成什么任务。
举个例子,我们需要获取我喜欢的歌曲列表,那么就需要声明一个方法:


- (void)fetchMyLikeMusicListWithUrl:(NSString *)url;

然后去.m文件中实现。可是怎么才能把获取到的数据传出来给控制器呢。可以使用delegate,也可以使用block。下面我来介绍一下block方法(block相比较代理方法更加直接明了):


第一步:声明Block:
typedef  void(^musicListRequestSussess)(NSMutableArray *likeMusicList);       //加载完成后返回数据并刷新列表
typedef void(^musicListRequestFail)(); // 失败

第二步:声明对象方法
- (void)fetchMyLikeMusicListWithUrl:(NSString *)url requestSussess:(musicListRequestSussess)sussess requestFail:(musicListRequestFail)fail;

第三步:方法实现
- (void)fetchMyLikeMusicListWithUrl:(NSString *)url requestSussess:(musicListRequestSussess)sussess requestFail:(musicListRequestFail)fail
{
if (!url) {
return;
}
NSString *dataPathStr = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"likeMusicListJSONData"];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionTask *task = [session dataTaskWithURL:[NSURL URLWithString:url] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
if (!error) {
//解析数据
NSMutableArray *likeMusicList = [NSMutableArray array];
// 返回数据 刷新
sussess(likeMusicList);
} else {
fail();
}
}];
[task resume];
}

PS:这里使用的是NSURLSession的get简单方法,也可以使用代理方法等等。


控制器调用
    NSString *urlStr = @"http://music.163.com/api/playlist/detail?id=108970502";
// 单例
YQRequestManager *manager = [YQRequestManager shareRequestManager];
[manager fetchMyLikeMusicListWithUrl:urlStr requestSussess:^(NSMutableArray *likeMusicList) {
// 获取到likeMusicList
// 更新界面
} requestFail:^{
NSLog(@"获取数据失败");
}];



最新文章

123

最新摄影

微信扫一扫

第七城市微信公众平台