RESTful 架构

系统管理员 2023-10-07 11:37 103阅读 0赞

起源

REST(Representational State Transfer,表现层状态转换)是 Roy Thomas Fielding 博士于 2000 年在他的博士论文 Architectural Styles and the Design of Network-based Software Architectures 中提出。

理解

直译版本

Representation:表现
State:状态
Transfer:转换

将上述三者连起来:表现层的状态转换,是不是有点拗口,毕竟 缺少个主语。那么,继续读下文就可以了。

意译版本

Resources:资源
Representation:表现
State:状态
Transfer:转换

将缺少的主语 Resources(资源)补充上连起来再读,资源表现层的状态转换。是不是比之前读起来舒服多了。再将各个单词解释下:

  1. Resources:资源。网络上传输的各项数据,比如文本,图片。
  2. Representation:表现。资源有多种表现形式,比如文本可以有 txt 格式、XML 格式;图片有 jpg 格式。
  3. State Transfer:状态转换。对保存在服务器端的资源及其状态利用 HTTP 方法 进行修改,比如 GET、POST、DELETE、PUT。

强调下:是资源在网络传输中进行的表现形式的转换。

好处

  1. 通过看 RESTful API 你可以看到 URI+HTTP Method,即「要什么+做什么」;
  2. 通过看 HTTP Status Code 你就可以知道结果如何。

技巧

  1. 使用 _- 来让 URI 可读性更好,推荐使用 -
  2. 使用 / 来表示资源的层级关系;
  3. 使用 ? 来过滤资源;
  4. ,; 可以用来表示同级资源的关系。

误区

  1. URI 包含动词;
  2. URI 中有版本号。

推荐阅读

“一把梭:REST API 全用 POST” (强烈推荐)

RESTful 架构详解

理解RESTful架构

面向资源编程-RESTful风格

RESTful API Design. Best Practices in a Nutshell.

[译] RESTful API 设计最佳实践

WEB开发中,使用JSON-RPC好,还是RESTful API好

发表评论

表情:
评论列表 (有 0 条评论,103人围观)

还没有评论,来说两句吧...

相关阅读

    相关 理解RESTful架构

    作者: [阮一峰][Link 1] 日期: [2011年9月12日][2011_9_12] 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。 这种"互联网软件"

    相关 restful架构

    1、概念 RESTful(Representational State Transfer)表现层状态转化,他省略了主语:资源。可以从3个方面来理解它:资源、表现层、转化。

    相关 理解RESTful架构

    转自:http://www.ruanyifeng.com/blog/2011/09/restful.html 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。 这

    相关 理解RESTful架构

    越来越多的人开始意识到,网站即软件,而且是一种新型的软件。 这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency