LazyNetForIOS
由于本人不太会写文章，有写得不好得地方请见谅
项目介绍
项目地址
介绍
- 这是一个iOS网络请求框架，基于AFNetworking封装，其中缓存模块依赖TMCache，JSON解析模块依赖MJExtension
- 非常感谢这三个作品的作者，个人也乐于开源，今后有觉得好的东西都会乐于与大家分享
- 如果觉得这个框架写得还不错，或者对自己有用的话，请给个star吧，感谢您的支持，谢谢
- 如果框架中有什么写得不足的地方，请告诉我，非常感谢
- 如果对使用方法不懂的地方你也可以联系我，乐于为你解答（联系方式你看末尾）
功能
- 1.支持json,NSString,NSData以及自定义请求，自定义请求可自行扩展，仅需自定义AFHTTPRequestSerializer和AFHTTPResponseSerializer的子类，并重写相应方法即可。
- 2.目前支持GET和POST方式的请求（一般开发场景中已足够用），以及文件上传和下载功能。
- 3.如果是json方式的请求，你只需要把对象的类型传过去，返回结果中就能得到对应的对象数据，model格式参考MJExtension。
- 4.支持缓存，虽然Cocoa网络请求本身就支持缓存功能，但实际应用中很多时候都不能满足我们的需求，比如先获取缓存数据再获取网络数据，后续将增加缓存期限。
- 5.支持block方式和delegate方式的数据回调，当一个页面中有多个请求的情况，强烈建议使用delegate方式，然后根据requestId（请求ID）来区分是哪一个请求，并进行相应的处理，提高代码的复用性。
- 6.支持返回数据的加工处理，只需自定义一个ResponseProcess的子类，并重写process方法来替换默认的加工器即可。
- 7.支持自定义请求参数，不管是什么类型，只需自定义一个RequestParam的子类，并重写body方法即可。
- 8.支持加载框，并且允许自定义加载框。
- 9.支持取消对应requestId的请求，以及取消所有请求。
- 10.支持取消当前ViewController中的所有请求，与ViewController联动。
- 11.日志输出请求信息清晰明了。
使用方法（以下使用方法只举了部分使用方法的例子，更多使用方法请自己查看代码，或者联系我）
库引入方式 CocoaPods
- 1.将 pod 'LazyNetLibrary' 添加到你的项目Podfile文件中。
- 2.在终端中运行 pod install。
- 3.导入 #import 'LazyNetLibrary.h'。
所需权限
更新baseUrl
- 如果你的项目中请求地址前缀是统一的，请使用以下方法来设置基础URL；如果不统一则无需设置。
[[LazyHttpClient getInstance] updateBaseUrl:url];
或者
HttpClient *httpClient=[[HttpClient alloc]initWithBaseUrl:url];
或者
HttpClient *httpClient=[[HttpClient alloc]init];
[httpClient updateBaseUrl:url];
get方式请求（以下是block回调方式，delegate方式请自行查看例子；例子的回调是重新包装过的，为了使用更加简单）
RequestParam* param=[[RequestParam alloc]initWithUrl:@"/mobile/get"];
[param addBody:self.phoneText.text withKey:@"phone"];
[param addBody:@"158e0590ea4e597836384817ee4108f3" withKey:@"key"];
[[LazyHttpClient getInstance]GET_JSON:self param:param responseClazz:[GetPhoneProvinceResponseModel class] loadingDelegate:nil loadCache:nil success:^(NSString *requestId, id response) {
GetPhoneProvinceResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} fail:^(NSString *requestId, NSInteger *errorCode, NSString *errorMsaaege) {
self.lable.text=[NSString stringWithFormat:@"获取手机号归属地错误,错误原因:%@",errorMsaaege];
}];
* 带缓存功能请求(缓存类型有四种,代码中自行查看)
RequestParam* param=[[RequestParam alloc]initWithUrl:@"/mobile/get"];
[param addBody:self.phoneText.text withKey:@"phone"];
[param addBody:@"158e0590ea4e597836384817ee4108f3" withKey:@"key"];
param.cacheLoadType=USE_CACHE_UPDATE_CACHE;
[[LazyHttpClient getInstance]GET_JSON:self param:param responseClazz:[GetPhoneProvinceResponseModel class] loadingDelegate:nil
loadCache:^(NSString *requestId, id response) {
GetPhoneProvinceResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} success:^(NSString *requestId, id response) {
GetPhoneProvinceResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} fail:^(NSString *requestId, NSInteger *errorCode, NSString *errorMsaaege) {
self.lable.text=[NSString stringWithFormat:@"获取手机号归属地错误,错误原因:%@",errorMsaaege];
}];
通过post方式请求数据（以下为block回调方式，delegate方式请自行参考示例；示例已进行了包装处理）
NSString*theUrl=@"/qqevaluate/qq";
RequestParam* param=[[RequestParam alloc]initWithUrl:theUrl];
[param addBody:self.phoneText.text withKey:@"qq"];
[param addBody:@"780e8bced58c6203140b858d7aa2644c" withKey:@"key"];
[[LazyHttpClient getInstance]POST_JSON:self param:param responseClazz:[QQXiongJIResponseModel class] loadingDelegate:nil loadCache:nil success:^(NSString *requestId, id response) {
QQXiongJIResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} fail:^(NSString *requestId, NSInteger *errorCode, NSString *errorMsaaege) {
self.lable.text=[NSString stringWithFormat:@"调用QQ测凶吉接口错误,错误原因:%@",errorMsaaege];
}];
* 带缓存功能的(缓存类型有四种,代码中自行查看)
NSString*theUrl=@"/qqevaluate/qq";
RequestParam* param=[[RequestParam alloc]initWithUrl:theUrl];
[param addBody:self.phoneText.text withKey:@"qq"];
[param addBody:@"780e8bced58c6203140b858d7aa2644c" withKey:@"key"];
param.cacheLoadType=USE_CACHE_UPDATE_CACHE;
[[LazyHttpClient getInstance]POST_JSON:self param:param responseClazz:[QQXiongJIResponseModel class] loadingDelegate:nil loadCache:^(NSString *requestId, id response) {
QQXiongJIResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} success:^(NSString *requestId, id response) {
QQXiongJIResponseModel*model=response;
self.lable.text=[JSONUtils objectToJSONString:model];
} fail:^(NSString *requestId, NSInteger *errorCode, NSString *errorMsaaege) {
self.lable.text=[NSString stringWithFormat:@"调用QQ测凶吉接口错误,错误原因:%@",errorMsaaege];
}];
上传
下载
关于作者Robin