Home 系统架构 REST深度好文笔记

REST深度好文笔记

0 56

REST简介 – loveis715 – 博客园 (cnblogs.com)

 

大纲:

一、文章介绍

二、REST的示例

  1. REST的五大约束
    • 使用客户/服务器模型
    • 层次化的系统
    • 无状态
    • 可缓存
    • 统一的接口(其有四大子约束)
      • 每个资源都拥有一个资源标识
      • 消息的自描述性
      • 资源的自描述性
      • HATEOAS

三、REST的定义

  1. 资源识别
    • 如何抽象资源(自顶向下)
    • 判断一个资源是主资源还是子资源(看它是否能独立地表示其具体含义)
    • 如何判断为REST服务所定义的资源是否合理
      • 我们需要考虑对该资源的CRUD是否有意义,从而验证资源的定义是否合理。
      • 其次,我们需要检查资源是否需要除CRUD之外的动词来操作。
      • 除此之外,我们还需要检查这些资源是否是被整体使用,创建和删除。

四、资源的URL设计

  1. URL的组成
    • 协议
    • 主机名和断开
    • 资源的相对路径
    • 请求参数
  2. 通过URL来表示资源
  3. 资源在URL中需要由单数表示还是复数表示
  4. 相对路径 vs. 请求参数

 

五、合适的动词

  1. PUT和POST
    • POST动词会在目标URI之下创建一个新的子资源
    • PUT则是根据请求创建或修改特定位置的资源
  2. 两者都有创建的含义,但是意义却不同。在决定到底是使用PUT还是POST来创建资源的时候,软件开发人员需要考虑一系列问题
    • 首先就是资源的ID是如何生成的。
    • 另外一个需要考虑的因素则是PUT的等幂性是否对REST系统的设计有所帮助。(这在网络丢包较为严重时是一个非常好的功能。反过来,在同一个URI上调用两次POST将可能创建两个独立的子资源。
    • 除此之外,还需要考虑是否将资源的创建和更新归结为一个API可以简化用户对REST服务的使用。(用户可以通过PUT动词来同时完成创建和更新一个资源这两种不同的任务。这样的好处在于简化了REST服务所提供的接口,但是反过来也让一个API执行了两种不同的任务,在一定程度上违反了API设计时每个API都需要有明确的意义这一原则。
  3. PUT和PATCH(两者之间的不同则在于PUT是对整个资源的更新,而PATCH则是对部分资源的更新。而该动词的局限性则在于对该动词的支持程度。

 

六、使用标志的状态码

七、选择适当的表示结构

八、负载的自描述性

九、无状态约束

十、Authentication

十一、版本管理

十二、性能

发表评论

发表评论