HTTP 请求封装库 YiNetwork
- 授权协议: MIT
- 开发语言: Objective-C
- 操作系统: iOS
- 软件首页: https://github.com/coderyi/YiNetwork
- 软件文档: https://github.com/coderyi/YiNetwork
软件介绍
YiNetwork是一个的HTTP请求封装库，基于AFNetworking的AFHTTPSessionManager。
YiNetwork主要是一个基类库，主要是两个类YiBaseRequest和YiBaseModel.
之所以创建两个基类，是为了让各个请求之间的耦合性降低，能够非常简单的实现一个请求，并且在上层很简单调用一个请求。每一个请求一个子类也非常能够方便团队协作，每个人都可以管理自己的请求模块。
另外，由于Apple在网络请求方面由NSURLConnection（iOS 2-9）转向NSURLSession（iOS7以上）,随之AFNetworking 3.0也就废弃了NSURLConnection相关的 AFURLConnectionOperation，AFHTTPRequestOperation，AFHTTPRequestOperationManager 三个类，并且建议使用AFHTTPSessionManager，所以YiBaseRequest也是基于AFHTTPSessionManager的封 装。
YiNetwork目前依赖JSONModel version1.1.2和AFNetworking version2.6.1，是一套值得选择的App请求方案。
Podfile
platform :ios, '7.0'pod "YiNetwork", "~> 0.9.2"
YiBaseModel
YiBaseModel继承自第三方库JSONModel，当然你也可以不用使用它，自己解析JSON数据或者其它格式的数据
YiBaseRequest
YiBaseRequest必须子类化
属性
@property (nonatomic, strong) NSMutableDictionary *getParams; @property (nonatomic, strong) NSMutableDictionary *postParams;
可以在子类自定义的init方法里面，加入需要的GET参数或者POST参数
@property (nonatomic, assign) NSInteger retryCount; @property (nonatomic, assign) NSInteger retryIndex;
retryCount表示请求出错时重试的次数，默认为0；retryIndex表示正在重试第几次
方法
- (void)requestWithSuccess:(void(^)(YiBaseModel *model,NSURLSessionTask *task))success
failure:(void(^)(NSError *error,NSURLSessionTask *task))failure;
数据请求的方法，只要在上层调用该方法就可以获得请求成功或者失败的反馈，以得到YiBaseModel的数据。
- (YiHTTPRequestMethod)requestMethod;
需要实现的子类方法，表示请求方法，默认是YiHTTPRequestMethodGet为GET请求
- (YiBaseModel *)responseModelWithData:(id)data;
处理请求到得数据
- (NSString *)pathName; - (NSString *)rootUrl;
pathName表示请求的具体URL路径；rootUrl表示请求的URL
- (AFConstructingBlock)constructingBodyBlock;
当需要上传文件时可以使用
- (void)cancel;
取消当前的NSURLSessionTask对象，也就是取消这次请求
发送一个GET请求
只要分别子类化YiBaseRequest和YiBaseModel，在上层使用就非常简单
//通过GET请求获取用户信息
YiGetUserInfoRequest *getUserInfoRequest=[[YiGetUserInfoRequest alloc] init];
[getUserInfoRequest requestWithSuccess:^(YiBaseModel *model,NSURLSessionTask *task){
NSLog(@"username is %@",((YiUserInfoModel *)model).name);
} failure:^(NSError *error,NSURLSessionTask *task){
}];子类化YiBaseModel为YiUserInfoModel
@interface YiUserInfoModel : YiBaseModel @property(nonatomic,strong) NSString *name; @end
子类化YiBaseRequest为YiGetUserInfoRequest
@implementation YiGetUserInfoRequest
-(instancetype)init{
self = [super init];
if (self) {
}
return self;
}
-(instancetype)initWithNameId:(NSString *)nameId {
self = [super init];
if (self) {
[self.getParams setValue:nameId forKey:@"name_id"];
}
return self;
}
- (NSString *)pathName
{
return @"users/coderyi";
}
- (YiHTTPRequestMethod)requestMethod
{
return YiHTTPRequestMethodGet;
}
- (YiBaseModel *)responseModelWithData:(id)data
{
return [[YiUserInfoModel alloc] initWithDictionary:data error:nil];
}
@end发送一个POST请求
//通过POST请求修改用户信息
YiModifyUserInfoRequest *modifyUserInfoRequest=[[YiModifyUserInfoRequest alloc] initWithNameId:@"coderyi"];
[modifyUserInfoRequest requestWithSuccess:^(YiBaseModel *model,NSURLSessionTask *task){
NSLog(@"username is %@",((YiUserInfoModel *)model).name);
} failure:^(NSError *error,NSURLSessionTask *task){
}];子类化YiBaseRequest为YiModifyUserInfoRequest
@implementation YiModifyUserInfoRequest
-(instancetype)initWithNameId:(NSString *)nameId {
self = [super init];
if (self) {
[self.postParams setValue:nameId forKey:@"name_id"];
}
return self;
}
- (NSString *)pathName
{
return @"users/coderyi";
}
- (YiHTTPRequestMethod)requestMethod
{
return YiHTTPRequestMethodPost;
}
- (YiBaseModel *)responseModelWithData:(id)data
{
return [[YiUserInfoModel alloc] initWithDictionary:data error:nil];
}
@end上传图片
//上传一张图片
UIImage *image;
YiUploadImageRequest *uploadImageRequest=[[YiUploadImageRequest alloc] initWithImage:image];
[uploadImageRequest requestWithSuccess:^(YiBaseModel *model,NSURLSessionTask *task){
NSLog(@"model is %@",model);
} failure:^(NSError *error,NSURLSessionTask *task){
}];子类化YiBaseRequest为YiUploadImageRequest
@implementation YiUploadImageRequest{
UIImage *_image;
}
- (id)initWithImage:(UIImage *)image {
self = [super init];
if (self) {
_image = image;
}
return self;
}
- (AFConstructingBlock)constructingBodyBlock {
return ^(id formData) {
NSData *data = UIImageJPEGRepresentation(_image, 0.9);
NSString *name = @"image";
NSString *formKey = @"image";
NSString *type = @"image/jpeg";
[formData appendPartWithFileData:data name:formKey fileName:name mimeType:type];
};
}
@end
