微服务架构设计 第八步: 设计微服务对外 REST API
来源:互联网 发布:陈克礼枪毙 知乎 编辑:程序博客网 时间:2024/06/05 03:59
2016.9.22, 北京, Ken Fang
开发与测试人员协作完成了: 微服务对外需提供的方法 (API) 后, 开发与测试人员便需继续协作, 将微服务对外需提供的方法 (API), 设计成 REST API。
将微服务对外需提供的方法 (API), 设计成 REST API 的主要步骤如下:
1. 将微服务中代表某个单一业务概念的实体, 识为 “Resource”。并分析 Resource 间的关系。
Resource 间的关系
Independent
在没有其他的 Resources 存在下, 也能独立存在的 Resources。
Dependent
一定要所依赖的父 Resources 存在, 才能存在的 Resources。
Associative
Resources 间是互相独立存在的, 但, 彼此间存在著 “包含” 的关系; 某个 Resource 所需额外的 Properties, 只需 Link 到另一个 Resource。
2. 将微服务中代表某个单一业务概念的实体, 对外需提供的方法 (API), 对映到 Http 的方法。
API Modeling Actions
Typical HTTP Verb
List, Search, Match, View All
GET a resource collection
GET /{collection name}
Show, Retrieve, View
Get a resource
GET /{collection name}/{id}
Create, Add
POST create a resource
POST /{collection name}
Replace
PUT update a resource collection
PUT /{collection name}
Update
PUT update a resource
PUT /{collection name}/{id}
Delete All, Remove All, Clear, Reset
DELETE delete a resource collection
DELETE /{collection name}
Delete, Remove
DELETE delete a resource instance
DELETE /{collection name}/{id}
3. 依照由步骤 1, 所分析出 Resource 间的关系, 与由步骤 2, 所对映出的 Http 的方法, 设计出 Resource 的 Endpoint。
4. 依照步骤 3, 所设计出 Resource 的 Endpoint, 设计出 Http 的 Response Codes。
- 微服务架构设计 第八步: 设计微服务对外 REST API
- 微服务架构设计 第七步: 分析微服务对外 API
- 微服务架构设计
- 微服务架构设计 第三步: 微服务的架构方案
- 微服务架构设计 第四步: 分析微服务架构依赖与风险; 开发微服务最关键的一步
- 微服务架构设计 第二步: 分析微服务的边界上下文 (Bounded Context)
- 微服务架构设计 第五步: 微服务的 User Stories 的拆分与澄清
- API gateway---orange下的微服务架构设计
- 微服务架构设计 第六步: 微服务的 User Stories 的分析、设计与定义完成
- 微服务产品级敏捷: 微服务架构设计
- 微服务之Restful API 设计简述
- 微服务架构的设计模式
- 微服务架构的设计模式
- 微服务架构的设计模式
- 微服务架构的设计模式
- 保险o2o微服务架构设计
- 大项目微服务架构设计
- 大项目微服务架构设计
- 文章标题
- python爬虫程序-登录
- windows API 实现精确的打点计时器
- Elevator
- 图之 宽度优先遍历 BFS 邻接表创建的图
- 微服务架构设计 第八步: 设计微服务对外 REST API
- 数学思想 —— 对称性思维
- 第一次面试经历
- Java实现:n个正整数,将它们连接成一排,组成一个最大的多位整数。(输入:n(n个整数),依次输入n个整数)
- 通过学习spring优秀框架来学习设计模式---单例、工厂
- python自学笔记9之模块和类
- LeetCode - Roman to Integer
- 摄像头驱动
- 单片机项目:驱动VS1003模块(二)