SANetwork
简述
此库是对AFNetworking的二次封装，属于断开式接口封装。
如果您对这类库有任何看法或建议，欢迎您提出反馈！
添加到你的项目：
pod 'SANetwork'
使用
SANetwork大致结构
服务对象
创建配置服务对象SANetworkServiceProtocol
SANetwork 可配置不同服务环境的请求。这需要对于不同服务创建不同的服务配置对象。
此服务配置对象需要实现协议 SANetworkServiceProtocol
@required
- (NSString *)serviceApiBaseUrlString; // 服务接口地址的基础URL
- (NSSet<NSString *> *)serviceResponseAcceptableContentTypes; //服务接口 Acceptable-Content
@optional
- (SARequestSerializerType)serviceRequestSerializerType;
- (SAResponseSerializerType)serviceResponseSerializerType;
- (NSDictionary<NSString *,NSString *> *)serviceBaseHTTPRequestHeaders; //统一设定的请求头
- (NSDictionary<NSString *,NSString *> *)serviceBaseParamSource; //基本的请求参数
- (BOOL)serviceBaseAuthenticationWithNetworkRequest:(SANetworkRequest *)networkRequest response:(id)response; //统一验证拦截
- (NSTimeInterval)serviceRequestTimeoutInterval;
//以下特性化设置，方便从SANetworkResponse中获取值
- (NSString *)responseMessageKey;
- (NSString *)responseCodeKey;
- (NSString *)responseContentDataKey;
统一设置请求头（部分）参数
- (NSDictionary<NSString *,NSString *> *)serviceBaseHTTPRequestHeaders {
return @{
@"system" : @"iOS 9.0",
@"version" : @"1.0.0",
@"time" : @"2016-06-04 14:18:05",
@"token" : @"8046DB4D7844617E0F9EC72A46CE4317",
};
};
一旦设置有值，默认每个请求都会合并使用这个请求头参数，你可以通过 SANetworkRequestConfigProtocol 中的 useBaseHTTPRequestHeaders 方法来决定单个请求是否使用。你也可以通过 SANetworkRequestConfigProtocol 中的 customHTTPRequestHeaders 来定制单个请求的请求头。最终的请求头将会合并你所设置的值。
统一设置请求（部分）参数
- (NSDictionary<NSString *,NSString *> *)serviceBaseParamSource{
//根据自己的接口中大部分接口所必须的参数，进行统一设定
return @{
@"username" : @"001",
@"password" : @"123"
};
};
一旦设置有值，默认每个请求都会合并使用这个基础请求参数，你可以通过 SANetworkRequestConfigProtocol 中的 useBaseRequestParamSource 方法来决定是否合并使用这里设置的基础参数。
统一验证响应数据是否有效
- (BOOL)serviceBaseAuthenticationWithNetworkRequest:(SANetworkRequest *)networkRequest response:(id)response{
//可根据networkRequest、response进行验证。这里书写你的验证逻辑标准。
if(response[@"sign"] == nil) {
return NO;
}
return YES;
};
一旦设置有值，默认每个请求都会使用这个 Block 里的方法来验证请求到的数据，你可以通过 SANetworkRequestConfigProtocol 中的 useBaseAuthentication 方法来决定是否使用这个验证方法。
设置返回数据第一层对应的key字段
例如服务端返回的数据：
{
"code" : "100",
"msg" : "请求成功",
"data" : [
{"name" : "Paul","age" : "28"},
{"name" : "James","age" : "27"}
]
}
那么你可以这样设置：
- (NSString *)responseMessageKey {
return @"msg";
}
- (NSString *)responseCodeKey {
return @"code";
}
- (NSString *)responseContentDataKey {
return @"data";
}
这样设置之后，你就可以通过 SANetworkResponse 对象直接获取到你想要的数据（responseContentData、responseCode、responseMessage）。
请根据你的需求灵活运用这些服务的配置，你可以在 didFinishLaunchingWithOptions 中设置你的服务配置
- (void)registerServiceObject:(NSObject<SANetworkServiceProtocol> *)serviceObject serviceIdentifier:(NSString *)serviceIdentifier;
构建服务配置对象
@interface SATaobaoService : NSObject<SANetworkServiceProtocol>
@end
@implementation SATaobaoService
- (NSString *)serviceApiBaseUrlString {
return @"https://suggest.taobao.com/";
}
- (NSSet<NSString *> *)serviceResponseAcceptableContentTypes {
return [NSSet setWithObjects:@"application/json",nil];
}
- (SARequestSerializerType)serviceRequestSerializerType {
return SARequestSerializerTypeHTTP;
}
- (SAResponseSerializerType)serviceResponseSerializerType {
return SAResponseSerializerTypeJSON;
}
- (NSDictionary<NSString *,NSString *> *)serviceBaseHTTPRequestHeaders {
return nil;
}
- (NSDictionary<NSString *,NSString *> *)serviceBaseParamSource {
return nil;
}
- (BOOL)serviceBaseAuthenticationWithResonse:(id)response {
return YES;
}
- (NSTimeInterval)serviceRequestTimeoutInterval {
return 20.0f;
}
/*******以下协议的设定用于服务端返回数据的第一层格式统一，设定后，便于更深一层的取到数据 *********/
- (NSString *)responseContentDataKey {
return @"result";
}
@end
注册服务配置
#import "SATaobaoService.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[[SANetworkConfig sharedInstance] registerServiceObject:[[SATaobaoService alloc] init] serviceIdentifier:@"TaoBaoIdentifierKey"];
}
解读 SANetworkConfigProtocol，每个请求类都必须实现此协议！
说明一下请求必须实现的三个方法：1、服务标识Key
- (NSString *)serviceIdentifierKey;
属于哪个服务
2、设置请求的方法名
- (NSString *)requestMethodName;
你可以将它理解为请求的路径。你也可以设置为完整的带有http的请求地址，如果设置为带有http的请求地址，请求将会忽略 SANetworkConfig 设置的url。
3、验证返回的数据是否正确
- (BOOL)isCorrectWithResponseData:(id)responseData;
返回数据在这里处理好，这将使你在调用接口时更加方便，处理的事务更少。
此协议还可配置
- (SARequestMethod)requestMethod; //请求方式
- (NSDictionary *)requestParamDictionary; //配置请求参数
- (NSURLRequestCachePolicy)cachePolicy; //缓存策略，默认NSURLRequestUseProtocolCachePolicy
- (NSTimeInterval)requestTimeoutInterval;
- (BOOL)isCorrectWithRequestParams:(NSDictionary *)params; //请求参数是否正确
- (SARequestSerializerType)requestSerializerType;
- (SAResponseSerializerType)responseSerializerType;
- (NSSet <NSString *> *)responseAcceptableContentTypes;
- (AFConstructingBlock)constructingBodyBlock; //文件等富文本的上传
- (SARequestHandleSameRequestType)handleSameRequestType; //处理正在执行相同方法请求的方式
- (BOOL)useBaseRequestParamSource; //是否使用基础参数
- (BOOL)useBaseHTTPRequestHeaders; //是否使用基础的请求头参数
- (NSDictionary *)customHTTPRequestHeaders; //定制请求头
- (BOOL)useBaseAuthentication; //是否使用基础的请求验证
- (BOOL)enableDebugLog;
SANetworkResponse & SANetworkResponseProtocol
网络接口的结果数据会被配置到SANetworkResponse对象中，SANetworkResponse对象提供属性
@property (nonatomic, copy, readonly) id responseData; //原始数据
@property (nonatomic, assign, readonly) SANetworkStatus networkStatus; //网络接口状态
@property (nonatomic, assign, readonly) NSInteger requestTag; //对应请求类的标示
SANetworkResponse还提供数据转换的协议SANetworkResponseReformerProtocol和方法：
@protocol SANetworkResponseReformerProtocol <NSObject>
@required
- (id)networkResponse:(SANetworkResponse *)networkResponse reformerDataWithOriginData:(id)originData;
@end
@interface SANetworkResponse : NSObject
...
- (id)fetchDataWithReformer:(id<SANetworkResponseReformerProtocol>)reformer;
...
@end
SANetworkAccessoryProtocol
我客观地定义了实现此协议的类为“插件”。这里所说的“插件”就是跟踪请求的开始和结束，你可以在插件类中实现此协议，来处理请求开始和结束时的任务。比如定制一个 MBProgressHUD插件 ：
@interface SANetworkHUDAccessory ()<SANetworkAccessoryProtocol>
@property (nonatomic, strong) MBProgressHUD *hud;
@end
@implementation SANetworkHUDAccessory
- (instancetype)initWithShowInView:(UIView *)view text:(NSString *)text{
self = [super init];
if (self) {
_hud = [[MBProgressHUD alloc] initWithView:view];
[view addSubview:_hud];
if (text) {
_hud.labelText = text;
}
}
return self;
}
- (void)networkRequestAccessoryWillStart {
[self.hud show:YES];
}
- (void)networkRequestAccessoryByStatus:(SANetworkStatus)networkStatus {
[self.hud hide:YES afterDelay:0.3f];
}
@end
SANetworkInterceptorProtocol
这是一个请求返回之后，对于请求的成功之前、成功之后、失败之前、失败之后进行拦截，你可以在这些拦截方法中处理你的事务。
构建请求
此类库是以分散式方式进行二次封装的，需要针对每个请求创建一个请求类。
书写请求
请求类需要继承SANetworkRequest并必须实现协议SANetworkConfigProtocol！
就像这样（在Bejson上找的两个接口）
快递100的查询：
@interface ExpressRequest : SANetworkRequest<SANetworkConfigProtocol,SANetworkParamSourceProtocol>
@property (nonatomic, copy) NSString *type;
@property (nonatomic, copy) NSString *postId;
@end
@implementation ExpressRequest
- (NSString *)requestMethodName {
return @"query";
}
- (NSString *)serviceIdentifierKey {
return @"kuaidiServiceKey";
}
- (BOOL)isCorrectWithResponseData:(id)responseData {
if (responseData) {
return YES;
}
return NO;
}
- (NSDictionary *)requestParamDictionary {
return @{
@"type" : self.type,
@"postid" : self.postId
};
}
@end
淘宝关键词建议查询：
@interface TaobaoSuggestRequest : SANetworkRequest<SANetworkRequestConfigProtocol>
/**查询条件*/
@property (nonatomic, strong) NSString *query;
@end
@implementation TaobaoSuggestRequest
- (NSString *)requestMethodName {
return @"sug";
}
- (NSString *)serviceIdentifierKey {
return @"TaoBaoIdentifierKey";
}
- (BOOL)isCorrectWithResponseData:(id)responseData {
if (responseData) {
return YES;
}
return NO;
}
- (SARequestMethod)requestMethod {
return SARequestMethodGet;
}
- (NSSet<NSString *> *)responseAcceptableContentTypes {
return [NSSet setWithObject:@"text/html"];
}
- (NSDictionary *)requestParamDictionary {
return @{
@"code" : @"utf-8",
@"q" : self.query,
};
}
@end
发起单个请求
创建请求实例，设置请求响应回调，执行请求
SANetworkHUDAccessory *hudAccessory = [[SANetworkHUDAccessory alloc] initWithShowInView:self.view text:@"Loading..."];
ExpressRequest *expressRequest = [[ExpressRequest alloc] init];
expressRequest.type = @“yuantong”;
expressRequest.postId = @"881443********8914";
expressRequest.responseDelegate = self;
[expressRequest addNetworkAccessoryObject:hudAccessory]; //添加hud插件
[expressRequest startRequest];
实现协议SANetworkResponseProtocol中的方法，处理请求的响应结果
发起批量请求
批量请求的对象，务必将批量请求对象创建为类的一个属性，并将创建的批量请求对象赋给定义的属性。
SANetworkHUDAccessory *hudAccessory = [[SANetworkHUDAccessory alloc] initWithShowInView:self.view text:@"Batch Loading..."];
TaobaoSuggestRequest *suggestRequest = [[TaobaoSuggestRequest alloc] init];
suggestRequest.query = @"iphone";
ExpressRequest *expressRequest = [[ExpressRequest alloc] init];
expressRequest.type = @"yuantong";
expressRequest.postId = @"881443775034378914";
SANetworkBatchRequest *batchRequest = [[SANetworkBatchRequest alloc] initWithRequestArray:@[suggestRequest,expressRequest]];
[batchRequest addNetworkAccessoryObject:hudAccessory];
[batchRequest startBatchRequest];
_batchRequest = batchRequest;
将要发起的请求装入一个数组中，然后作为初始化参数完成批量请求对象的创建。
发起链式请求
与批量请求类似，链式请求的对象，务必将链式请求对象创建为类的一个属性，并将创建的链式请求对象赋给定义的属性。为了让大家更好地理解，这里举一个场景：用户登录，登录成功后获取用户相关联的信息。如果在登录成功后就想获取用户相关联的信息，就可以使用链式请求。
SANetworkHUDAccessory *hudAccessory = [[SANetworkHUDAccessory alloc] initWithShowInView:self.view text:@"Chain Loading..."];
TaobaoSuggestRequest *suggestRequest = [[TaobaoSuggestRequest alloc] init];
suggestRequest.query = @"iphone";
SANetworkChainRequest *chainRequest = [[SANetworkChainRequest alloc] initWithRootNetworkRequest:suggestRequest];
chainRequest.delegate = self;
[chainRequest addNetworkAccessoryObject:hudAccessory];
[chainRequest startChainRequest];
_chainRequest = chainRequest;
使用要发起的第一条请求作为链式请求初始化参数完成链式请求对象的创建。第二条或之后的请求，将通过链式请求的代理返回。
- (__kindof SANetworkRequest *)networkChainRequest:(SANetworkChainRequest *)chainRequest nextNetworkRequestByNetworkRequest:(__kindof SANetworkRequest *)request finishedByResponse:(SANetworkResponse *)response {
//这里的判断逻辑请求根据自己的业务逻辑灵活处理
if (response != nil && [request isKindOfClass:[TaobaoSuggestRequest class]]) {
ExpressRequest *expressRequest = [[ExpressRequest alloc] init];
expressRequest.type = @"yuantong";
expressRequest.postId = @"881443775034378914";
return expressRequest;
}
return nil;
}
该回调在先前的请求成功时被触发，你可以在该回调中决定你接下来要执行的请求。失败将调用另一个失败代理方法。