微服务架构与应用

RESTful 架构 (表现层状态转移)

2018-06-18  本文已影响2人  azzgo

理解由来

概念是 Roy Thomas Fielding在他2000年的博士论文中提出的。他参与制定了 HTTP 1.0 和 HTTP 1.1 协议。

他希望能基于网络现有的协议基础上创建一个功能强大,性能游戏,适宜通信的架构。

概念

客户端 - 服务器分离(Client - Server)

如含义一样,将从逻辑上将业务实现拆分为客户端与服务端实现。

通过分离设计,能简化两边的设计复杂度,提高其可扩展性。

资源(Resources)

资源是 RESTful 的主体,主要指代互联网上的一个实体,可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的实在。资源通过 URI 来唯一标识。

表现层(Representation)

资源的信息载体形式,叫做表现层。他可以是文本、XML、JSON 或者是一个二进制文件。它的具体表现形式,应该在HTTP请求的头信息中用Accept和Content-Type字段指定,这两个字段才是对"表现层"的描述。

状态转化(State Transfer)

互联网通信协议HTTP协议,是一个无状态协议。这意味着,所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生"状态转化"(State Transfer)。而这种转化是建立在表现层之上的,所以就是"表现层状态转化"。

在 HTTP 中,我们一般通过四种 HTTP 动词(verb)来对应资源的变化:GET用来获取资源,POST用来新建资源(也可以用于更新资源),PUT用来更新资源,DELETE用来删除资源。

相应的状态的交互应当是无状态的(ServerLess)这是 HTTP 的特性所决定的,要求每次请求包含服务器需要的所有信息,这样可以很好的确保每一次变化的可预测性,进而提高可靠性,也能增进可扩展性。

综述

综合上面的解释,我们总结一下什么是RESTful架构:

(1)每一个URI代表一种资源;

(2)客户端和服务器之间,传递这种资源的某种表现层;

(3)客户端通过四个HTTP动词,对服务器端资源进行操作,实现"表现层状态转化"。

HTTP 与 RESTful

HTTP 请求是互联网架构中重要的一环,其在 TCP 连接的基础上,实现了语义化,缓存机制,无状态等等特性。在互联网上也有不错的性能,REST 常常会基于 HTTP 协议的基础上实现其核心概念。

论文中对 HTTP 与 REST 相适宜的论述提及了几点:

  1. 可扩展性:主要是协议的 method,返回状态码,协议向下兼容性
  2. 自我信息描述:主要是从 URI 能准确定义资源,Content-type HTTP 头能准确定义表现层,还有相关语义化的 HTTP 头。
  3. 性能:主要从 HTTP 高于网络层,在实现上能复用 TCP 连接,减少 TCP 建立与销毁的时间成本。还有就是 HTTP 其容易缓存的特性。

这里是论文中对 HTTP Code 来表现业务相应状态的相关表述:

论文中关于 HTTP 状态码与 RESTful 适配的论述

Matin Fowler 关于 RESTful 的成熟度模型

原文: https://martinfowler.com/articles/richardsonMaturityModel.html

他讲这个模型层次分为四级,大概如下所示:

RESTful 成熟度模型

Level 0

利用 HTTP 协议做数据交换,所有的参数描述通过 url 或者 POST body 形式通知服务器,返回相应的数据,此级别通常都是基于 。实质上就是基于 HTTP 的 RPC(远程过程调用),具体交付的细节完全由相关规范或团队内部约定解决。

根据理解设计了一份请求交互:

POST /apiService

{
    "action": "bookMeeting",
    "roomID": "Roma",
    "guestIDs": ["Roy", "Tom"],
    "from": "201805221400",
    "to": "201805221500"
}

------- Response

{
    "status": "succuess",
    "guestIDs": ["Roy", "Tom"],
    "meetingID": "201805221400-201805221500-Roma"
}

Level 1

将 API 按照 RESTful 中资源的方式进行划分,初步有了自我描述(self description)的特性了,客户端可以对相关的资源进行更加细致的操作。

根据理解设计了一份请求交互:

POST /apiService/room/Roma

{
    "action": "bookMeeting",
    "guestIDs": ["Roy", "Tom"],
    "from": "201805221400",
    "to": "201805221500"
}

------- Response

{
    "status": "succuess",
    "guestIDs": ["Roy", "Tom"],
    "meetingID": "201805221400-201805221500-Roma"
}

Level 2

这个级别有更加进一步的利用了 HTTP 的特性,增加了对 HTTP verb (比如 GET 表示查询、POST 表示创建、PUT 表示修改、DELETE 表示 等等)的运用,并且运用原有的 HTTP response status 来表征业务上请求的成功与失败,一般项目常见的 RESTful 运用基本都接近这个级别。

这个请求基本就和我们平时使用的 RESTful api 很接近了:

POST /apiService/room/Roma

{
    "guestIDs": ["Roy", "Tom"],
    "from": "201805221400",
    "to": "201805221500"
}

------- Response

status: 201

{
    "guestIDs": ["Roy", "Tom"],
    "meetingID": "201805221400-201805221500-Roma"
}

Level 3

这个基本也称作 HATEOAS (Hypertext As The Engine Of Application State),这个级别是 RESTful 最复杂的实现,这个级别最理想的情况是,不需要特别复杂 API 文档进行描述的,这里的 API 设计最大化的实现了 RESTful 的自我描述特性。这种方案虽然引入很大的复杂性,但是最大限度的将 API 设计变得配置化了,所有 API 设计将会基于更加抽象的工作流设计了,稍后再做解释:

本阶段的相关请求模型大概是这样的:

GET /apiService/room

---- Response
{
    roomList: [
        {
            meetingID: "Roma",
            __link: [
                {
                    method: "POST",
                    url: "/apiService/room/Roma",
                    parameters: {
                        guestIDs: "[guestID]",
                        from: "timestamp",
                        to: "timestamp"
                    }
                }
            ]
        },
        ...
    ]
}


------------


POST /apiService/room/Roma

{
    "guestIDs": ["Roy", "Tom"],
    "from": "201805221400",
    "to": "201805221500"
}

------- Response

status: 201

{
    "meetingID": "201805221400-201805221500-Roma"
    _links: [
        {
            url: '/apiService/meeting/201805221400-201805221500-Roma',
            methos: 'GET'
        },
        ...
    ]
}

可以看出,从查询到最终结果,都是由第一个 api 的返回的资源列表和操作项,引导向后面的操作,这样,后端在设计 API 的时候,需要考虑从一条业务 workflow 的角度去设计。这样只要整个流程不变,局部的数据变化,只需要修改后端的相关配置即可,这样业务可以很大程度的配置化。

上一篇下一篇

猜你喜欢

热点阅读