网络层架构的认识

Posted on | In

项目越来越大，发现原来项目的网络架构扩展性比较差，想来想去，还是去了解一下新的架构。而正好，有个项目要把整个API换新的，于是改！！！！

想必绝大部人都看过casatwy大神iOS应用架构谈 网络层设计方案这个文章。我也是参考了他的架构，同时也看了猿题库网络库的源码，总的来说，它们俩的思路差不多，但实现有些许差别。

集约型老架构

之前的架构采用的是集约型。

原来的

我们从下往上看

  1. 一个HttpClient，里面用AFNetwork封装POST和GET等方法，这一层主要是网络调用。
  2. 然后上一层的BaseAPI是依赖于HttpClient，它有个方法是负责调用API的，可以把Token参数放在这里添加后再调用API。每个业务API都必须继承于它，在业务API中，负责每个的API的网络请求地址和请求参数，调用BaseAPI的方法发出请求。
  3. 而在NetworkHandler里面主要是对数据的过虑与封装，例如：
1
2
3
4
5
6
{
	"code" : 200  
	"data" : {
		...
	}
}

像从BaseAPI返回的是这种类型的JSON数据， code=200为调用成功，否则失败。所以在BaseNetworkHandler里面可以统一处理失败的请求。其次，在各个业务的Handler里面，可以对调用成功的数据转化为Model。

像这种架构的话，有两个问题：

  1. 取消请求，麻烦！
  2. 缓存数据，麻烦！
  3. 想单独对某个请求进行AOP，麻烦！

命令型新架构

为了以后更好的扩展，决定改成命令型。

命令型:首先我会定义好一个网络请求代理器，里面可以用AFNetwork，也可以用原生的。它的工作是接收到各式各样的请求命令，根据命令里信息，然后放到进队列发起请求。

然后在外面就会定义各种请求命令，请求命令里面包含着请求参数、请求地址、请求方法、请求头等一些相关的信息。
当然我们可以弄个请求命令的基类：BaseManager。里面定义了各种需要实现的协议。（多说一句：真想把java的抽像类给搬过来）。在基类有startRequest这样的方法，它的作用就是把命令往网络请求代理器中丢。

命令型架构

下面分两个问题来讲讲写命令型

怎么写好一个网络请求代理器呢

  1. 向外面只需要暴露接收命令的接口以及取消的接口
  2. 在里面必须把发请求部分要封装好，便于以后替换第三方库
  3. 持有每个请求，且为每个请求生成ID，便于取消

这个是从casatwy的RTNetworking里面CTApiProxy.h类找来的一段代码。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
	/** 这个函数存在的意义在于，如果将来要把AFNetworking换掉，只要修改这个函数的实现即可。 */
- (NSNumber *)callApiWithRequest:(NSURLRequest *)request success:(AXCallback)success fail:(AXCallback)fail
{
    
    NSLog(@"\n==================================\n\nRequest Start: \n\n %@\n\n==================================", request.URL);
    
    // 跑到这里的block的时候，就已经是主线程了。
    __block NSURLSessionDataTask *dataTask = nil;
    dataTask = [self.sessionManager dataTaskWithRequest:request completionHandler:^(NSURLResponse * _Nonnull response, id  _Nullable responseObject, NSError * _Nullable error) {
        NSNumber *requestID = @([dataTask taskIdentifier]);
        [self.dispatchTable removeObjectForKey:requestID];
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *)response;
        NSData *responseData = responseObject;
        NSString *responseString = [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
        
        if (error) {
            [CTLogger logDebugInfoWithResponse:httpResponse
                                  resposeString:responseString
                                        request:request
                                          error:error];
            CTURLResponse *CTResponse = [[CTURLResponse alloc] initWithResponseString:responseString requestId:requestID request:request responseData:responseData error:error];
            fail?fail(CTResponse):nil;
        } else {
            // 检查http response是否成立。
            [CTLogger logDebugInfoWithResponse:httpResponse
                                  resposeString:responseString
                                        request:request
                                          error:NULL];
            CTURLResponse *CTResponse = [[CTURLResponse alloc] initWithResponseString:responseString requestId:requestID request:request responseData:responseData status:CTURLResponseStatusSuccess];
            success?success(CTResponse):nil;
        }
    }];
    
    NSNumber *requestId = @([dataTask taskIdentifier]);
    
    self.dispatchTable[requestId] = dataTask;
    [dataTask resume];
    
    return requestId;
}

可以看到持有每个请求的ID并返回。便于取消。本身也持有了每个请求的ID

如何写一个消息命令呢？

话不多说，show you the code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
#import <Foundation/Foundation.h>
#import "CTURLResponse.h"

@class CTAPIBaseManager;


/*************************************************************************************************/
/*                               CTAPIManagerApiCallBackDelegate                                 */
/*************************************************************************************************/

//api回调
@protocol CTAPIManagerCallBackDelegate <NSObject>
 @required
- (void)managerCallAPIDidSuccess:(CTAPIBaseManager *)manager;
- (void)managerCallAPIDidFailed:(CTAPIBaseManager *)manager;
@end



/*************************************************************************************************/
/*                                         CTAPIManager                                          */
/*************************************************************************************************/
/*
 CTAPIBaseManager的派生类必须符合这些protocal
 */
@protocol CTAPIManager <NSObject>

@required
- (NSString *)methodName;
- (NSString *)serviceType;
- (CTAPIManagerRequestType)requestType;
- (BOOL)shouldCache;

// used for pagable API Managers mainly
@optional
- (void)cleanData;
- (NSDictionary *)reformParams:(NSDictionary *)params;
- (NSInteger)loadDataWithParams:(NSDictionary *)params;
- (BOOL)shouldLoadFromNative;

@end



/*************************************************************************************************/
/*                                       CTAPIBaseManager                                        */
/*************************************************************************************************/
@interface CTAPIBaseManager : NSObject

@property (nonatomic, weak) id<CTAPIManagerCallBackDelegate> delegate;
@property (nonatomic, weak) id<CTAPIManagerParamSource> paramSource;
@property (nonatomic, weak) id<CTAPIManagerValidator> validator;
@property (nonatomic, weak) NSObject<CTAPIManager> *child; //里面会调用到NSObject的方法，所以这里不用id
@property (nonatomic, weak) id<CTAPIManagerInterceptor> interceptor;

@end

同样也是从大神的库里面拿出一份代码，很多东西我都删了，只留下主要的部分代码。
像CTAPIManager，所有的派子生都必实现它，为什么用协议而不用继承呢？因为协议是强迫你实现，而继承总会忘了实现一些方法（还是很想说你java的抽像方法）。里面有methodName(请求地址)、requestType(请求类型)、shouldCache(是否缓存)等等。
像CTAPIManagerApiCallBackDelegate的是就API的回调了，一般可以在在ViewController实现。
还有其他的一些东西，我觉得得去认认真真去看看源码就会懂了。

不过我有一点跟大神不一样。那就是参数上的问题，在我的网络请求层里面，我不使用回调的方式从ViewController获取参数，我直接在APIManager持有参数。一方面不需要让ViewController持有参数，保持少量的代码。另一方面，因为很多参数都从不同的地方获取，这样子直接赋给APIManager会更方便一些。

新的架构大概感悟就这么多了，当流水账了…~ ~