什么是RESTful

Posted 2023-03-13

参考技术A 先看REST是什么意思，英文Representational state transfer 表述性状态转移 其实就是对 资源 的表述性状态转移。
简单的说：RESTful是一种架构的规范与约束、原则，符合这种规范的架构就是RESTful架构。

资源的地址 在web中就是URL （统一资源标识符）
资源是REST系统的核心概念。 所有的设计都是以资源为中心

结合项目怎么识别资源
1.商品加入购物车 购物车
2.提交订单 订单
3.创建用户 用户

围绕资源进行 添加，获取，修改，删除，以及对符合特定条件的资源进行列表操作 。针对资源设计接口

RESTful 架构的核心规范与约束：统一接口
分为四个子约束：
1.每个资源都拥有一个资源标识，每个资源的资源标识可以用来唯一地标明该资源
2.消息的自描述性
3.资源的自描述性。
4.HATEOAS Hypermedia As The Engine Of Application State(超媒体作为应用状态引擎)
即客户只可以通过服务端所返回各结果中所包含的信息来得到下一步操作所需要的信息，如到底是向哪个URL发送请求等。也就是说，一个典型的REST服务不需要额外的文档标示通过哪些URL访问特定类型的资源，而是通过服务端返回的响应来标示到底能在该资源上执行什么样的操作

目的：实现客户端无需借助任何文档即能调用到所有的服务器资源

三、资源的URL设计
1.通过URL来表示资源
资源分为主资源与子资源
因为主资源是一类独立的资源 所以主资源应直接放在相对路径下：例如
若要表示主资源的实例：如果实例的ID=1，则这样表示： /goods/1
子资源：
一个实例的子资源可能是一个集合也可能是一个单一的子资源
子资源为图片集合：/goods/1/pictures
子资源为商品折扣的单子子资源：/goods/1/discount
2.单数 vs. 复数
获取用户1的信息，哪种方式更符合RESTful?
/api/users/1
/api/user/1
3.相对路径 vs. 请求参数
极光的RESTful API:
获取用户信息 GET /v1/users/username 参数放在路径中
VS
获取用户信息 GET /v1/users?username=xxxxx 拼接的方式

获取应用管理员列表 GET /v1/admins?start=start&count=count ？后拼接参数的方式：这种方式一般作为过滤资源

4.使用合适的动词 get delete put post

选择请求接口的方式： get delete
PUT 在服务器更新资源（客户端提供改变后的完整资源）。
POST 在服务器新建一个资源

5.使用标准的状态码
GET

hello world!!!

什么是RESTFUL？REST的请求方法有哪些，有什么区别？

这里是修真院前端小课堂，每篇分享文从

【背景介绍】【知识剖析】【常见问题】【解决方案】【编码实战】【扩展思考】【更多讨论】【参考文献】

八个方面深度解析前端知识/技能，本篇分享的是：

【什么是RESTFUL？REST的请求方法有哪些，有什么区别？】

1.背景介绍
restFul是符合rest架构风格的网络API接口,完全承认Http是用于标识资源。restFul URL是面向资源的，可以唯一标识和定位资源。 对于该URL标识的资源做何种操作是由Http方法决定的。 rest请求方法有4种，包括get,post,put,delete.分别对应获取资源，添加资源，更新资源及删除资源.

?

2.知识剖析
如何编写符合rest架构风格的restful?

?

1.URL中不可出现动词

?

2.URL能够唯一地标识单个或一类资源

3.通过Http动词去操作URL标识的资源(get(获取),pst(添加),put(更新),delete(删除))

错误写法示例

?

错误写法

该网络API接口URL中使用了动词，并没有做到只标识和定位资源

正确写法示例

正确写法

该网络API接口URL仅标识和定位资源,通过Http方法Post表明是一个添加资源的处理器

REST请求方法解析

?

GET

get方法在Rest中主要用于获取资源，能够发送参数，不过有限制，且参数都会以?开头的形 式附加在URL尾部

?

?

?

get参数

因为参数信息会完全暴露，因此是不推荐发送重要信息的。get方法产生一个tcp数据报一次发送完毕。

规范的get方法处理器应该是幂等的，也就是说对一个资源不论发送多少次get请求都不会更改数据或造成破坏。

应该在编写处理器的时候保证幂等从而提高安全性

POST

post方法在Rest请求中主要用于添加资源，参数信息存放在请求报文的消息体中相对安全，且可发送较大信息

post因为参数信息存在方消息体中相对安全，一般用于发送重要数据，且post产生两个tcp数据报需要发送两次完成

对于get和post的本质区别该博客写的非常好

规范化的post方法处理器是不幂等的，因此如果用户重复对一个资源进行post应该在处理器中做出限制和处理保证对数据不造成破坏和更改 从而提高安全性.get和post本质区别

PUT

put方法在Rest中主要用于更新资源，因为大多数浏览器不支持put和delete，会自动将put和delete请求转化为get和post. 因此为了使用put和delete方法,需要以post发送请求，在表单中使用隐藏域发送真正的请求。

put方法的参数是同post一样是存放在消息中的，同样具有安全性，可发送较大信息。

put方法是幂等的，对同一URL资源做出的同一数据的任意次put请求其对数据的改变都是一致的。比如更新/student/2的name值为bobdylan

不论提交该请求多少次，/student/2资源的name值会于提交一次请求无异

DELETE

Delete在Rest请求中主要用于删除资源，因为大多数浏览器不支持put和delete，会自动将put和delete请求转化为get和post.因此为了使用put和delete方法,需要以post发送请求，在表单中使用隐藏域发送真正的请求。

Delete方法的参数同post一样存放在消息体中,具有安全性，可发送较大信息 Delete方法是幂等的，不论对同一个资源进行多少次delete请求都不会破坏数据

?

3.常见问题
浏览器自动转化PUT和DELETE为GET和POST,容器找不到对应的处理器报错

rest风格规定URL标识资源，使用Http的四个方法对资源进行操作。但在浏览器发送请求时会自动将put和post 转化为get和post.这样rest风格就成了鸡肋，且发送请求会报错说找不到get方法或post方法。

为什么不支持delete和put方法是因为html4官方在表单中仅支持get和post方法,忽略了Put和Delete以及其他Http方法. 尽管在html5和一些新的浏览器支持所有的http方法，但不可能所有用户都使用最新的浏览器。

4.解决方案
1.首先第一种是前端人员通过ajax发送，因为不懂前端所以不详述

2.通过在form表单中使用隐藏域在服务器端配置过滤器来发送真实请求

3.使用Spring的sf:form表单来提交

第一种就不详述了

第二种在编码实战中进行演示

第三种方法因为资料不全，是在Spring实战这本书中看到的，自己尝试实现失败了。见Spring实战这本书305页

?

5.编码实战
PPT地址：PPT

视频地址：视频

6.扩展思考
7.参考文献
参考一: get和post的本质区别

参考二: SpringMvc中发送put和Delete请求

参考三: Spring实战第11章305页《提交RestFul表单》

8.更多讨论
?

?

今天的分享就到这里啦，欢迎大家点赞、转发、留言、拍砖~

?

?

技能树.IT修真院“我们相信人人都可以成为一个工程师，现在开始，找个师兄，带你入门，掌控自己学习的节奏，学习的路上不再迷茫”。

这里是技能树.IT修真院，成千上万的师兄在这里找到了自己的学习路线，学习透明化，成长可见化，师兄1对1免费指导。快来与我一起学习吧~我的邀请码：15568671，或者你可以直接点击此链接：http://www.jnshu.com/login/1/...

?

“我们相信人人都可以成为一个工程师，现在开始，找个师兄，带你入门，学习的路上不再迷茫。

这里是技能树.IT修真院：http://www.jnshu.com，初学者转行到互联网行业的聚集地。"

欢迎加IT交流群565734203与大家一起讨论交流