从架构设计层面,一个端,尤其是一个成熟的端,应该有自己的规范,大到页面跳转、接口请求,小到某个具体的业务功能比如生成订单、取消订单、查看订单等。一方面,制定统一的协议后,不仅可以约束各业务线开发同学的开发行为,统一代码的风格,还可以增强团队同学的合作以及凝聚力,另一方面,统一开发行为后,对于增加新的功能、修复bug、查询问题等都有很好的帮助,极大提高开发效率。
App 架构组最重要的一个职能就是统一 App 架构,让业务开发同学在一套统一的架构中尽情塑造端的产品,以提高业务开发效率和保证业务使用稳定性为己任。本着这一原则,这一年来也在不断探索各种跟 App 架构相关的技能。面向协议的架构设计是我发现最能体现 App 架构意义的一个关键技术,用好、推广好协议架构,能使业务开发效率倍增。
一般来说,App 中的协议类型可以任意发散,只要可以复用的地方,你都可以用协议一言以蔽之。当然,我们都是有追求的人,应该创造一些更通用、更抽象、更值得让大家复用的协议,举个栗子,iOS SDK 中 url scheme 就是这样一个典型。
iOS URL Scheme
URL Schemes 是苹果给出的用来从一个应用跳转到系统任意其他应用的一种机制,同时还可以在应用之间传递数据,用于实现一些特定的功能,比如支付。你可以完全像理解一个网页的 URL 一样来理解一个 iOS 应用的 URL Scheme。
比如微信的 url scheme
weixin://
微信朋友圈 url scheme 格式
weixin://dl/moments
看着是不是很方便?
在其他app中,你可以像这样就可以跳转到微信 App 应用(如果已安装的话)
NSURL *url = [NSURL URLWithString:@"weixin://"];
[[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {
// ...
}];
每个应用都可以创建一个或一些属于自己的 url scheme,只需要配置 info.plist 文件即可,然后通过 App 管理中心 [UIApplication sharedApplication] 进行 App 之间的跳转和通信。
理解了苹果的 URL Schemes,我们将这样的思路应用到面向协议的架构上来。在任意一个抽象模块中,我们也可以用一个特定协议来指定它的使用规则及支持的功能,开放给调用方使用。只要调用方像使用 URL Schemes 的 开发者一样遵循模块协议的规则,使用抽象模块提供的 api 接口,就能进行模块的调用及使用其提供的服务。
由此,我们得出这样一个结论:面向协议的架构就是将每一个模块设计为一个/组特定的协议,通过协议来和这个模块进行通信,为此,面向协议的架构模块需要包括两个重要组件:协议+协议管理中心,同时封装好自己的服务。
那么,通用协议应该像什么样呢?
通用协议
scheme://service/actor?params=\{\"xxx\":xxx\}&origin=xxx
下面解释一下协议中每一项的含义。
scheme :模块名
service :服务名
actor :提供服务的对象/类
params :服务的参数
origin :请求服务的来源
注:origin 表明请求服务的来源,无论是哪种服务,提供服务的一方都应该知道服务请求方是谁,嗯,习惯性的用 origin。
大家可以畅想一下,这种格式协议是多么的强大!
在 App 的架构中,页面导航模块是非常重要的一个组件,直接决定当前 App 的风格、页面基础结构以及跳转动作样式,好的页面导航框架也能让业务方开发拥有极佳的新页面搭建和页面间跳转体验。而从面向协议的架构设计角度,我们可以这样约定一个页面跳转协议:
页面跳转协议
page://action?params={"xxx":xxx}&origin=xxx
// 跳转 native 页面
page://goto_native?params={"page_name":"xxxx","data":{"xxx":"xxx",...},"navi_type":0|1,"anime_type":-1|0|1|2|3|4,"success_callback":"xxxxxx","failure_callback":"xxxxx"}&origin=xxx
// 跳转 h5 页面
page://goto_web?params={"page_name":"xxxx","data":{"xxx":"xxx",...},"navi_type":0|1,"anime_type":-1|0|1|2|3|4,"success_callback":"xxxxxx","failure_callback":"xxxxx"}&origin=xxx
其中 page 指明页面导航模块,goto_native 指明 native 页面跳转服务,goto_web 指明 web 页面跳转服务,参数 params 中,包含目标页面的名称、页面参数、导航类型、动画格式、跳转成功回调以及跳转失败的回调,origin 指明跳转目标页面的前一个页面。
按照面向协议的架构模块设计原则,在页面导航模块中,还需要一个协议的管理中心 Manager,这个 Manager 用来实现协议的每一个细节。
Manager 需要提供的 api 包括:
// 跳转 native 页面
// 跳转 h5 页面
// 导航类型
// 动画类型
// 回调处理
// 页面参数包装
服务请求协议
// @TODO 可继续拆分
service://modulename/servicename?params={}&origin=xxx
Bridge 桥接协议
// bridge 为特定 scheme,bridgename 为bridge js库支持的api
bridge://bridgename?module=xxx&method=xxx&args=\{\}&origin=xxx