美文网首页微服务架构与应用
RESTful 架构 (表现层状态转移)

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

作者: azzgo | 来源:发表于2018-06-18 11:15 被阅读2次

    理解由来

    概念是 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 的角度去设计。这样只要整个流程不变,局部的数据变化,只需要修改后端的相关配置即可,这样业务可以很大程度的配置化。

    相关文章

      网友评论

        本文标题:RESTful 架构 (表现层状态转移)

        本文链接:https://www.haomeiwen.com/subject/qhqneftx.html