内网API设计格对比分析.pptx

内网API设计风格对比分析选择最适合业务需要的API设计风格主讲人：李锟API的分类进程内调用API调用本地开发库本地进程间调用APILinux IPCAndroid IPC远程调用API内网API——企业内网中的API外网API——面向互联网的API外网应用内部API外网公共API什么是架构风格？一种 架构风格 是由一组相互协作的 架构约束 来定义的。架构约束是指应用软件的运行环境对于架构设计的约束条件。应用软件的架构设计不能脱离其运行环境。不同的运行环境，决定了应用的类型。不同类型的应用，会有不同的架构风格。架构风格比 架构实例（具体的架构）更加抽象。架构风格与架构实例可以理解为类似于OOP中接口与实现类之间的关系。架构风格是从建筑学中借用来的概念。来自美国建筑大师Christopher Alexander名著《建筑的永恒之道》（The?Timeless?Way?of?Building）建筑学中的不同风格流派举例：山西平遥乔家大院、安徽歙县徽商大宅院、江苏苏州拙政园分布式应用的架构风格服务设计、服务粒度划分面向服务的架构（Service Oriented Architecture，简称SOA）微服务架构（Microservices Architecture）领域驱动设计（Domain-Driven Design，简称DDD）分布式应用的架构风格远程调用API分布式对象（Distributed Objects，简称DO）CORBA/RMI/EJB/DCOM/.NET Remoting远程过程调用（Remote Procedure Call，简称RPC）SOAP/XML-RPC/JSON-RPC/Hessian/Burlap/Flash AMF/Dubbo RPC基于Google Protocol?Buffer数据交换格式的各种RPC协议基于Apache Thrift的各种RPC协议，例如唯品会的OSP表述性状态移交（Representational State Transfer，简称REST）将HTTP协议真正作为一种 应用协议 来使用，不再需要基于HTTP的各种RPC协议RESTful API——符合REST架构风格要求的API什么是REST？什么是REST？由Roy Fielding在其2000年的博士论文《架构风格与基于网络应用软件的架构设计》（Architectural Styles and the Design of Network-based Software Architectures）中提出REST有两种理解方式REST是一种分布式应用的架构风格——抽象层面REST是一种为 面向互联网的应用软件 量身定制的架构风格REST正是 Web自身的架构风格，它是Web所取得的巨大成功在技术层面的原因和理论基础REST在Web之上是 普适的，同时适用于Web App和Web APIREST是一种分布式应用的架构设计方法——具体层面REST有很多具体的设计原则和指导，实战性很强REST与RPC两种API调用风格的区别REST对服务器端做抽象的基本单元是 资源，RPC对服务器端做基本抽象的单元是 过程。REST的建模是以名词为核心的，RPC的建模是以动词为核心的。RPC中没有统一接口的概念。即使采用相同的协议，不同的API，设计风格可以完全不同。RPC也不支持操作语义对于中间组件的可见性。RPC中无法使用超媒体，响应的内容只包含数据。REST中使用了超媒体后，可以实现很大粒度的交互，交互的效率比RPC更高。REST支持数据流和管道，RPC不支持数据流和管道。因为使用了平台中立的消息，RPC的耦合度会比DO要小一些，但是RPC也常常会带来客户端与服务器端的紧耦合。REST中假如使用了超媒体，客户端与服务器端可以达到最小的耦合度。RPC API的优点对于服务器端开发人员而言，容易设计、开发便于做集中的监控基于socket的二进制RPC协议，建立连接延迟低、网络传输效率高支持有状态的长连接，可进行双向通信，实时性好RPC API的缺点紧耦合API一旦暴露出去，就难以再做改动没有统一的设计风格增加了客户端开发人员的学习成本难以实现通用的客户端库通常粒度较小开发人员很容易混淆远程调用与本地调用会损害用户（客户端）可感知的性能Richardson成熟度模型Richardson成熟度模型第0级：没有明确的资源概念，只有一个URL，只使用单个HTTP方法。第1级：有明确的资源概念，存在很多URL，只使用单个HTTP方法。第2级：有明确的资源概念，有很多URL，使用HTTP作为操作资源的统一接口。通常将对于资源的CRUD式操作分别映射到4个HTTP方法。第3级：在第2级的基础上，使用超媒体作为应用状态的引擎（Hypermedia as th