概述
如今大多App都会与网络打交道,作为开发者,合理的对网络后台请求接口进行封装十分重要。本文要介绍的就是一种常见的采用回调函数(方法)的网络接口封装,也算的是一种构架吧。
这个构架主要的idea是这样的,把所有的接口封装成一个类,在工程中随时可以调用。并且利用代理Delegate构建回调方法(callBack),工程中随处可以通过回调方法监听网络请求的反馈,也就是说,一旦得到了服务器反馈的数据,回调函数中的代码就(才)会被激活。网络请求基于AFNetworking(AFNetworking,非常有名的网络请求第三方类库),请求均为异步。如此构架,非常灵活很容易扩展和复用。
讲解
要想使用本文介绍的构架,你首先需要掌握代理(Delegate),如果你不熟悉代理,这个构架对你来说将会很不解。对于不熟悉代理的同学们,建议你们去看一下资料。网络请求其实说白了就是和服务器做一个数据交互,App把请求数据发给服务器,服务器返回给App一个反馈数据。请先看一下这个构架的示意图,如下:
QPNet.h
#import <Foundation/Foundation.h>
#import "AFNetworking.h"
// 代理
@protocol QPNetDelegate <NSObject>
/**
* 代理回调方法:一个请求成功、一个请求失败。
*
* @param feedbackInfo 服务器返回的数据
*/
- (void)submitLocationSuccessFeedback:(id)feedbackInfo;
- (void)submitLocationFailFeedback:(id)failInfo;
@end
@interface QPNet : NSObject
// Delegate的核心的作用就是来实现类之间的数据传递
@property (nonatomic,strong) id<QPNetDelegate> delegate;
/**
* 获取Net类的单例
*
* @return Net类的单例 实例(对象)
*/
+ (QPNet *)getInstance;
/**
* @author chenqianping
*
* 提交个人位置接口
* @param phone 手机号码
* @param lat 纬度
* @param lon 经度
* @param address 地址
* @param type 签到类型:1 手工签到,自动签到
*
* @return
*/
- (void)submitLocation: (NSString *)phone
lat :(NSString *)lat
lon :(NSString *)lon
address :(NSString *)address
type :(NSString *)type;
@end
QPNet.m
#import "QPNet.h"
#import "UrlDefine.h"
__strong static AFHTTPRequestOperationManager *AFHTTPMgr;
__strong static QPNet *NetInstance = nil;
@implementation QPNet
+ (QPNet *)getInstance
{
static dispatch_once_t onceToken;
dispatch_once(&onceToken,^{
// 初始化实例
NetInstance= [[QPNet alloc] init];
AFHTTPMgr = [AFHTTPRequestOperationManager manager];
AFHTTPMgr.responseSerializer.acceptableContentTypes = [NSSet setWithObject:@"text/html"];
AFHTTPMgr.responseSerializer = [AFHTTPResponseSerializer serializer];
});
return NetInstance;
}
- (void)submitLocation:(NSString *)phone lat:(NSString *)lat lon:(NSString *)lon address:(NSString *)address type:(NSString *)type
{
NSUserDefaults *appDefault =[NSUserDefaults standardUserDefaults];
phone = [appDefault objectForKey:@"phone"];
NSDictionary *dict = @{ @"a_infophone":phone,@"latitude":lat,@"longitude":lon,@"address":address,@"type":type};
[AFHTTPMgr GET:POSITION_URI parameters:dict success:^(AFHTTPRequestOperation * _Nonnull operation, id _Nonnull responseObject) {
// 请求成功Block,将返回数据传入代理方法
[self.delegate submitLocationSuccessFeedback:responseObject];
} failure:^(AFHTTPRequestOperation * _Nullable operation, NSError * _Nonnull error) {
// 请求失败Blick,将错误信息传入代理方法
[self.delegate submitLocationFailFeedback:error];
}];
}
@end