首页 > 其他分享> > iOS AFNetworking用法详解

iOS AFNetworking用法详解

2021-04-22 15:59:13 作者：互联网

AFNetworking下载地址：https://github.com/AFNetworking/AFNetworking

1.发送GET请求

第一个参数：NSString类型的请求路径，AFN内部会自动将该路径包装为一个url并创建请求对象
第二个参数：请求参数，此处为nil
第三个参数：进度回调，此处为nil
第四个参数：请求成功之后回调Block
第五个参数：请求失败回调Block

- (void)get
{
    //1.创建会话管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    //2.发送GET请求
    [manager GET:URL parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"请求成功---%@",responseObject);
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"请求失败---%@",error);
    }];
}

2.发送POST请求

第一个参数：NSString类型的请求路径，AFN内部会自动将该路径包装为一个url并创建请求对象
第二个参数：请求参数，以字典的方式传递，AFN内部会判断当前是POST请求还是GET请求，以选择直接拼接还是转换为NSData放到请求体中传递
第三个参数：进度回调此处为nil
第四个参数：请求成功之后回调Block
第五个参数：请求失败回调Block

-(void)post
{
    //1.创建会话管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    //2.创建参数
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:@"BaoBao" forKey:@"Name"];
    [dict setObject:@"123" forKey:@"passward"];
    //3.发送POST请求
    [manager POST:URL parameters:dict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        //注意：responseObject:请求成功返回的响应结果（AFN内部已经把响应体转换为OC对象，通常是字典或数组）
        NSLog(@"请求成功---%@",responseObject);
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"请求失败---%@",error);
    }];
}

3.文件下载

第一个参数：请求对象
第二个参数：进度回调
downloadProgress.completedUnitCount :已经下载的数据
downloadProgress.totalUnitCount：数据的总大小
第三个参数：destination回调，该block需要返回值（NSURL类型）
targetPath：文件的临时保存路径
response：响应头信息
第四个参数：completionHandler请求完成后回调
response：响应头信息
filePath：文件的保存路径，即destination回调的返回值
error：错误信息

-(void)download
{
    //1.创建会话管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    //2.创建请求对象
    NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"文件"]];
    //3.创建下载Task
    NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {
        NSLog(@"%f",1.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount);
    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {
        NSString *fullPath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename];
        NSLog(@"%@\n%@",targetPath,fullPath);
        return [NSURL fileURLWithPath:fullPath];
    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
        NSLog(@"%@",filePath);
    }];
    //4.执行Task
    [downloadTask resume];
}

4.文件上传

文件上传拼接数据方式

/*
  第一个参数：要上传的文件二进制数据
  第二个参数：文件参数对应的参数名称，此处为file是该台服务器规定的
  第三个参数：该文件上传到服务后以什么名称保存
  第四个参数：该文件的MIMeType类型
*/
[formData appendPartWithFileData:data name:@"file" fileName:@"Image.png" mimeType:@"application/octet-stream"];

/*
  第一个参数：要上传的文件的URL路径
  第二个参数：文件参数对应的参数名称，此处为file是该台服务器规定的
  第三个参数：该文件上传到服务后以什么名称保存
  第四个参数：该文件的MIMeType类型
  第五个参数：错误信息，传地址
 */
[formData appendPartWithFileURL:fileUrl name:@"file" fileName:@"Image2.png" mimeType:@"application/octet-stream" error:nil];

/*
  第一个参数：要上传的文件的URL路径
  第二个参数：文件参数对应的参数名称，此处为file
  第三个参数：错误信息
*/
[formData appendPartWithFileURL:fileUrl name:@"file" error:nil];

第一个参数：请求路径（NSString类型）
第二个参数：非文件参数，以字典的方式传递
第三个参数：constructingBodyWithBlock 在该回调中拼接文件参数
第四个参数：progress 进度回调
uploadProgress.completedUnitCount:已经上传的数据大小
uploadProgress.totalUnitCount：数据的总大小
第五个参数：success 请求成功的回调
task：上传Task
responseObject:服务器返回的响应体信息
第六个参数：failure 请求失败的回调
task：上传Task
error：错误信息

-(void)upload
{
    //1.创建会话管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    //2.处理参数(非文件参数)
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:@"BaoBao" forKey:@"name"];
    //3.发送请求上传文件
    [manager POST:URL parameters:dict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {
        UIImage *image = [UIImage imageNamed:@"Image3"];
        NSData *imageData = UIImagePNGRepresentation(image);
        //在该block中拼接要上传的文件参数
        [formData appendPartWithFileData:imageData name:@"file" fileName:@"Image5.png" mimeType:@"image/png"];
        //[formData appendPartWithFileURL:fileUrl name:@"file" fileName:@"Image7.png" mimeType:@"image/png" error:nil];
        //[formData appendPartWithFileURL:fileUrl name:@"file" error:nil];
    } progress:^(NSProgress * _Nonnull uploadProgress) {
        NSLog(@"%f",1.0 * uploadProgress.completedUnitCount / uploadProgress.totalUnitCount);
    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"请求成功----%@",responseObject);
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"请求失败----%@",error);
    }];
}

5.序列化处理

AFN它内部默认把服务器响应的数据当做json来进行解析，所以如果服务器返回给我的不是JSON数据那么请求报错，这个时候需要设置AFN对响应信息的解析方式。AFN提供了三种解析响应信息的方式，分别是：

1）AFXMLParserResponseSerializer----XML
2）AFHTTPResponseSerializer---------默认二进制响应数据
3）AFJSONResponseSerializer---------JSON
服务器返回给我们的数据格式不太一致（开发者工具Content-Type:text/xml）,那么这种情况也有可能请求不成功。解决方法:

1）直接在源代码中修改，添加相应的Content-Type
2）拿到这个属性，添加到它的集合中

-(void)srializer
{
    //1.创建请求管理者，内部基于NSURLSession
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    //如果返回的是XML，那么告诉AFN，响应的时候使用XML的方式解析
    manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
    //如果返回的就是二进制数据，那么采用默认二进制的方式来解析数据
    //manager.responseSerializer = [AFHTTPResponseSerializer serializer];
    //采用JSON的方式来解析数据
    //manager.responseSerializer = [AFJSONResponseSerializer serializer];
    //告诉AFN，再序列化服务器返回的数据的时候，支持此种类型
    [AFJSONResponseSerializer serializer].acceptableContentTypes = [NSSet setWithObject:@"text/xml"];
    //2.把所有的请求参数通过字典的方式来装载，GET方法内部会自动把所有的键值对取出以&符号拼接并最后用？符号连接在请求路径后面
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:@"BaoBao" forKey:@"name"];
    [dict setObject:@"passward" forKey:@"123"];
    [dict setObject:@"XML" forKey:@"type"];
    //3.发送GET请求
    [manager GET:URL parameters:dict success:^(NSURLSessionDataTask * _Nonnull task, id  _Nonnull responseObject) {
    //4.请求成功的回调block
        NSLog(@"%@",[responseObject class]);
    } failure:^(NSURLSessionDataTask * _Nonnull task, NSError * _Nonnull error) {
    //5.请求失败的回调，可以打印error的值查看错误信息
        NSLog(@"%@",error);
    }];
}

6.监测网络状态

说明：可以使用AFN框架中的AFNetworkReachabilityManager来监听网络状态的改变，也可以利用苹果提供的Reachability来监听。

-(void)AFNReachability
{
    //1.创建网络监听管理者
    AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
    //2.监听网络状态的改变
    /*
     AFNetworkReachabilityStatusUnknown          = 未知
     AFNetworkReachabilityStatusNotReachable     = 无网络
     AFNetworkReachabilityStatusReachableViaWWAN = 3G 4G
     AFNetworkReachabilityStatusReachableViaWiFi = WIFI
     */
    [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
        switch (status) {
            case AFNetworkReachabilityStatusUnknown:
                NSLog(@"未知");
                break;
            case AFNetworkReachabilityStatusNotReachable:
                NSLog(@"无网络");
                break;
            case AFNetworkReachabilityStatusReachableViaWWAN:
                NSLog(@"3G,4G");
                break;
            case AFNetworkReachabilityStatusReachableViaWiFi:
                NSLog(@"WIFI");
                break; 
            default:
                break;
        }
    }];
    //3.开始监听
    [manager startMonitoring];
}

7.单例

在开发的过程中可以创建一个工具类，继承自我们的AFN中的请求管理者，在控制器发送请求的代码使用自己封装的工具类。该工具类一般提供一个单例方法，在该方法中会设置一个基本的请求路径。该方法通常还会提供对GET或POST请求的封装。在外面的时候通过该工具类来发送请求

+ (instancetype)shareNetworkTools
{
    static NetworkTools *instance;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        //注意: BaseURL中一定要以/结尾
        instance = [[self alloc] initWithBaseURL:[NSURL URLWithString:BaseURL]];
    });
    return instance;
}

8.HTTPS请求

(1)证书转换
进到证书路径，执行 openssl x509 -in 证书.crt -out 证书.cer -outform der语句，这样就可以得到cer类型的证书了。双击，导入电脑。

(2)证书放入工程
a.可以直接把转换好的cer文件拖动到工程中。
b.可以在钥匙串内，找到你导入的证书，单击右键，导出项目，就可以导出.cer文件的证书了

(3)配置Info.plist

<key>NSAppTransportSecurity</key>
	<dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-13qTGm6R-1619077736089)(1.png)]

(4)使用系统类请求HTTPS
如果AFNetworking版本为2.x，使用NSURLConnection设置支持https

- (void)connection:(NSURLConnection *)connection willSendRequestForAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge{
    if(challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust) {
        // 告诉服务器，客户端信任证书
        // 创建凭据对象
        NSURLCredential *credntial = [NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust];
        // 告诉服务器信任证书
        [challenge.sender useCredential:credntial forAuthenticationChallenge:challenge];
    }
}

NSURLSession设置支持https

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task  didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * __nullable credential))completionHandler {
    // 判断是否是信任服务器证书
    if(challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust) {
        // 告诉服务器，客户端信任证书
        // 创建凭据对象
        NSURLCredential *credntial = [NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust];
        // 通过completionHandler告诉服务器信任证书
        completionHandler(NSURLSessionAuthChallengeUseCredential,credntial);
    }
}

(5)使用AFNetworking 2.x版本请求HTTPS
a.校验证书

// 初始化单例类
AFHTTPRequestOperationManager *mgr = [AFHTTPRequestOperationManager manager];
mgr.securityPolicy.SSLPinningMode = AFSSLPinningModeCertificate;
// 设置证书模式
NSString * cerPath = [[NSBundle mainBundle] pathForResource:@"xxx" ofType:@"cer"];
NSData * cerData = [NSData dataWithContentsOfFile:cerPath];
mgr.securityPolicy.pinnedCertificates = [[NSArray alloc] initWithObjects:cerData, nil];
// 客户端是否信任非法证书
mgr.securityPolicy.allowInvalidCertificates = YES;
// 是否在证书域字段中验证域名
[mgr.securityPolicy setValidatesDomainName:NO];

b.不校验证书

// 初始化单例类
AFHTTPRequestOperationManager *mgr = [AFHTTPRequestOperationManager manager];
mgr.securityPolicy.SSLPinningMode = AFSSLPinningModeCertificate;
// 设置非校验证书模式
mgr.securityPolicy = [AFSecurityPolicy policyWithPinningMode:AFSSLPinningModeNone];
mgr.securityPolicy.allowInvalidCertificates = YES;
[mgr.securityPolicy setValidatesDomainName:NO];

(6)使用AFNetworking 3.x版本请求HTTPS
a.校验证书

// 初始化单例类
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
manager.securityPolicy.SSLPinningMode = AFSSLPinningModeCertificate;
// 设置证书模式
NSString * cerPath = [[NSBundle mainBundle] pathForResource:@"xxx" ofType:@"cer"];
NSData * cerData = [NSData dataWithContentsOfFile:cerPath];
manager.securityPolicy = [AFSecurityPolicy policyWithPinningMode:AFSSLPinningModeCertificate withPinnedCertificates:[[NSSet alloc] initWithObjects:cerData, nil]];
// 客户端是否信任非法证书
mgr.securityPolicy.allowInvalidCertificates = YES;
// 是否在证书域字段中验证域名
[mgr.securityPolicy setValidatesDomainName:NO];

b.不校验证书

// 初始化单例类
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 设置非校验证书模式
manager.securityPolicy = [AFSecurityPolicy policyWithPinningMode:AFSSLPinningModeNone];
manager.securityPolicy.allowInvalidCertificates = YES;
[manager.securityPolicy setValidatesDomainName:NO];

标签：请求,证书,NSLog,iOS,manager,详解,参数,AFNetworking,Nonnull
来源： https://blog.csdn.net/chennai1101/article/details/116016109