AFNetworking 是基于NSURLConnection, NSOperation 开发的一款三方框架,主要用于处理一些关于网络请求上的业务,下文会简单介绍框架中经常使用的功能,如文件的上传,下载,解析.
一.GET&POST 请求
1 .首先最重要的当然是导入头文件
#import "AFNetworking.h"
2. 创建会话管理者(创建的管理者对象并不是单例)
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager]
3.最后很简单,只要直接调用方法就可以了
GET后面第一个参数,就是我们所说的请求头,但是这里有个注意问题:平时我们使用NSURLConnection和NSURLSession时发送GET请求时所有内容都是写入请求头中的,也就是请求地址中要加上一大推参数,而在这个方法中AFN将请求体信息单独抽出来,放在红色背景的这块区域,你可以将你所要上传的请求体包装成字典,然后作为参数添加到其中,这样做有个好处就是当我们发送POST请求时, 只需要将此方法中的GET替换成POST即可
get请求
[manager GET:@"http://***.**.***.***:*****/login" parameters:<#(nullable id)#> progress:nil
success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject)
请求成功,会调用此block,responseObject为响应体信息,内部已经将信息完成了序列化
NSLog(@"%@--%@",[responseObject class],responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
如果请求失败,会调用此block error 则为请求失败原因
}];
post请求 可以看出两个方法只差一个单词
[manager POST:@"http://***.**.***.***:*****/login" parameters:<#(nullable id)#> progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
//3.解析
NSLog(@"%@--%@",[responseObject class],responseObject);
==
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error)
}];
}
二.AFN下载文件
1 .同样是简单的方法调用,
1 //1.创建会话管理者
2 AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
3
4 //2.创建请求对象
5 NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"随便添加一张网上照片的地址"]];
6
7 //3.创建下载任务
8 /*
9 第一个参数:请求对象
10 第二个参数:进度回调 downloadProgress(获得进度信息)
11 第三个参数:destination
12 targetPath:文件的临时存储路径
13 response:响应头信息
14 返回值:NSURL(AFN内部已经实现了文件剪切的过程,但是需要我们告诉他应该把文件剪切到哪里)
15 第四个参数:completionHandler 请求完成的时候调用
16 response:响应头信息
17 fileP ath==fullPath 文件的最终目录(第三个参数回调的返回值)
18 error:错误信息
[manager downloadTaskWithRequest:<#(nonnull NSURLRequest *)#>
progress:<#^(NSProgress * _Nonnull downloadProgress)downloadProgressBlock#>
destination:<#^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response)destination#>
completionHandler:<#^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error)completionHandler#>]
这里要注意的是:我们可以在第二个参数回调里监听下载进度(回调返回参数downloadProgress内含参数)
downloadProgress.completedUnitCount /downloadProgress.totalUnitCount)
而第三个参数回调是要有返回值的,返回值就是文件最终的存储位置,正如上面所说,剪切过程在内部实现,你只需要return一个地址,通常的做法,在参数response中有个建议文件名称属性(suggestedFilename),我们将它拼接到沙盒路径下就可以得到一个存储文件地址了,具体代码如下
// 沙盒路径
NSString *path = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES)lastObject];
// 拼接全路径
NSString *fullPath = [path stringByAppendingPathComponent:response.suggestedFilename];
return fullPath ;
三.上传文件
基本用法与下载类似,响应参数也差不多,只有第三个参数需要我们注意,下面代码中已标红
//1.创建会话管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//2.发送POST请求上传文件
/*
第一个参数:请求路径 NSString
第二个参数:非文件参数
第三个参数:constructingBodyWithBlock 用来拼接要上传的文件数据
第四个参数:progress进度回调
第五个参数:success 上传成功的回调
第六个参数:failure 失败后的回调
*/
[manager POST:@"http://120.25.226.232:32433/upload" parameters:nil
constructingBodyWithBlock:^(id<AFMultipartFormData> _Nonnull formData) {
//FileURL:要上传的文件的URL路径
NSURL *fileUrl = [NSURL fileURLWithPath:@"/Users/Desktop/1233.png"];//该方法是简单版本,该方法内部会自动的得到文件的名称以及文件的类型(方法里面name为服务器中存储文件的名称)
[formData appendPartWithFileURL:fileUrl name:@"file" error:nil];
} progress:^(NSProgress * _Nonnull uploadProgress) {
上传进度
} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"成功---%@",responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"失败---%@",error);
}];
}
先介绍这些,AFN还有很多实用的方法,下载图片、解析数据等,很方便实用有时间再多写一些.