REST，以及RESTful的讲解

最新推荐文章于 2024-09-18 09:49:25 发布
最新推荐文章于 2024-09-18 09:49:25 发布
阅读量410 收藏 2
点赞数
分类专栏： java

REST，以及RESTful的讲解

1.传统下的API接口

　　http是目前在互联网上使用最多的协议，没有之一。 
　　可是http的创始人一直都觉得，在过去10几年来，所有的人都在错误的使用Http.这句话怎么说呢？ 
　　如果说你要删除一个数据，以往的做法通常是 delete/{id}　 
　　如果你要更新一个数据，可能是Post数据放Body，然后方法是 update/{id}， 或者是artichle/{id}?method=update　 
　　 这种做法让Roy Fielding很暴燥，他觉得这个世界不该这样的，所有的人都在误解而且在严重错误的误解Http的设计初衷，好比是发明了火药却只用它来做烟花爆竹。 
　　 那么正确的使用方式是什么呢？如果你要看Rest各种特性，你恐怕真的很难理解Rest，但是如果你看错误的使用http的人倒底儿了哪些错，什么是Rest就特别容易理解了。　 
　　 
七宗罪的第一条，混乱。　　

　　 一万个人心里有一万个Url的命名规则，Url是统一资源定位符，重点是资源。而很多人却把它当成了万金油，每一个独立的虚拟的网页都可以随意使用，各种操作都能够迭加。这是混乱的来源之一。 
比如：

https://localhost:8080/myweb/getUserById?id=1
https://localhost:8080/myweb/user/getById?id=1
https://localhost:8080/myweb/x/y?id=1

第二条，贪婪。

　　有状态和无状态全部混在一起。特别是在购物车或者是登录的应用中，经常刷新就丢失带来的用户体验简直棒棒哒。每一个请求并不能单独的响应一些功能，很多的功能混杂在一起里。这是人性贪婪的本质，也是各种Hack的起源，只要能够把问题解决掉，总会有人用他认为最方便的方式去解决问题，比如说汽车门把手坏掉了直接系根绳子当把手，emmmm这样确实很棒啊。 
　　 
第三条，无序。

　　返回的结果往往是很随意，各种错误信息本来就是用Http的状态码构成的，可是很多人还是喜欢把错误信息返回在返回值中。最常见的就是Code和Message，当然对于这一点，我个人是保留疑问的，我的观点是，Http本身的错误和服务器的内部错误还是需要在不断层面分开的，不能混在一起。可是在大神眼里并非如此。

那么怎么解决这些问题呢？　

强迫症患者的福音就是先颁规则，第一个规则就是明确Url是什么，该怎么用。就是所有的Url本质来讲，都应该是一种资源。一个独立的Url地址，就是对应一个独一无二的资源。怎么样？这种感觉是不是棒棒哒？一个冰淇淋，一个老师，一间房子，在Url上对应的都是一个资源，不会有多余的Url跟他对应，也不会表示有多个Url地址　 
　　注意，这里点的是Url地址，并不是单独的参数，他就是一个/room/{room_id}这样的东西，举个栗子,/room/3242 这就表示3242号房间。这是一个清爽的世界啊，你想想，之前的Url是什么都要，我开房，可能是/open/room/3242 我要退房可能是/exit/3242/room，我要打理房间，可能是room/3242?method=clean.够了！这些乱七八糟的东西全够了，让世界回归清爽的本质，一间房，就是/room/3242 没有别的Url地址了。 
　　在过去的混乱世界里，经常用的就是Get和Post。如果不是因为Get不支持大数据传输，我想连Post都不会有人使用。（想像一下Roy Fielding在愤怒的对着电脑屏幕喊，Http的Method一共有八个，你们为毛只逮着Get一只羊的毛薅薅薅薅薅）。

　　而对资源最常见的操作是什么？CRUD，对不对，就是创建，读，更新，删除。再看Http的Method？是不是非常完美？其实也怪Fielding老爷子一开始命名不准确，如果刚开始就是把Get方法叫做Read，Put方法叫做Update，Post叫做Create这该多好。。。 
　　你用一个Get，大家又发现没什么限制没什么所谓，又很难理解Put和Post的差别，法无禁止即可为啊，呃，老爷子不要瞪我，我瞎说的。总之，这四种方法够不够你浪？你有本身找出来更多的对资源的操作来啊，我还有4个Method没用过呢。如果这4个真的不够了，有什么问题，大不了我再重新更改http协议啊。其实简单说，对于Rest理解到这里就够了。后续的东西，都是在这一条基础上空想出来的，比强迫症更强迫症，当然，无状态我是百分百支持的。以上的各种表述可能不太准确，也纯属是我的意淫和各种小道资料，并未考据，但是凭良心讲，我是早就看不惯黑暗年代里的Url命名风格了，所以当时最早接触到Rest的时候，瞬间就找到了真爱，我靠，这不就是我一直想要的答案吗？但是我一直想的仅仅是命名规范，从来没有把自己的思考角度放在一个url就是一个资源，所有的操作都是对资源的更改而言的角度上啊。所以你能理解到的程度，更多的就是在于你要弄清楚你要解决的什么问题，如果你的问题只是理解Rest，恐怕你很理解，如果你的问题是怎么解决Url混乱的问题，你反而很快能弄懂了~

对比

https://localhost:8080/myweb/getDogs --> GET /rest/api/dogs 获取所有小狗狗 
https://localhost:8080/myweb/addDogs --> POST /rest/api/dogs 添加一个小狗狗 
https://localhost:8080/myweb/updateDogs/:dog_id --> PUT /rest/api/dogs/:dog_id 修改一个小狗狗 
https://localhost:8080/myweb/deleteDogs/:dog_id --> DELETE /rest/api/dogs/:dog_id 删除一个小狗狗

左边是我们写的，而且后台我们可能会写出很多返回值，而且各种各样的，比如 
https://localhost:8080/myweb/addDogs

操作成功 或者 1
  •  

或者

操作失败 或者 0
  •  

这还要我们自己去解析，还要前端和后端去协商你返回的0是啥意识啊。但是REST返回值是标准的，比如

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: xxx

{
   "url" : "/api/categories/1",
   "label" : "Food",
   "items_url" : "/api/items?category=1",
   "brands" : [
         {
            "label" : "友臣",
            "brand_key" : "32073",
            "url" : "/api/brands/32073"
         }, {
            "label" : "乐事",
            "brand_key" : "56632",
            "url" : "/api/brands/56632"
         }
         ...
   ]
}

格式固定，第一行永远是操作失败或者成功的状态码，第二行是返回的类型，第三行内容的长度，第五行开始是内容。

这样我只需写一个程序解析返回的信息就可以了，可以重用，但是我们上面传统的不仅仅要协商，还有有不同的解析程序，稍微改变，就不能正常使用了。所以rest的明显更加通用。

列子2

1、获取文章

请求：
GET /blog/post/{postId} HTTP/1.1

响应：
HTTP/1.1 200 OK
{
    "title": "foobar",
    "content": "foobar",
    "comments": ["", "", ""]
}

2、发布文章

请求：
POST /blog/post HTTP/1.1
{
    "title": "foobar",
    "content": "foobar",
    "comments": ["", "", ""]
}

响应：
HTTP/1.1 201 CREATED

规则

GET    用来获取资源，
POST  用来新建资源（也可以用于更新资源），
PUT    用来更新资源，
DELETE  用来删除资源

例子

DELETE http://api.qc.com/v1/friends: 删除某人的好友 （在http parameter指定好友id）
POST http://api.qc.com/v1/friends: 添加好友UPDATE 
http://api.qc.com/v1/profile: 更新个人资料

概念

REST 是面向资源的，这个概念非常重要，而资源是通过 URI 进行暴露。 
URI 的设计只要负责把资源通过合理方式暴露出来就可以了。对资源的操作与它无关，操作是通过 HTTP动词来体现，所以REST 通过 URI 暴露资源时，会强调不要在 URI 中出现动词。

比如：左边是错误的设计，而右边是正确的

GET /rest/api/getDogs --> GET /rest/api/dogs 获取所有小狗狗 
GET /rest/api/addDogs --> POST /rest/api/dogs 添加一个小狗狗 
GET /rest/api/editDogs/:dog_id --> PUT /rest/api/dogs/:dog_id 修改一个小狗狗 
GET /rest/api/deleteDogs/:dog_id --> DELETE /rest/api/dogs/:dog_id 删除一个小狗狗

REST很好地利用了HTTP本身就有的一些特征，如HTTP动词、HTTP状态码、HTTP报头等等 
REST API 是基于 HTTP的，所以你的API应该去使用 HTTP的一些标准。这样所有的HTTP客户端（如浏览器）才能够直接理解你的API（当然还有其他好处，如利于缓存等等）。REST 实际上也非常强调应该利用好 HTTP本来就有的特征，而不是只把 HTTP当成一个传输层这么简单了。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: xxx

{
   "url" : "/api/categories/1",
   "label" : "Food",
   "items_url" : "/api/items?category=1",
   "brands" : [
         {
            "label" : "友臣",
            "brand_key" : "32073",
            "url" : "/api/brands/32073"
         }, {
            "label" : "乐事",
            "brand_key" : "56632",
            "url" : "/api/brands/56632"
         }
         ...
   ]
}

看这个响应，包含了http里面的状态码等信息。还会有http的一些报头。

Authorization 认证报头 
Cache-Control 缓存报头 
Cnotent-Type  消息体类型报头 
......

REST 系统的特征

  1. 客户-服务器（Client-Server），提供服务的服务器和使用服务的客户需要被隔离对待。
  2. 无状态（Stateless），来自客户的每一个请求必须包含服务器处理该请求所需的所有信息。换句话说，服务器端不能存储来自某个客户的某个请求中的信息，并在该客户的其他请求中使用。
  3. 可缓存（Cachable），服务器必须让客户知道请求是否可以被缓存。（Ross：更详细解释请参考 理解本真的REST架构风格 以及 StackOverflow 的这个问题 中对缓存的解释。）
  4. 分层系统（Layered System），服务器和客户之间的通信必须被这样标准化：允许服务器和客户之间的中间层（Ross：代理，网关等）可以代替服务器对客户的请求进行回应，而且这些对客户来说不需要特别支持。
  5. 统一接口（Uniform Interface），客户和服务器之间通信的方法必须是统一化的。（Ross：GET,POST,PUT.DELETE, etc）
  6. 支持按需代码（Code-On-Demand，可选），服务器可以提供一些代码或者脚本（Ross：Javascrpt，flash，etc）并在客户的运行环境中执行。这条准则是这些准则中唯一不必必须满足的一条。（Ross：比如客户可以在客户端下载脚本生成密码访问服务器。）

详细解释

无状态（Stateless）

　　 所谓无状态的，即所有的资源，都可以通过URI定位，而且这个定位与其他资源无关，也不会因为其他资源的变化而改变。有状态和无状态的区别，举个简单的例子说明一下。如查询员工的工资，如果查询工资是需要登录系统，进入查询工资的页面，执行相关操作后，获取工资的多少，则这种情况是有状态的，因为查询工资的每一步操作都依赖于前一步操作，只要前置操作不成功，后续操作就无法执行；如果输入一个url即可得到指定员工的工资，则这种情况是无状态的，因为获取工资不依赖于其他资源或状态，且这种情况下，员工工资是一个资源，由一个url与之对应，可以通过HTTP中的GET方法得到资源，这是典型的RESTful风格。

这里写图片描述　

这里写图片描述　

统一接口（Uniform Interface）

　　RESTful架构风格规定，数据的元操作，即CRUD(create, read, update和delete,即数据的增删查改)操作，分别对应于HTTP方法：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源，这样就统一了数据操作的接口，仅通过HTTP方法，就可以完成对数据的所有增删查改工作。

即：

GET（SELECT）：从服务器取出资源（一项或多项）。
POST（CREATE）：在服务器新建一个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供完整资源数据）。
PATCH（UPDATE）：在服务器更新资源（客户端提供需要修改的资源数据）。
DELETE（DELETE）：从服务器删除资源。

演化

https://zhuanlan.zhihu.com/p/30396391?group_id=937244108725641216

优点&缺点

优点是因为他对uri进行了限制，只用于定义资源。这样看起来比较容易理解。尤其是对简单的对象的增删改查，很好理解。

缺点是因为这种限制，导致设计uri变得复杂了。尤其是复杂的关系，操作，资源集合，硬性套用rest原则设计非常困难。在rest基础上的HATEOAS，返回的json里增加了相应的关系和url。这也同样带来问题。好处是对简单的关系，的确可以通过url进一步处理。但对复杂的关系和操作，HATEOAS并不能胜任描述。反而在单纯的数据中增加了一堆垃圾信息。

是什么？

REST是一个标准，一种规范，遵循REST风格可以使开发的接口通用，便于调用者理解接口的作用。

参考： 
https://www.zhihu.com/question/28557115 
https://blog.igevin.info/posts/restful-architecture-in-general/

无恋-zx
关注
专栏目录
Spring Boot实现RESTful接口架构实战（包括REST的讲解、定义、REST服务测试）
showswoller的博客
10-25 2665
Spring Boot实现RESTful接口架构实战（包括REST的讲解、定义、REST服务测试） 包括Spring Boot中RESTful的使用
REST和RESTFul
XiaoCai
09-01 482
        REST是在做Web时常常听说的一个出现了很久的概念，REST的全称是Representational State Transfer即表述性状态转移，Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。它是一种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩性。         提到R
Web后端开发技术：RESTful 架构详解
最新发布
百锦再的博客
09-18 2万+
RESTful 是一种基于（表述性状态转移，Representational State Transfer）架构风格的 API 设计方式，通常用于构建，特别是在 Web 应用开发中广泛应用。REST 是一种轻量级的架构模式，利用标准的 HTTP 协议来实现服务器和客户端之间的通信。RESTful API 是基于资源的操作，通过 URI（统一资源标识符）定位资源，通过 HTTP 方法（GET、POST、PUT、DELETE 等）操作资源，并使用标准的 HTTP 状态码来反馈操作结果。
REST和RESTful
06-02 172
REST是什么？ REST（Representational State Transfer，表述性状态转移）是一种架构风格。 REST原则： 1）网络上所有事物都被抽象为资源； 2）每个资源都有一个唯一的资源标识符； 3）同一个资源具有多种变现形式（xml，json等）； 4）对资源的各种操作不会改变资源标识符； 5）所有的操作都是无状态的（基于http协议） RESTful...
rest和restful
wade3po的博客
10-29 215
开发了那么久，对接接口已经很老练了，但是对于rest和restful概念真的没有听过，而且也没有用过get、post之外的方法。 rest： 客户端和服务器之间的交互在请求之间是无状态的。从客户端到服务器的每个请求都必须包含理解请求所必需的信息。此外，无状态请求可以由任何可用服务器回答。所有资源都共享统一的接口，以便在客户端和服务器之间传输状态。使用的是标准的 HTTP 方法，比如 GET、PUT...
REST、RESTful
m0_61393322的博客
01-14 189
rest是面向资源的，通过rest去获取资源，而资源的位置是通过uri来找到的，所以要求uri地址中不存在动词，通过HTTP动词对资源进行操作，比如get、post、put、delete，使用一种的标准的统一风格。 restful就是基于rest 而实现的api，就叫restful风格，去使用HTTP的一些标准，比如说返回响应的格式：第一行是操作完成后的状态码，告诉你是成功还是失败了；第二行是返回的类型；第三行是内容的长度，第五行开始是内容。 这样约定了统一的格式以后，使用起来就比较方便，大家不会起冲突
一个简单的Restful例子以及讲解
06-12
### 一个简单的RESTful例子及深入讲解 #### REST简介与核心概念 REST（Representational State Transfer，表象性状态转移）是一种软件架构风格，尤其适用于Web服务的设计。它利用现有的互联网标准和技术，如HTTP、...
利用Django REST framework构建RESTful Web API
mukewangguanfang的博客
05-25 516
这一次，我们以师生管理系统为例，带领大家搭建一套 framework Web API。“工欲善其事，必先利其器”，我们选用当下最为流行的 Django REST framework 为工具，快速实现这套API。
spring-3.0-应用springmvc-构造RESTful-URL-详细讲解
09-24
在本文中，我们将深入探讨如何在Spring 3.0中应用Spring MVC来构建RESTful URL，以实现更加优雅和功能强大的Web服务。REST（Representational State Transfer）是一种架构风格，用于构建基于HTTP协议的Web服务，它...
什么是rest? 什么是restful? 傻傻分不清楚。。
热门推荐
Haines
03-21 3万+
一.概念和区别：1.关于restrest :representational state transfer 表述性状态转移,是一种架构风格。rest原则： <1>网络上的所有事物都被抽象为资源 <2> 每个资源都有一个唯一的资源标识符 <3> 同一个资源具有多种表现形式(xml,json等) <4> 对资源的各种操作不会...
RESTful 架构详解
科大浪子的专栏
07-28 3729
1. 什么是REST REST全称是Representational State Transfer，中文意思是表述（编者注：通常译为表征）性状态转移。 它首次出现在2000年Roy Fielding的博士论文中，Roy Fielding是HTTP规范的主要编写者之一。 他在论文中提到："我这篇文章的写作目的，就是想在符合架构原理的前提下，理解和评估以网络为基础的应用软件的架构设计，得
【RESTful】REST 与 RESTful 理解与实践
Fxtack的博客
05-17 1636
REST 与 RESTful 介绍与理解 文章目录REST 与 RESTful 介绍与理解一. REST 与 RESTful 简介二. REST 架构原则 一. REST 与 RESTful 简介 REST 全称表述性状态转移（Representational State Transfer）。是 Roy Fielding 博士在 2000 年发表的博士论文中提出的一种软件架构风格。REST 是一种针对于 Web Application 的设计和开发方式，其可以降低开发的复杂性，提高系统的可扩展性。RES
关于REST和restful
weixin_30522095的博客
03-14 143
什么是REST Representational State Transfer 越来越多的人开始意识到，网站即软件，而且是一种新型的软件。 这种"互联网软件"采用客户端/服务器模式，建立在分布式体系上，通过互联网通信，具有高延时（high latency）、高并发等特点。 网站开发，完全可以采用软件开发的模式。但是传统上，软件和网络是两个不同的领域，很少有交集；软件开发主要针对单机环境，网...
REST、RESTful风格
路漫漫其修远兮，吾将上下而求索。小手点一波关注进阶的李仙桎，我们一起携手进步，
06-13 669
REST（英文：Representational State Transfer，简称REST）一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。REST 指的是一组架构（约束条件）和原则。满足这些（约束条件）和（原则）的应用程序或设计就是 RESTful。
Rest和Restful的知识整理
as6950426a的博客
05-28 417
Rest和Restful的汇总Rest Rest Rest是REpresentational State Transfer的缩写（一般中文翻译为表述性状态转移），Rest是一种体系结构，而HTTP是一种包含Rest架构属性的协议 表述性（REpresenttational）：REST资源实际上可以用各种形式来进行表述，包括XML、JSON和HTML—最适合资源使用者的任意形式。 状态（State...
rest和restful的理解
weixin_40821669的博客
07-17 373
一、什么是REST REST（Representational State Transfer）：表现层状态转移，一种软件架构风格。 什么是表现层状态转移：  Representational （表现层）  State Transfer（状态转移）：通过HTTP动词实现。 总结：通过url地址拼接上HTTP的动词（GET，POST，PUT，DELETE）来操作资源，进行增删改查。 ...
REST和RESTful的区别
一条杂鱼的博客
04-25 2696
REST和RESTful的区别
REST和RESTFUL简单说
Osborn的博客
07-24 607
1.REST ( REpresentational State Transfer )，State Transfer 为 "状态传输"     REST是一种架构设计风格的约束条件和原则。与开发语言无关。满足这些约束条件和原则的应用程序或设计就是 RESTful。 其核心是面向资源，REST专门针对网络应用设计和开发方式，以降低开发的复杂性，提高系统的可伸缩性。    REST提出设计理念
Jersey 实现 RESTful Web 服务指南
1. **REST基础**：解释REST的基本原则和约束，如客户端-服务器、无状态、缓存、统一接口等，以及它们如何提高系统的可扩展性和性能。 2. **Jersey入门**：介绍如何设置开发环境，创建第一个Jersey应用，包括项目...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值