登录 立即注册
金钱:

Code4App-iOS开发-iOS 开源代码库-iOS代码实例搜索-iOS特效示例-iOS代码例子下载-Code4App.com

JJNetwork正式版发布

[复制链接]
来自: jezz 分类: iOS精品源码 上传时间: 2017-12-8 18:28:10
Tag:

项目介绍:

基于AFNetworking封装的网络库,主要是为了满足一些复杂App的网络请求,并在层次划分上比较清新,所有的网络请求是数据提供者,还归纳了一些常见的功能封装在里面(缓存,签名...),设计文档

特色功能

  • [x] 自定义Key签名参数

  • [x] 缓存不止支持GET,还支持POST,根据自己的场景,自己选择策略

  • [x] 支持用IP替换域名,达到提高网络性能,支持HTTP HEAD设置

  • [x] 拦截网络请求,方便拦截任意请求,复用请求,加入Loading

安装环境

  • iOS 8.0以上

  • Xcode 7.3以上

如何安装

Podfile

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
pod 'JJNetwork'
end

执行命令:

$ pod install

使用Carthage集成

在你的Cartfile文件里,加入以下内容:

github "jezzmemo/JJNetwork"

AFNetworking.framework,JJNetwork.framework 两个framework加入到自己的项目

如何使用

JJAPIRequest

每个网络请求都是继承JJAPIRequest,并按照JJRequestInput协议的方法,按照自己的需求,重写(overwrite)指定的方法,来满足自己的需求.

下面我用JJNetwork来向http://api.imemo8.com/diary.php发送一个GET请求,参数是mod=getHotDiary:

#import "JJNetwork.h"

@interface DemoRequest : JJAPIRequest

@end

#import "DemoRequest.h"

@implementation DemoRequest

- (NSString*)requestURL{
    return @"http://api.imemo8.com/diary.php";
}

- (HTTPMethod)requestMethod{
    return JJRequestGET;
}
@end
  • requestURL
    填写一个完整的URL,继承JJAPIRequest的时候,必须需要实现这个方法,其余方法都是可选的,

  • requestMethod
    返回一个枚举类型,POST,GET,PUT,DELETE,如果不实现,默认是GET

如何传递参数和调用

关于在哪初始化Request,这个根据自己的情况自己选择,你可以在ViewController里调用,也可以再自己的中间层调用,这里给的例子是在ViewController里的例子:

#import "PresentViewController.h"
#import "DemoRequest.h"

@interface PresentViewController ()<JJRequestDelegate>

@property(nonatomic,readwrite,strong)DemoRequest* demoRequest;

@end

@implementation PresentViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    [self.demoRequest startRequest];
}

#pragma mark - Get property

- (DemoRequest*)demoRequest{
    if (_demoRequest != nil) {
        return _demoRequest;
    }
    _demoRequest = [DemoRequest new];
    _demoRequest.delegate = self;
    return _demoRequest;
}

#pragma mark - Request parameter

- (NSDictionary*)requestParameters:(JJAPIRequest *)request{
    return @{@"mod":@"getHotDiary"};
}

#pragma mark - Network response

- (void)responseSuccess:(JJAPIRequest *)request responseData:(id)data{
    NSLog(@"responseSuccess");
}

- (void)responseFail:(JJAPIRequest *)request errorMessage:(NSError *)error{
    NSLog(@"responseFail");
}
@end
  • 调用startRequest方法执行网络请求

  • 实现requestParameters来提供请求的参数,网络情况的输入

  • responseSuccess和responseFail,网络请求的输出

  • 至于为什么选择Delegate这种交互方式,传送门

使用自定义Key签名参数,示例如下:

- (NSString*)signParameterKey{
    return @"key";
}

如果使用了signParameterKey方法,就会产生两个参数signtimestamp,并且实现的方式是:md5(parameters + timestamp + key)

GET和POST都支持缓存,示例如下:

- (HTTPCachePolicy)requestCachePolicy{
    return ReloadFromCacheTimeLimit;
}

- (NSUInteger)cacheLimitTime{
    return 120;
}

如果选择了ReloadFromCacheTimeLimit缓存策略,就必须实现cacheLimitTime方法,作用是你的缓存持续的时间,过期后将从网络上重新请求,选择其他两种则不需要实现cacheLimitTime

  • ReloadFromNetwork: 只从网络获取

  • ReloadFromCacheElseLoadNetwork: 有缓存就从缓存获取,没有就从网路获取

  • ReloadFromCacheTimeLimit: 缓存限定的时间范围内

支持用IP替换域名(服务器要支持IP访问),达到提高网络性能,支持HTTP HEAD设置

  • JJAPIDominIPModule

@interface DomainModule : NSObject<JJAPIDominIPModule>

@end
@implementation DomainModule
- (NSDictionary*)domainIPData{
    return @{@"api.imemo8.com":@"218.244.140.1"};
}
@end
  • JJAPIHttpHeadModule

@interface HttpHeadModule : NSObject<JJAPIHttpHeadModule>

@end
@implementation HttpHeadModule

- (NSDictionary*)customerHttpHead{
    return @{@"user-token":@"xxxxx",@"device-id":@"xxxxx"};
}

@end

并注册到JJAPIRequest+Extension

[JJAPIRequest registerDomainIP:[[DomainModule alloc] init]];
[JJAPIRequest registerHttpHeadField:[[HttpHeadModule alloc] init]];

这是两个设置的接口,DomainModule是将域名替换成IP,减少了DNS的时间,从而提高访问速度.

HttpHeadModule是设置全局的Head Field,根据自己的项目需要来决定是否需要设置.

拦截器的使用

  • JJAPIRequest实例化对象的requestInterseptor的属性,并实现JJRequestInterseptor协议:

- (DemoRequest*)demoRequest{
    if (_demoRequest != nil) {
        return _demoRequest;
    }
    _demoRequest = [DemoRequest new];
    _demoRequest.delegate = self;
    _demoRequest.requestInterseptor = self;
    return _demoRequest;
}
  • JJAPIService 的扩展实现以下方法,可以监听任意JJAPIService子类:

+ (void)addRequestInterseptor:(id<JJRequestInterseptor>)interseptor forRequestClass:(Class)className;
+ (void)removeRequestInterseptor:(id<JJRequestInterseptor>)interseptor forRequestClass:(Class)className;

使用示例:

[JJAPIService addServiceInterseptor:self forServiceClass:[DemoAPIService class]];

- (void)beforeRequest:(JJAPIRequest*)request{
    NSLog(@"网络发送Request执行前");
}

- (void)afterRequest:(JJAPIRequest*)request{
    NSLog(@"网络发送Request执行后");
}

- (void)request:(JJAPIRequest*)request beforeResponse:(id)data{
    NSLog(@"返回结果前");
}

- (void)request:(JJAPIRequest*)request afterResponse:(id)data{
    NSLog(@"返回结果后");
}

主要应用的两个场景就是Loading的显示和关闭,还有就是如果我需要用某个网络请求的数据,不需要改动原来的业务逻辑,只需要添加一份拦截即可,对已有的代码不需要任何改动.

https://github.com/jezzmemo/JJNetwork

相关源码推荐:

我来说两句
*滑动验证:
所有评论(5)
littleRed 2017-12-11 16:14:11
帮帮顶顶!!
回复
BlueManlove 2017-12-11 16:14:15
学习...学习...
回复
kengsir 2017-12-11 16:14:41
膜拜大神~
回复
AlonMessi 2017-12-11 16:14:55
相当不错,感谢无私分享精神!
回复
phoiu 2017-12-11 16:15:44
我是来学习的
回复
hellokenken 2017-12-11 16:17:42
mark,收藏了
回复
code4app热心网友 2017-12-12 15:23:39
我只是路过打酱油的。
回复
code4app热心网友 2017-12-18 18:01:38
淡定,淡定,淡定……
回复
syy2016 2017-12-19 17:11:23
虽不明,但觉厉!
回复
提取码:  下载次数:21 状态:已购或VIP 售价:0(原价:20)金钱 下载权限:初级码农 
681 1 21
联系我们
首页/微信公众账号投稿

帖子代码编辑/版权问题

QQ:435399051,742864542

如何获得代码达人称号?

代码贡献英雄榜
用户名 下载数
通过邮件订阅最新 Code4App 信息
上一条 /4 下一条
联系我们
关闭
合作电话:
13802416937
Email:
435399051@qq.com
商务市场合作/投稿
问题反馈及帮助
联系我们

广告投放| Github|申请友链|手机版|Code4App ( 粤ICP备15117877号-1 )

快速回复 返回顶部 返回列表