CDIF通用设备互联框架

灵长科技 API 管理解决方案的核心技术是具有中美知识产权保护的，名为通用设备互联框架（CDIF：common device interconnect framework）的软件框架，目前有部分开源实现存放在：https://github.com/out4b/cdif（注：开源部分遵照相关开源代码许可协议）。

CDIF 是世界上第一种基于 REST 和 JSON 的 SOA 软件框架，提供了与基于XML 的 WSDL 语言和 SOAP 协议同等抽象能力、但简洁得多的基于 JSON 的实现，也很是适合用于描述微服务架构的 API 接口。CDIF 提供了完整的服务注册和发现能力，为全部的 web 服务，包括 REST 和 SOAP 类型的服务建立出一个简洁、统一的 JSON 模型；并在此基础上提供了其REST接口上的统一 RPC 调用接口，方便了各类前端应用开发出基于该统一模型的 API 调用代码。

CDIF 软件框架的整体架构以下图所示：

在上图中，经过框架提供的设备抽象层，CDIF 未来自不一样厂商的各类类型的REST API 封装成各类虚拟设备，并对外提供统一的虚拟设备访问 REST 接口供客户端使用。CDIF 项目由 UPnP 标准发展而来。同时，对该项目的提议也是 UPnP 组织合并入 OCF 标准化组织的主要缘由之一。

在支持各种云服务的 API 接口同时，CDIF 也为全部的物联网设备提供了一个统一的模型，而且能够方便地帮助客户端建立出物联网设备和网络服务联动的各类应用场景。

因为其简洁的抽象能力，基于严格契约的松耦合架构，状态无关的可互换服务定义等优势，在 WSDL 和 SOAP 基础上打造的 SOA 技术体系至今仍然普遍应用于包括银行、交易所、航空公司、电信、医院、电商、支付平台等各行各业的大中型企业中。据 MuleSoft 估算，目前世界上每一年花费在与 SOA 技术相关的企业 IT 基础设施建设和系统集成工做有 5000 亿美圆之多。但因为 XML 格式用于数据交换过于复杂，以 XML 为基础的许多优秀的 WS-*标准都逐渐走向了没落。

随着移动时代的发展，以 REST 和 JSON 为基础打造的各类 web 服务、微服务架构逐渐成为主流。基于 JavaScript 开发的应用，如各类 web app、微信小程序等都以 REST 和 JSON 做为链接的基础。新兴 IT 企业也更倾向于使用 REST API，而不是 SOAP 来链接企业内部的各类基础业务组件。可是，目前企业内外使用的各类 REST API 基本都须要依赖文档手动管理，在 API 接口变化时，部署和升级新的 API 版本很是不方便。CDIF 为 REST API 创建的通用模型帮助填补了 REST API 与传统 SOA 技术的差距，并为传统 SOA 技术和云服务的结合与发展提供了全新的方向。基于 CDIF 的 SOA 技术能够方便地建立出许多全新类型的应用，好比 REST 服务流应用，web 服务和物联网设备的无缝结合等等，这些都是现有技术没法轻易实现的场景。

与 WSDL 或 Swagger 等技术不一样，使用 CDIF 提供的 JSON 模型与 RPC 接口的客户端 app 不须要对被 CDIF 管理的 REST API 作离线的客户端代码生成和手动集成，即可将这些 REST API接口及其变化动态地反映在客户端UI上供用户使用，大大省却了客户端对REST API的集成和API接口变化带来的繁琐的手动客户端升级工做。若是客户端app不但愿使用这些高级特性，CDIF提供的REST接口也能够向下兼容目前流行的手动集成方法。

同时，因为作到了对API的访问地址和方法彻底透明，CDIF也能够较好地帮助企业解决 REST API 的变化管理这一难题。CDIF支持驱动代码的热切换，驱动中的API访问地址发生变化时只须要安装新的驱动包到CDIF框架上，变化便可即时生效。当API参数或结果类型发生变化时，上层应用能够自动发现这些变化，并自动部署新的应用版本。这些特性均可以更好地帮助企业建设全自动化的运维环境。

更进一步，CDIF还能够为厂商的REST API提供独有的高级数据缓存能力，厂商只须要调整其REST API对CDIF框架提供的统一JSON模型上一个Boolean 取值即可开放该能力。此时，厂商云服务上的各类数据更新即可以实时地经过 WebSocket，APN等通道被CDIF的消息订阅者获取，而不须要由用户主动发起 API 调用更新数据，产生额外的API调用开销。该特性为目前全部基于API调用的单向云服务数据通道提供了更强大的能力。

基于以上的技术优点，使用灵长科技API管理解决方案的厂商能够将其REST API提供的业务能力自动展示在app UI上供用户消费使用，大大简化了app开发人员的工做，同时能够作到实时推广厂商经过其新添加REST API所展示的新增业务能力。灵长科技 API管理解决方案对REST API提供全自动的服务注册、发现和使用能力，每次厂商新发布的 API包版本上传后，使用该 API的全部app端的接口表单便可自动从新生成，而无需 app开发者手动集成和部署更改后的app版本，大大节省了厂商的API推广和管理成本，同时也显著地提高了API管理这种有着普遍应用的商业模式给厂商带来的价值。

欢迎登录 www.apemesh.com 体验！