Skip to content
/ HAccess Public

this a a middle layer between rude data (local data，networking data) and biz or controller

License

MIT license
18 stars 9 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

jumperb/HAccess

BranchesTags

Repository files navigation

What？

HAccess是介于一个网络数据,数据库数据与业务层之间的一个库，主要目的是降低业务层对这些数据的访问成本。 在大多数情况下，可以直接不需要业务层，直接通过controller层即可快速访问数据了。 库主要由HDeserializableObject，HNetworkDAO和HDatabaseDAO构成

HNetworkDAO 特性如下

  • 面向对象的接口管理方式
  • 请求参数映射
  • 极简的反序列化支持
  • 具有模型验证能力
  • 请求生命周期可扩展
  • 极简的队列控制
  • 极简的缓存控制
  • 极简的mock功能

HDatabaseDAO 特性如下

TODO

How？

一.文件下载

HNetworkDAO *dao = [HNetworkDAO new];
dao.baseURL = @"https://uploadbeta.com/api/pictures/random/?key=%E6%8E%A8%E5%A5%B3%E9%83%8E";
dao.isFileDownload = YES; //注释1
[dao start:^(id sender, id data) {
    NSLog(@"数据是%@", [data jsonString]);//注释2
} failure:^(id sender, NSError *error) {
    NSLog(@"error:%@", error.localizedDescription);
}];

//注释1 由于这里是文件下载，所以必须指明是文件下载，目前还没支持根据响应的content-type来决定返回啥东西，主要是AFNetworking还没支持
//注释2 jsonString在 #import <NSObject+ext.h> 这个里面

如果有报错

错误:Error Domain=Network Code=-1022 "The resource could not be loaded because the App Transport Security policy requires the use of a secure connection." UserInfo={NSLocalizedDescription=The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.}

在info.plist里面添加

<key>NSAppTransportSecurity</key>
<dict>
     <key>NSAllowsArbitraryLoads</key>
     <true/>
</dict>

下载好了，获取到返回

{
  "length" : 49181,
  "suggestedFilename" : "random.jpeg",
  "MIMEType" : "image\/jpeg",
  "filePath" : "\/Users\/zct\/Library\/Developer\/CoreSimulator\/Devices\/19BED3C5-5BBF-49E7-A82B-8BC7ED436B1C\/data\/Containers\/Data\/Application\/AF88FB0F-E5CE-40B6-BFCE-9C685EAE7CFF\/Library\/Caches\/com.hacess.HFileCache\/1570A0716FA3979787A9EA27BB253518"
}

这是一个内置的数据结构

/**
 *  file download info
 *  if HNetworkDAO.isFileDownload is YES, you will recv a response of this type if successed
 *  once you have downloaded, move the file to other place, otherwise it will be deleted after 1 minute
 */
@interface HDownloadFileInfo : NSObject
@property (nonatomic) NSString *filePath;
@property (nonatomic) NSString *MIMEType;
@property (nonatomic) long long length;
@property (nonatomic) NSString *suggestedFilename;
@end

直接拿着用就好了， **注意：**如果需要存储的话一定要移走，因为放在原地的话，1小时候会被删除 关于com.hacess.HFileCache这个，我们在后面的文章讲

可以看出这是一个图片下载，接着我们把这段代码复制一份做成一个函数，以便后面的demo使用

- (void)showImageURL:(NSString *)url
{
    HNetworkDAO *dao = [HNetworkDAO new];
    dao.baseURL = url;
    dao.isFileDownload = YES;
    [dao start:^(id sender, HDownloadFileInfo *data) {
        UIImageView *imageView = [[UIImageView alloc] initWithFrame:self.view.bounds];
        imageView.contentMode = UIViewContentModeScaleAspectFit;
        imageView.image = [UIImage imageWithContentsOfFile:data.filePath];
        [self.view addSubview:imageView];
        
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            [imageView removeFromSuperview];
        });
    } failure:^(id sender, NSError *error) {
        NSLog(@"error:%@", error.localizedDescription);
    }];
}

二.简单接口调用

接口api https://uploadbeta.com/picture-gallery/faq.php#api 的search接口
首先，HAccess建议使用面向对象的代码组织方式，所有的请求类，模型类都是在一个继承关系中的

创建SimpleDAO作为HNetworkDAO的子类

#import <HAccess/HNetworkDAO.h>
@interface SimpleDAO : HNetworkDAO
@property (nonatomic) NSString *searchKey;
@end
@implementation SimpleDAO
ppx(searchKey, HPMapto(@"key"))
- (instancetype)init
{
    self = [super init];
    if (self) {
        self.baseURL = @"https://uploadbeta.com";
        self.pathURL = @"/api/pictures/search/?start=1&offset=10";
    }
    return self;
}
@end

测试一下

[self addMenu:@"简单请求" callback:^(id sender, id data) {
    SimpleDAO *dao = [SimpleDAO new];
    dao.searchKey = @"sexy";
    [dao start:^(id sender, id data, NSError *error) {
        NSLog(@"data:%@",data);
    }];
}];

不出意外，你会获得一个字典返回

注意: “.m”文件里面有个ppx描述，这种写法叫做“属性注解”，这是一个属性描述方法，这句话的意思是说，把ID映射到id，为啥要映射啊？
A.服务器参数有objective-c的保留字
B.服务端参数名太随意，而我们有洁癖
C.如果服务端要日怪，非要把参数放在 http header 里面，还可以这样

ppx(searchKey, HPMapto(@"key"), HPHeader)

三.简单反序列化

SimpleDAO下发下来应该是个图集对象，我们希望直接能获取到一个直接可用的业务模型
我们先根据返回数据编写模型,可以直接写在SimpleDAO里面，我们期望返回的模型如下定义

@interface ImageObject : HDeserializableObject
@property (nonatomic) NSString *ID;
@property (nonatomic) NSString *url;
@property (nonatomic) NSString *title;
@property (nonatomic) NSString *fullImageURL;
@end
@implementation ImageObject
- (NSString *)fullImageURL
{
    if (!_fullImageURL)
    {
        _fullImageURL = [@"https://uploadbeta.com/_s/" stringByAppendingString:self.url];
    }
    return _fullImageURL;
}
@end

为了顺利进行反序列化，我们让他都继承自HDeserializableObject
并且在SimpleDAO的init函数中添加如下语句，告知DAO需要反序列化成什么

self.deserializer = [HNArrayDeserializer deserializerWithClass:[ImageObject class]];

HNArrayDeserializer 是指一种反序列化为数组的反序列化器，反序列化器内置只有有三种：

HNEntityDeserializer(反序列化为对象，支持对象的嵌套)，
HNArrayDeserializer(反序列化为数组)，
HNManualDeserializer（人工反序列化） 就能满足所有的情况。

再试一试？

你会依次遇到几个问题，后面是解决方式

1.ImageObject的属性叫ID 但是数据的key叫id

将头文件的id改成大写然后做属性映射
ppx(ID, HPMapto(@"id”))

2.服务端下发的id是数字，但是我们要求是字符串，怎么办？
ppx(ID, HPMapto(@"id"), HPAutoCast) //AutoCast是指字符串和数字可以按需自动转换

3.框架报了ImageObject的fullImageURL不能为空，那个只是客户端使用的，不需要转化的
ppx(fullImageURL, HPIgnore) //忽略掉

整体代码如下

@implementation ImageObject
ppx(ID, HPMapto(@"id"), HPAutoCast)
ppx(fullImageURL, HPIgnore)
- (NSString *)fullImageURL
{
    if (!_fullImageURL)
    {
        _fullImageURL = [@"https://uploadbeta.com/_s/" stringByAppendingString:self.url];
    }
    return _fullImageURL;
}
@end

四.服务端错误处理

错误分为三种级别：

  • 1.从NSURLSession来的错误，从AFNetworking来的错误，这种错误的Domain是“Network”
    例如，http的404，500等

  • 2.服务端返回业务错误码，这种错误的Domain是“Server”，例如
    {"code":"100002","info":"系统忙，请稍候再试"}

  • 3.服务端的数据不合格，被客户端检查出来了
    这种错误的Domain是识别到错误的模块，code是“kDataFormatErrorCode”，例如json解码失败，数据字段缺失等，例如"com.haccess.HNJsonDeserializer.HNEntityDeserializer,ImageObject:ID must be @NSString type"

其中第一种和第三种都是自动处理了，第二种需要代码来检测，框架不知道哪个代表成功哪个代表错误
例如如下的返回结果

{"msg":"访问权限错误","status":false}

我们会在json解析完成后来检查数据是不是代表错误，检查代码写在哪儿呢？
首先HNetworkDAO有个生命周期，类似UIViewController，这些都是一些请求过程的关键环节，可以在子类中自定义

#pragma mark - life circle
//设置请求头部
- (void)setupHeader:(NSMutableDictionary *)headers;
//设置参数
- (id)setupParams;
//设置参数字典
- (void)setupParams:(NSMutableDictionary *)params;
//设置参数完成
- (void)didSetupParams:(NSMutableDictionary *)params;
//将要发送请求，带上下文参数的
- (void)willSendRequest:(NSString *)urlString method:(NSString *)method headers:(NSMutableDictionary *)headers params:(NSMutableDictionary *)params;
//将要发送请求
- (void)willSendRequest:(NSMutableURLRequest *)request;
//开始请求
- (void)startWithQueueName:(NSString*)queueName;
//获得响应
- (void)requestFinishedSucessWithInfo:(NSData *)responInfo response:(NSURLResponse *)response;
//获取响应对象
- (id)getOutputEntiy:(id)responseObject;
//获取到错误
- (void)requestFinishedFailureWithError:(NSError*)error;

我们需要做的服务器错误处理就发生在"getOutputEntiy"这个环节
复写这个方法

- (id)getOutputEntiy:(id)responseObject
{
    if (![responseObject isKindOfClass:[NSDictionary class]]) return herr(kDataFormatErrorCode, @"预期响应格式是一个字典");
    NSDictionary *responseDict = (NSDictionary *)responseObject;
    if (responseDict[@"status"] && [responseDict[@"status"] boolValue] && !responseDict[@"msg"])
    {
        return [super getOutputEntiy:responseObject];
    }
    else
    {
        NSString *msg = responseDict[@"msg"];
        if (!msg) msg = @"服务端错误";
        return herr(503, msg);
    }
}

这样我们就可以把错误报到上层去了
Error Domain=SimpleDAO.m Code=503 "访问权限错误！" UserInfo={NSLocalizedDescription=访问权限错误！

五.生命周期的作用

我们来做个简单的签名
签名算法:所有请求参数，把key按照升序排列，数据按照a=1&b=2的方式连接成串，追加"123456"进行MD5得到sign，然后再通过sign传到服务器

- (NSString *)sign:(NSDictionary *)params
{
    NSArray *keys = [params keysSortedByValueUsingComparator:^NSComparisonResult(id  _Nonnull obj1, id  _Nonnull obj2) {
        return [obj1 compare:obj2];
    }];
    NSMutableString *signString = [NSMutableString new];
    for (NSString *key in keys)
    {
        if (signString.length == 0)
        {
            [signString appendFormat:@"%@=%@", key, params[key]];
        }
        else
        {
            [signString appendFormat:@"&%@=%@", key, params[key]];
        }
    }
    [signString appendString:@"123456"];
    return [signString md5];
}

那么在哪儿写入呢？

- (void)willSendRequest:(NSString *)urlString method:(NSString *)method headers:(NSMutableDictionary *)headers params:(NSMutableDictionary *)params
{
    [super willSendRequest:urlString method:method headers:headers params:params];
    params[@"sign"] = [self sign:params];
}

好了，发个请求试试吧

7.复杂反序列化

7.1 反序列化路径

如果数据层次较复杂，SimpleDAO是不知道你关心那一部分数据的，这里就需要指定反序列化路径了，例如

{
	"resp":{
		"data":{
			//我关心的数据
		}
	}
	"code":123,
	"msg":"成功"
}

反序列化路径就这样写

self.deserializeKeyPath = @"resp.data";

7.2 反序列化选项

我们之前已经接触到了几个反序列化选项
HPMapto: 属性映射关系
HPIgnore: 忽略这个属性，不要对这个属性进行反序列化
HPAutoCast: 字符串和数字自动按需转换

然而还有四个选项没告诉大家

HPOptional: 这个属性可以为空
HPInnerType: 指明内部类型，常用于指明数组内部是啥类型
HPScope: 这个属性的值域是什么，一般用于描述枚举类型
HPDivideType: 类型分离，用于决定数组内部类型或者字典对应类型，例如数组中的数据

[
    {
        "type":"pic",
        "picUrl":"http://www.abc.jpg",
        "picW":450,
        "picH":450
    },
    {
        "type":"video",
        "videoUrl":"http://www.drf.mp4",
        "videoW":450,
        "videoH":450
    }
]

需要将 type == pic 的字典转换成 PicObject, type == video 则转换成 VideoObject
那么就可以这样写

ppx(某个属性, HPDivideType(@"type", "pic", [PicObject class], "video", [VideoObject class]))

除了字符串 ，这里还可以填写 @(1), @(枚举值) 作为type的值

记住这七个选项的作用，需要用到的时候再来查看Demo中的用法
注意: 反序列化选项对DAO的属性同样适用，例如，你定义的属性名和请求参数的名字可以不一样！并通过HPMapto转换过去

七.队列控制

在上文中我们已经能获取到一个图片数组了，我们现在想要把图片显示出来
请求那儿改成这样

SimpleDAO *dao = [SimpleDAO new];
dao.searchKey = @"sexy";
[dao start:^(id sender, NSArray *data, NSError *error) {
    @strongify(self)
    if (error)
    {
        NSLog(@"%@",error);
    }
    else
    {
        for (ImageObject *imgObj in data)
        {
            [self showImageURL:[imgObj fullImageURL]];
        }
    }
}];

这时我们发现图片有时候会同时回来，前一张会把后一张盖住，原因是下载图片的请求我们是同时发出去的。
我们可以让请求排队执行，以解决这个问题

7.1并发控制

我们修改一下showImageURL这个函数

- (void)showImageURL:(NSString *)url
{
    HNetworkDAO *dao = [HNetworkDAO new];
    dao.baseURL = url;
    dao.isFileDownload = YES;
    [dao startWithQueueName:@"imageDownloadQueue" sucess:^(id sender, HDownloadFileInfo *data) {
        UIImageView *imageView = [[UIImageView alloc] initWithFrame:self.view.bounds];
        imageView.contentMode = UIViewContentModeScaleAspectFit;
        imageView.image = [UIImage imageWithContentsOfFile:data.filePath];
        [self.view addSubview:imageView];
        
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            [imageView removeFromSuperview];
        });
    } failure:^(id sender, NSError *error) {
        NSLog(@"error:%@", error.localizedDescription);
    }];
}

观察图片回来的log，就可以发现他是一张一张回来的了, 原因是我们给他指明了一个队列imageDownloadQueue，默认情况下这个是个串行的 如果希望设置并发数量，可以在请求开始之前设置

[HNetworkDAO initQueueWithName:@"imageDownloadQueue" maxMaxConcurrent:2];

7.2队列回调

我们希望在所有图片下载完成后得到一个通知

@strongify(self)
[HNetworkDAO initQueueWithName:@"imageDownloadQueue" maxMaxConcurrent:2];

for (ImageObject *imgObj in data)
{
    [self showImageURL:[imgObj imageURL]];
}

[HNetworkDAO queue:@"imageDownloadQueue" finish:^(id sender) {
    NSLog(@"所有图片下载完成");
}];

八.缓存控制

某个页面有个请求，需要间隔8小时才能发送请求，没到8小时，则展示缓存数据
在SimpleDAO的初始化方法中添加如下一行

self.cacheType = [HNCacheTypeAlternative createWtihNextRequstInterval:60*60*8];

还有其他缓存类型可选HNCacheTypeBoth，HNCacheTypeOnlyWrite，也可以自定义，需要用到再去研究吧。
缓存存放位置 = [HFileCache shareCache].cacheDir

再试一下，发现缓存起作用了。
但是我们发现输入ID不同，没有导致缓存失效，但是，按照这个接口的意义，不同的ID应该对应不同的缓存对象！怎么办呢？
那么我们需要给缓存key添加ID，在SimpleDAO.m中添加如下函数

- (NSString *)cacheKey
{
    return [[super cacheKey] stringByAppendingString:self.searchKey];
}

再试试写死ID，或者更改ID的情况

九.请求模拟-Mock

###9.1 自动Mock
自动mock的基础是猜测法，意思是说，框架来猜你要啥样的数据

9.1.1 添加一个依赖，并执行pod update

pod 'HAccessTools'

9.1.2 在viewDidLoad中添加
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
    [[HNetworkAutoMock shared] enable];
    [HNetworkAutoMock shared].baseformat = @{@"status":@YES};
});
9.1.3 将SimpleDAO设置为mock模式，在init函数中添加
self.isMock = YES;

运行一下吧

运行起来报错了，原因是url不合法，看一下数据，原来是src不对.
我们可以看到数据，同时下发了url和fullImageURL, 我们用一下这个地址发现只有fullImageURL这是一个有效的图片地址
这是因为，在自动mock中，猜对了fullImageURL的值应该是啥样的，但是”url”的命名框架猜不出来。

对于自动mock，命名越准确，注解写的越准确，那么就越容易猜中。

我们这里暂时把fullImageURL改成“可选的”，以完成这个案例
ppx(fullImageURL, HPOptional)
运行一下吧.

9.1.4 指定mock类型

如果框架猜测的结果不对，那么可以手动指定某一个属性mock成什么数据，例如

ppx(server_modified, HPMockAsDate)
ppx(server_created, HPMockAsDate)

这几个注解定义在“HNetworkAutoMock.h”中

对于多层次的model也是可用的, 在HAccessTools里面有更加清楚的demo
注意: 模拟数据的随机图片地址是可裁剪的，在将要发送图片请求时修改一下url

if ([url containsString:@"unsplash.it"])
{
    NSRange range = [url rangeOfString:@"image="];
    url = [NSString stringWithFormat:@"https://unsplash.it/%d/%d?%@",(int)w,(int)h, [url substringFromIndex:range.location]];
    return url;
}

占位符是显示区域宽高

9.2 手动Mock

不开启HNetworkAutoMock的情况下，打开isMock开关，则走手动mock
在项目中建立一个HNetworkDAO.bundle, 在里面建立SimpleDAO同名的一个json文件即可，在这个json文件里面就是手写json数据了

十.其他问题

a.文件上传见HNetworkMultiDataObj

b.请合理设计你的接口类继承关系

c.HDeserializableObject和HDatabaseDAO的可以直接参考HAccess的demo

d.HFileCache是一种扔进去就不用管了的缓存，见这个库的demo

About

this a a middle layer between rude data (local data，networking data) and biz or controller

Resources

Readme

License

MIT license
Activity

Stars

18 stars

Watchers

7 watching

Forks

9 forks
Report repository

Releases

118 tags

Packages

No packages published

Contributors 6

Languages