Go语言实战 : API服务器 (1) 技术选型

1. API是什么？

API（Application Programming Interface，应用程序编程接口）是一些预先定义的函数或者接口，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无须访问源码，或理解内部工作机制的细节。——百度百科

2. 怎么实现一个 API 服务器

要实现一个 API 服务器，首先要考虑两个方面：API 风格和媒体类型。Go 语言中常用的 API 风格是 RPC 和 REST，常用的媒体类型是 JSON、XML 和 Protobuf。在 Go API 开发中常用的组合是 gRPC+Protobuf 和REST+JSON。

3. REST是什么

REST（REpresentational State Transfer），首次出现在 2000 年 Roy Thomas Fielding 的博士论文中，它指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful 的。

• 资源（Resources），REST 是“表现层状态转化”，其实它省略了主语。“表现层”其实指的是“资源”的“表现层”。那么什么是资源呢？我们平时网上访问到图片、文字、文档、多媒体等就是资源，一般通过 URI 来定位。也就是说，一个 URI 就表示一个资源。
• 表现层（Representation），资源是作为一个具体的实体信息，它可以有多种的展现方式。而把实体展现出来就是表现层。例如一个 txt 文本信息，它可以输出成 html、json 等。
• 状态转化（State Transfer），访问一个网站，就代表了客户端和服务器的一个互动过程。在这个过程中，就涉及到数据和状态的变化。而 HTTP 协议是无状态的，那么这些状态肯定保存在服务器端，所以如果客户端想要通知服务器端改变数据和状态的变化，就要通过某种方式来通知它。客户端能通知服务器端的手段，只能是 HTTP 协议。具体来说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源（也可以用于更新资源），PUT 用来更新资源，DELETE 用来删除资源。
  综上所述，我们总结一下什么是 RESTful 架构：

1. 每一个 URI 代表一种资源

2. 客户端和服务端之间，传递这种资源的某种表现层

3. 客户端通过四个 HTTP 动词，对服务端资源进行操作，实现“表现层状态转化”

4. RPC又是什么

RPC（Remote Procedure Call Protocol）远程过程调用协议，是一种通过网络从远程计算机程序上请求服务，而不需要了解底层网络技术的协议。它假定某些传输协议的存在，如 TCP 或 UDP，以便为通信程序之间携带信息数据。通过它可以使函数调用模式网络化。在 OSI 网络通信模型中，RPC 跨越了传输层和应用层。RPC 使得开发包括网络分布式多程序在内的应用程序更加容易。

5. REST 还是 RPC

RPC 优点：

1. 调用简单，清晰，透明，不用像 rest 一样复杂，就像调用本地方法一样简单

2. 高效低延迟，性能高

3. 自定义协议（让传输报文提及更小）

4. 性能消耗低，高效的序列化协议可以支持高效的二进制传输

5. 自带负载均衡

RPC 缺点：

1. 耦合性强
2. 无法跨语言，平台敏感

REST优点:

1. 耦合性低，兼容性好，提高开发效率

2. 不用关心接口实现细节，相对更规范，更标准，更通用，跨语言支持

REST缺点:

1. 性能不如 RPC 高