浅谈RESTful

最新推荐文章于 2025-11-26 15:59:01 发布
原创 最新推荐文章于 2025-11-26 15:59:01 发布 · 72 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#restful #后端 #java #开发语言

点击蓝色字关注我们！

一个努力中的公众号

长的好看的人都关注了

1b83566f46949fead4fdb2f129ed41b8.png

一.什么是RESTful 面向资源

简单的说：RESTful是一种架构的规范与约束、原则，符合这种规范的架构就是RESTful架构。

先看REST是什么意思，英文Representational state transfer 表述性状态转移 其实就是对 资源 的表述性状态转移。

（什么是表述性：就是指客户端请求一个资源，服务器拿到的这个资源，就是表述）

资源的地址 在web中就是URL （统一资源标识符）

资源是REST系统的核心概念。 所有的设计都是以资源为中心

结合项目怎么识别资源

1.商品加入购物车 购物车

2.提交订单 订单

3.创建用户 用户

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

二.关于规范与约束有哪些？

RESTful 架构的核心规范与约束：统一接口

分为四个子约束：

1.每个资源都拥有一个资源标识，每个资源的资源标识可以用来唯一地标明该资源

2.消息的自描述性

3.资源的自描述性。

4.HATEOAS Hypermedia As The Engine Of Application State(超媒体作为应用状态引擎)

即客户只可以通过服务端所返回各结果中所包含的信息来得到下一步操作所需要的信息，如到底是向哪个URL发送请求等。也就是说，一个典型的REST服务不需要额外的文档标示通过哪些URL访问特定类型的资源，而是通过服务端返回的响应来标示到底能在该资源上执行什么样的操作

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

 643571d1a804bb9e07548cd3b07a547d.jpeg

三、资源的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

  • 安全且幂等

  • 获取表示

  • 变更时获取表示（缓存）

  • 200（OK） - 表示已在响应中发出

  • 204（无内容） - 资源有空表示

  • 301（Moved Permanently） - 资源的URI已被更新

  • 303（See Other） - 其他（如，负载均衡）

  • 304（not modified）- 资源未更改（缓存）

  • 400 （bad request）- 指代坏请求（如，参数错误）

  • 404 （not found）- 资源不存在

  • 406 （not acceptable）- 服务端不支持所需表示

  • 500 （internal server error）- 通用错误响应

  • 503 （Service Unavailable）- 服务端当前无法处理请求

  • POST

    PUT

    DELETE

    • 301 （Moved Permanently）- 资源的URI已更改

    • 303 （See Other）- 其他，如负载均衡

    • 400 （bad request）- 指代坏请求

    • 404 （not found）- 资源不存在

    • 409 （conflict）- 通用冲突

    • 500 （internal server error）- 通用错误响应

    • 503 （Service Unavailable）- 服务端当前无法处理请求

    • 200 （OK）- 资源已被删除

    • 不安全但幂等

    • 删除资源

    • 201 （created）- 如果新资源被创建

    • 301（Moved Permanently）- 资源的URI已更改

    • 303 （See Other）- 其他（如，负载均衡）

    • 400 （bad request）- 指代坏请求

    • 404 （not found）- 资源不存在

    • 406 （not acceptable）- 服务端不支持所需表示

    • 409 （conflict）- 通用冲突

    • 412 （Precondition Failed）- 前置条件失败（如执行条件更新时的冲突）

    • 415 （unsupported media type）- 接受到的表示不受支持

    • 500 （internal server error）- 通用错误响应

    • 503 （Service Unavailable）- 服务当前无法处理请求

    • 200 （OK）- 如果已存在资源被更改

    • 不安全但幂等

    • 用客户端管理的实例号创建一个资源

    • 通过替换的方式更新资源

    • 如果未被修改，则更新资源（乐观锁）

    • 201（created）- 如果新资源被创建

    • 202（accepted）- 已接受处理请求但尚未完成（异步处理）

    • 301（Moved Permanently）- 资源的URI被更新

    • 303（See Other）- 其他（如，负载均衡）

    • 400（bad request）- 指代坏请求

    • 404 （not found）- 资源不存在

    • 406 （not acceptable）- 服务端不支持所需表示

    • 409 （conflict）- 通用冲突

    • 412 （Precondition Failed）- 前置条件失败（如执行条件更新时的冲突）

    • 415 （unsupported media type）- 接受到的表示不受支持

    • 500 （internal server error）- 通用错误响应

    • 503 （Service Unavailable）- 服务当前无法处理请求

    • 200（OK）- 如果现有资源已被更改

    • 不安全且不幂等

    • 使用服务端管理的（自动产生）的实例号创建资源

    • 创建子资源

    • 部分更新资源

    • 如果没有被修改，则不过更新资源（乐观锁）

  • 6.选择适当的表示结构

    json   xml

    7. 版本控制

    例如：e79e08e30708bf4c0e8b73a5512251b9.png

添加小编微信，加入技术交流群or招聘交流群

QQ千人技术交流群: 710566091   一起学习一起成长

浅谈java调用Restful API接口的方式
08-28
"Java调用Restful API接口的方式" Java调用Restful API接口是Java开发中非常重要的一部分，了解Java调用Restful API接口的方式可以帮助开发者更好地理解和使用相关技术。本文将详细介绍Java调用Restful API接口的...
浅谈go-restful框架的使用和实现
09-20
go-restful框架是用Google Go语言编写的REST风格Web服务开发包，它遵循REST（Representational State Transfer）原则，即表现层状态转换的网络架构风格。REST架构风格在近年来被广泛应用于网络中client-server...
浅谈restful
qq_48265856的博客
11-07 207
restful
浅谈RESTFUL
拯救世界的光太郎
03-27 276
RESTful 是什么？ 在说明 RESTful是什么之前，可以先理解一下 REST 是什么。 Roy Fielding 和他的同事们针对 Web 取得的巨大成就，对技术架构方面的因素做了一番深入的总结，Fielding 将这些总结纳入到了一套理论框架之中。极为成功的HTTP/1.1就是由这套理论框架指导设计的。REST（Resource Representational State Transfer 资源描述性状态转移，也有人将它翻译为：表现层状态转化）也是通过这套理论框架推导出的一种新的架构风格.
浅谈Restful
ansong8919的博客
03-08 278
1、Restful的由来 全称：Restful的全称为Resource Representational State Transfer，即：资源在网络中以某种形式进行状态转移。 定义：简单来说，Restful系统架构设计风格（而非标准），一种分布式系统的应用层解决方案。 2、Restful的特征和优点 （1）客户端-服务器（Client-Server）：提供服务的服务器和使用服务...
浅谈restful规范
FM黎明之前的博客
11-28 296
# django路由: path('order_fbv/', views.order, name='FBV-order-view'), path('order_cbv/', views.OrderView.as_view(), name='CBV-order_view'), # django视图: from django.http import HttpResponse from django.views.decorators.csrf import csrf_exempt, csrf_protect fr
浅谈RESTful设计
ergouy's blog
06-17 391
最近做了一个CMS系统，用到了restful风格，做了一些必要的笔记，对自己是一种积累，对他人有参考价值 文章目录一 背景二 协议三 域名四 版本（Versioning）五 路径（Endpoint）六 HTTP动词七 过滤信息（Filtering）八 状态码（Status Codes）九 错误处理（Error handling）十 返回结果十一 Hypermedia API十二 其他十三 总结 一 背景 网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、.
浅谈RESTful风格
xiaoHui_1126的博客
03-20 457
浅谈RESTful风格 REST风格 REST是Representational State Transfer(在表现层上的状态传输)的缩写。 这里翻译一下这句话： 资源（Resources）：REST是"表现层状态传输"，其实它省略了主语。“表现层"其实指的是"资源"的"表现层”。资源是一个抽象的概念，网络上的一个实体、一段文本、一张图片或者一首歌曲等都是资源。资源总是要通过一种载体来反应...
浅谈 RESTful API
Crazymryan的博客
03-03 242
引导篇（RESTful API 是什么？）REST 全称是 Representational State Transfer，中文意思是表现层（编者注：通常译为表征）状态转化， 它首次出现在 2000年 Roy Fielding的博士论文中。Roy Fielding在论文中提到："我这篇文章的写作目的，就是想在符合架构原理的前提下，理解和评估以网络为基础的应用软件的架构设计，得到一个功能强、性能好、...
浅谈restful与ajax
m0_37166734的博客
03-16 5184
1.RESTFUL风格 最近在web的学习上学习了一个新内容,resuful风格，从字面意思上就可以看到知道是一种风格，由于标准是必须遵从的，所以它在这方面上又不是一种代码设计的标准，废话不多说，restful到底是什么呢？ 在网上看到了一句很能概括的话：URL定位资源，用HTTP动词（GET,POST,DELETE,put）描述操作。 从上面这张图中可以看到，GET和POST操作都是通...
浅谈RESTful API
weixin_30797199的博客
09-13 176
什么是RESTful API呢？下面就给大家好好的细说一下 下载资源：www.yinxiangit.com REST，即Representational State Transfer的缩写。直接翻译的意思是”表现层状态转化”。是一种互联网应用程序的API设计理念： URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作...
浅谈KOA2 Restful方式路由初探
10-17
在这篇文章中，我们将要浅谈如何利用KOA2实现Restful风格的路由设计。 文章首先提到了API库结构的设计问题。作者希望能够把服务器资源整合起来，供不同端调用。作者对Restful标准和对象关系映射（ORM）表示了兴趣，...
基于 Rokid Max 与 JSAR 构建空间锚定型 AR 信息面板
a1374469523的博客
11-23 972
空间锚点是 AR 系统在物理环境中创建的一个持久化参考点。通过 SLAM 算法，设备会识别环境特征（如角点、纹理），并将虚拟对象绑定到该位置。即使用户离开再返回，只要环境未发生显著变化，锚点仍能精确定位。通过 JSAR 与 Rokid Max 的空间计算能力，我们仅用百行代码就实现了具备环境感知的 AR 信息面板。这不仅验证了 Web 技术栈在空间计算时代的可行性，也为构建下一代“空间操作系统”中的轻量化应用提供了范式。
在21世纪的我用C语言探寻世界本质——字符函数和字符串函数(2)
2509_94201591的博客
11-25 332
（9）现在我们就来看进行一次匹配的过程，也很简单，我们还是创建一个while循环，如果s1和s2解引用不是 ，并且解引用后相等，那我们就让s1和s2加加，一直往后走，当循环结束时，我们就判断s2解引用后是否是 ，如果是说明完全匹配上了，就返回cp，不是那么说明没有完全匹配，就让cp++，开始下一次循环查找。而不带n的字符串函数和带n的字符串函数的根本区别是带n的字符串函数更灵活，可以指定拷贝的字符的个数，所以也叫带n的字符串函数为受限制的字符串函数，不带n的为不受限制的字符串函数。
Rust高性能Web后端服务开发与Actix-Web实战分享：零成本抽象、高并发处理与内存安全实践
2501_94181083的博客
11-23 743
数据序列化使用bincode替代 JSON：节省 30% CPU对热点代码进行#[inline]展开Netty 式 Reactor 模型减少线程调度开销批量 DB 提交减少 IO 压力缓存热点业务路径到 Redis最终整个平台达成：单机 QPS：18 万P99 延迟 < 30msCPU 占用在可控范围内资源释放完全可预期，无内存泄漏风险高性能，无 GC 停顿编译期保证内存安全，避免线上事故Actix-Web 性能强劲，适合高并发系统适合对性能和稳定性要求极高的互联网生产环境。
初识JDBC
t2786024916的博客
11-23 338
DriverManager - 驱动管理类 - 负责管理数据库驱动连接Connection - 数据库连接类 - 建立与数据库的连接（包含用户名、密码、URL等参数）Statement - SQL语句执行器 - 用于编译和执行SQL操作指令ResultSet - 结果集对象 - 存储并封装SQL查询返回的结果数据 3.连接数据库 4.操作数据库 5.返回结果 增删改不需要resultSet = statement.executeQuery(sql);//执行SQl语句直接 4
MyBatis + PageHelper 分页内幕，PageHelper 是如何动态构建 LIMIT 分页 SQL 的
最新发布
日常笔记 | 干货分享 | 毕设源码 | 毕设指导 | 答辩指导
11-26 289
若依系统中有很多的表格数据、后端接口实体中并没有看到有接收分页大小和页码的属性，在系统的mapper层面SQL语句中并没有看到对应的分页限制。它是如何实现这个分页效果的呢？是将所有的数据查询出来，然后再分页吗？这样效率岂不是非常低。带着这样的疑问，稍微研究了一下这个系统的分页方法。更多详细文章后端是通过从 HttpServletRequest 对象中获取分页的页码和大小，然后创建Page分页对象，在执行sql查询的时候，动态构建分页限制条件。从而实现分页，并不是在查询到所有数据之后再进行的分页处理。
负载均衡为何如此重要？
2302_78814792的博客
11-25 218
负载均衡是一种网络技术，通过将流量分配到多个服务器来提高系统性能、可用性和扩展性。它通过健康检查确保请求只转发到正常服务器，避免单点故障。常见算法包括轮询、加权轮询、最少连接、源IP哈希等，可根据不同场景选择。负载均衡是现代分布式系统的核心组件，能提升服务响应速度、支持无缝扩容，是构建高可用互联网服务的基础技术。合理运用负载均衡对后端和运维工程师至关重要。
浅谈某平台多场景下反爬
12-29
### 多场景下某平台反爬虫策略探讨 #### 场景一：电商平台的商品信息保护 为了防止竞争对手通过自动化工具大量获取商品的价格、库存等敏感商业信息，电商网站通常会采用多种反爬虫机制。例如，京东和淘宝可能会利用复杂的验证码验证用户身份，限制同一IP地址的请求频率，并监控异常行为模式[^3]。 对于此类情况下的反爬虫措施还包括但不限于： - **动态网页加载**：部分商品详情页的数据并非一次性全部返回给浏览器，而是分批次异步加载显示出来； - **加密参数传递**：URL中的查询字符串可能经过特殊编码处理，使得普通的HTTP GET请求难以直接获得所需资源； ```python import requests headers = { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)', } response = requests.get('https://example.com/product', headers=headers) print(response.text) ``` 上述代码展示了如何设置自定义`User-Agent`头来模仿真实用户的浏览习惯，但这并不足以完全规避高级别的防护体系[^4]。 #### 场景二：社交网络的内容分享控制 社交媒体平台往往重视用户体验以及内容版权管理，所以也会部署相应的防御方案阻止未经授权的大规模数据采集活动。这方面的具体做法有： - **API接口权限校验**：只有注册过的应用才能调用官方提供的RESTful API读写特定范围内的资料； - **图形化界面交互逻辑判断**：当检测到连续快速点击按钮或滚动页面时触发警告提示框并记录日志； ```javascript // JavaScript模拟人类自然滑动屏幕事件 function simulateHumanScroll() { const scrollStep = Math.floor(Math.random() * 100); window.scrollBy(0, scrollStep); // 随机数值让动作更像真人所为 } setInterval(simulateHumanScroll, 2000 + Math.round(Math.random()*800)); ``` 此段JavaScript脚本尝试重现真实的用户操作方式以降低被识别的风险水平。 #### 场景三：金融类服务平台的安全保障 鉴于金融机构对安全性的极高要求，其在线门户往往会集成更为严格的身份认证过程和技术手段抵御潜在风险。典型特征如下所示： - **多因素鉴权机制**：除了传统的账号密码组合外还需提供额外的一次性口令（OTP）、生物特征样本等辅助证明材料； - **流量分析引擎**：基于机器学习算法构建实时监测系统评估每一次连接是否存在可疑之处； 综上所述，在不同应用场景里实施有针对性的设计思路能够有效提升系统的整体安全性，同时也提醒广大开发者应当遵循道德准则合法合规地开展工作[^5]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值