iOS开发--利用NSProxy实现消息转发-模块化的网络接口层设计

前言

之前在做项目的时候,所有业务的网络接口方法,全部都写在了一个文件里面,一开始还好,毕竟每个方法的代码也只是十几行,增加、修改也比较容易。但是随着接口的增多,这个文件慢慢居然超过了1000行,里面几十个方法都写在一起,实在是不好维护。

虽然保持这样也没有什么,多用用Cmd+F就能找到。但是,真是越看越不顺眼

Github 示例

贴上本文中的示例工程:https://github.com/zekunyan/HttpProxyExample

问题

先抛出问题。

一款互联网应用,免不了要跟服务器打交道,在iOS项目中,最有名的网络库应该就是AFNetworking了。所以,很多人就会利用AFnetworking提供的Get、Post等基本Http请求接口,封装自己的网络接口层代码,我自己在项目中也是这么做的。

但是,AFNetworking只是提供了Get、Post、Json传输等基本的Http请求方法,所以一旦落实到具体的业务相关的请求上,我们要为每个请求(URL)都写一个单独的接口方法。

那么,问题就来了

业务相关的接口那么多,举个例子,什么“通过用户ID获取用户基本信息”、“获取用户的所有评论”等,每个请求都是一个方法,这么多方法该怎么组织呢?全部放在一起?那这个接口类岂不是会非常乱?不放在一起?那岂不是会有很多个网络请求类?(至于要不要统一接口入口,我想这个根据项目来决定吧=。=)

需求

  • 所有网络接口都从统一的类调用,如HttpProxy。
  • 网络接口的具体实现,按照业务划分到不同的类中,如“UserHttpHandler”、“CommentHttpHandler”。

其实,按照面向对象的原则,就是接口代理类HttpProxy拥有若干个按照业务划分的接口(Interface),这些接口的所有方法组成了网络层的不同的Http请求。如下图:

imageimage

那么,调用的时候,所有接口都用HttpProxy调用,如:

//实际调用的是UserHttpHandler类的方法
[[HttpProxy sharedInstance] getUserWithID:@100];

//实际调用的是CommentHttpHandler类的方法
[[HttpProxy sharedInstance] getCommentsWithDate:date];

关键

根据前面的描述,我们可以得出,关键就是:消息转发(Message Forward)

Objective-C里面没有我们传统的“方法调用”,取而代之的是“消息”,所有的方法都是通过向对象发送“消息”实现调用的。而这个机制,也就为我们的实现提供了方便。

也就是说:我们要将发给“HttpProxy”的消息,让HttpProxy转发给真正能接受这个消息的对象,HttpProxy就是个代理

苹果已经给我们提供了这个“代理”类了-NSProxy。

NSProxy

什么是NSProxy:

  • NSProxy没有父类,是顶级类(根类),跟NSObject同等地位。
  • NSProxy和NSObject都实现了“NSObject Protocol”。
  • NSProxy设计时就是以“抽象类”设计的,专门为转发消息而生。

实现要求:

  1. 继承NSProxy的子类要实现自己的初始化方法,如“init”、“initWith”。
  2. 重写“ - forwardInvocation: ”和“ - methodSignatureForSelector: ”方法,完成消息转发。

详细内容参考Apple的文档

实现

定义

先不管HttpProxy,咱们看看具体的接口,先举两个例子:

//UserHttpHandler.h
//用户相关接口
@protocol UserHttpHandler <NSObject>
- (void)getUserWithID:(NSNumber *)userID;
@end

//CommentHttpHandler.h
//评论相关接口
@protocol CommentHttpHandler <NSObject>
- (void)getCommentsWithDate:(NSDate *)date;
@end

好的,接口有了,我们的HttpProxy类应该“实现”了这两个接口。
然后,最好是单例类,所以还要有个获取单例的方法。
最后,还需要一个向HttpProxy注册具体实现了接口Protocol的方法。

所以,HttpProxy应该是这个样子的:

//HttpProxy.h

//1. 继承了NSproxy。 2. “实现”了网络接口Protocol
@interface HttpProxy : NSProxy <UserHttpHandler, CommentHttpHandler>

//获取单例
+ (instancetype)sharedInstance;

//注册具体实现类
- (void)registerHttpProtocol:(Protocol *)httpProtocol handler:(id)handler;

@end

找到消息对应的实现类对象

如何在HttpProxy做消息转发时,找到某个消息对应的真正的实现类对象呢?

最好的办法就是保存每个接口方法到其实现类对象的映射,可以用Dictionary保存,关系如下图:

imageimage

所以,registerHttpProtocol:handler:方法的职责就是:

  1. 遍历Protocol的所有方法(利用Objective-C的Runtime功能)。
  2. 保存Protocol所有方法到实现类的对象的映射关系。(用方法的字符串表示作为key,实现类对象为value)

所以,HttpProxy应该持有一个Dictionary的实例,用于保存映射关系,HttpProxy的实现部分如:

//HttpProxy.m

@interface HttpProxy ()
//保存映射关系的字典。
@property(strong, nonatomic) NSMutableDictionary *selToHandlerMap;
@end

注册方法实现如下:

- (void)registerHttpProtocol:(Protocol *)httpProtocol handler:(id)handler {
    unsigned int numberOfMethods = 0;

    //Get all methods in protocol
    struct objc_method_description *methods = protocol_copyMethodDescriptionList(
            httpProtocol, YES, YES, &numberOfMethods);

    //Register protocol methods
    for (unsigned int i = 0; i < numberOfMethods; i++) {
        struct objc_method_description method = methods[i];
        [_selToHandlerMap setValue:handler forKey:NSStringFromSelector(method.name)];
    }
}

实现消息的转发

我们已经可以注册接口、保存映射关系了,剩下的就是重写NSProxy的两个方法,以实现消息的转发,至于这两个方法具体作用是什么,读者可以自行查阅相关资料。如下:

//HttpProxy.m

//获取Method signature
- (NSMethodSignature *)methodSignatureForSelector:(SEL)sel {

    //获取method的字符串表示
    NSString *methodsName = NSStringFromSelector(sel);

    //查找对应实现类对象
    id handler = [_selToHandlerMap valueForKey:methodsName];

    //再次检查handler是否可以相应此消息
    if (handler != nil && [handler respondsToSelector:sel]) {
        return [handler methodSignatureForSelector:sel];
    } else {
        return [super methodSignatureForSelector:sel];
    }
}

//转发方法消息
- (void)forwardInvocation:(NSInvocation *)invocation {
    NSString *methodsName = NSStringFromSelector(invocation.selector);
    id handler = [_selToHandlerMap valueForKey:methodsName];

    if (handler != nil && [handler respondsToSelector:invocation.selector]) {
        [invocation invokeWithTarget:handler];
    } else {
        [super forwardInvocation:invocation];
    }
}

Example

看看如何使用HttpProxy:

//初始化,注册Protocol对应的实现类对象
[[HttpProxy sharedInstance] registerHttpProtocol:@protocol(UserHttpHandler) handler:[UserHttpHandlerImp new]];
[[HttpProxy sharedInstance] registerHttpProtocol:@protocol(CommentHttpHandler) handler:[CommentHttpHandlerImp new]];

//调用
[[HttpProxy sharedInstance] getUserWithID:@100];
[[HttpProxy sharedInstance] getCommentsWithDate:[NSDate new]];

总结

所有的代码及示例都提交到Github了,HttpProxyExample

总的来说,就是利用Objective-C的“消息”机制,继承NSProxy抽象类,实现自己定义的转发机制,将网络接口层的各个方法的实现与声明分离,提升项目代码的可维护性,更加模块化。如下图表示:

imageimage

以上,就是我自己在项目中,利用NSProxy设计并实现的网络接口层结构。

本文转载自: http://www.jianshu.com/p/1bde36ad9938

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值