大数据项目管理：从规划到实现

接口设计

｜

65

REST

以简单的方式为后端服务提供接口，并可以在不编写代码的情况下调用服务——也

就是说，通过

Web

浏览器或命令行调用

REST API

。这样就可以非常容易地测试服务调用，

为服务创建简单的客户端。使用

Java

、

Python

和

C++

等通用编程语言创建客户端接口（简

化对服务的编程式访问）也变得更加容易。

通常，

REST

命令的输入和输出都是

JSON

，这是一种人类可读的格式（尽管有些人可能会

对此提出异议），非常适合用于探索性的工作，并且得到了通用编程语言的良好支持。

2.

代码接口实现

尽管

REST

是实现接口的一种常用且有效的方式，但有时候通过编程

API

实现更直接的客

户端层也具有优势。以

Kafka

生产者为例，它可能涉及分区、缓冲、批处理和一些复杂的

协议。虽然已经有了一个

Kafka REST

接口，

Kafka API

仍然提供了更丰富、性能更高的访

问接口。

你的目标应该是让接口变得更加通用。此外，开放性也很重要。如果要开发部署在产品中

的代码，但这个产品不属于你，那么就要让产品团队能够访问实现细节。并不一定要访问

源代码，但至少应包括文档、完整的接口定义等。此外，保持实现的开放性可以获得外部

帮助，从而更好地清除

bug

、优化性能和解决问题。

4.2.3

　版本控制

版本控制很重要，特别是那些被各种应用程序频繁使用的接口。请注意，向后兼容性很重

要，却令人头疼，需要进行额外的测试和规划。以下方法可以减轻它的副作用。

•

让迁移到新版本变得更容易。

•

不要频繁地更改

API

。

•

主动分享已弃用的调用信息，以及特定版本支持和不支持的内容。 ...