百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

良好的URI设计的一些基本原则(uri设计应遵循原则)

nanshan 2024-10-21 06:04 11 浏览 0 评论

良好的URI设计的一些基本原则

  1. 不要使用查询参数来更改状态。
  2. 不要使用大小写混用的路劲除非有必要,最好的都是小写字母。
  3. 不要使用实现特定的扩展你的URI(php,py,PL,等。)
  4. 不要让你的URI有远程过程调用(RPC)的缺陷
  5. 尽可能多地限制URI空间。
  6. 保持路径段短
  7. 最好用/resource或者/resource/;同时为你没有用到的路径创建301重定向
  8. 使用查询参数对于一个子资源的选择;如分页、搜索查询
  9. 不要在URL中填写任何东西,应该放在HTTP头或正文中去。

(注意:我没有说“RESTful URI设计”;URI本质上是不透明的REST。)


HTTP方法选择的11个基本原则:

  1. 永远不要GET去改变状态;这会让Googlebot毁掉你的一天
  2. 不要用PUT,除非你要更新整个resource
  3. 不要用PUT,除非你可以一直合法的用GET在同一个URI上
  4. 不要用POST来检索信息,那是长效的并且可能被缓冲
  5. 不要执行一个操作是非幂等的PUT
  6. 尽可能使用get
  7. 当不确定使用PUT还是POST时,优先使用POST
  8. 要使用POST当你需要做一些类似RPC时
  9. 对类较大或层次的资源使用PUT
  10. 删除资源时,优先选择DELETE而不是POST
  11. 在做计算之类的请求时,优先使用GET;除非你的INPUT很大,这是你可以考虑使用POST


Web服务中HTTP设计的一般原则:

  1. 不要将元数据放在body中,应该放在header中。
  2. 不要将元数据放在单独的资源中,除非当包含元数据时会造成很大的开销。
  3. 使用适当的状态码
  • 201 Created指创建资源时;在发送响应时资源必须存在
  • 202 Accepted指成功执行一个操作或异步创建资源
  • 400 Bad Request指当有人用伪造的数据进行操作;应用程序可能是一个验证错误;一般保存为500的未捕获的异常
  • 401 Unauthorized指当某人访问您的API时,未提供必要的授权header或授权中的凭据无效时;如果您不希望通过授权header来进行凭证,则不要使用此响应代码。
  • 403 Forbidden指当某人恶意或未经授权的方式访问你的API时
  • 405 Method Not Allowed指当本来必须用PUT,而有人却POST时,等等
  • 413 Request Entity Too Large指当某人试图发送一个无法接收的大文件时
  • 418 I’m teapot 指当我试图用茶壶冲泡咖啡时
  1. 尽可能使用缓存Headers
  • ETag headers让你很容易的将资源设置为哈希值
  • Last-Modified向你表明,保留资源更新时的时间戳是一个好主意。
  • Cathe-Control和Expires应该有一个合理的值。
  1. 尽一切可能执行请求中的缓存headers(If-None-Modified, If-Modified-Since)
  2. 使用重定向的时一定要有意义,但这应该是罕见的Web服务

相关推荐

实战派 | Java项目中玩转Redis6.0客户端缓存

铺垫首先介绍一下今天要使用到的工具Lettuce,它是一个可伸缩线程安全的redis客户端。多个线程可以共享同一个RedisConnection,利用nio框架Netty来高效地管理多个连接。放眼望向...

轻松掌握redis缓存穿透、击穿、雪崩问题解决方案(20230529版)

1、缓存穿透所谓缓存穿透就是非法传输了一个在数据库中不存在的条件,导致查询redis和数据库中都没有,并且有大量的请求进来,就会导致对数据库产生压力,解决这一问题的方法如下:1、使用空缓存解决对查询到...

Redis与本地缓存联手:多级缓存架构的奥秘

多级缓存(如Redis+本地缓存)是一种在系统架构中广泛应用的提高系统性能和响应速度的技术手段,它综合利用了不同类型缓存的优势,以下为你详细介绍:基本概念本地缓存:指的是在应用程序所在的服务器内...

腾讯云国际站:腾讯云服务器如何配置Redis缓存?

本文由【云老大】TG@yunlaoda360撰写一、安装Redis使用包管理器安装(推荐)在CentOS系统中,可以通过yum包管理器安装Redis:sudoyumupdate-...

Spring Boot3 整合 Redis 实现数据缓存,你做对了吗?

你是否在开发互联网大厂后端项目时,遇到过系统响应速度慢的问题?当高并发请求涌入,数据库压力剧增,响应时间拉长,用户体验直线下降。相信不少后端开发同行都被这个问题困扰过。其实,通过在SpringBo...

【Redis】Redis应用问题-缓存穿透缓存击穿、缓存雪崩及解决方案

在我们使用redis时,也会存在一些问题,导致请求直接打到数据库上,导致数据库挂掉。下面我们来说说这些问题及解决方案。1、缓存穿透1.1场景一个请求进来后,先去redis进行查找,redis存在,则...

Spring boot 整合Redis缓存你了解多少

在前一篇里面讲到了Redis缓存击穿、缓存穿透、缓存雪崩这三者区别,接下来我们讲解Springboot整合Redis中的一些知识点:之前遇到过,有的了四五年,甚至更长时间的后端Java开发,并且...

揭秘!Redis 缓存与数据库一致性问题的终极解决方案

在现代软件开发中,Redis作为一款高性能的缓存数据库,被广泛应用于提升系统的响应速度和吞吐量。然而,缓存与数据库之间的数据一致性问题,一直是开发者们面临的一大挑战。本文将深入探讨Redis缓存...

高并发下Spring Cache缓存穿透?我用Caffeine+Redis破局

一、什么是缓存穿透?缓存穿透是指查询一个根本不存在的数据,导致请求直接穿透缓存层到达数据库,可能压垮数据库的现象。在高并发场景下,这尤其危险。典型场景:恶意攻击:故意查询不存在的ID(如负数或超大数值...

Redis缓存三剑客:穿透、雪崩、击穿—手把手教你解决

缓存穿透菜小弟:我先问问什么是缓存穿透?我听说是缓存查不到,直接去查数据库了。表哥:没错。缓存穿透是指查询一个缓存中不存在且数据库中也不存在的数据,导致每次请求都直接访问数据库的行为。这种行为会让缓存...

Redis中缓存穿透问题与解决方法

缓存穿透问题概述在Redis作为缓存使用时,缓存穿透是常见问题。正常查询流程是先从Redis缓存获取数据,若有则直接使用;若没有则去数据库查询,查到后存入缓存。但当请求的数据在缓存和数据库中都...

Redis客户端缓存的几种实现方式

前言:Redis作为当今最流行的内存数据库和缓存系统,被广泛应用于各类应用场景。然而,即使Redis本身性能卓越,在高并发场景下,应用于Redis服务器之间的网络通信仍可能成为性能瓶颈。所以客户端缓存...

Nginx合集-常用功能指导

1)启动、重启以及停止nginx进入sbin目录之后,输入以下命令#启动nginx./nginx#指定配置文件启动nginx./nginx-c/usr/local/nginx/conf/n...

腾讯云国际站:腾讯云怎么提升服务器速度?

本文由【云老大】TG@yunlaoda360撰写升级服务器规格选择更高性能的CPU、内存和带宽,以提供更好的处理能力和网络性能。优化网络配置调整网络接口卡(NIC)驱动,优化TCP/IP参数...

雷霆一击服务器管理员教程

本文转载莱卡云游戏服务器雷霆一击管理员教程(搜索莱卡云面版可搜到)首先你需要给服务器设置管理员密码,默认是空的管理员密码在启动页面进行设置设置完成后你需要重启服务器才可生效加入游戏后,点击键盘左上角E...

取消回复欢迎 发表评论: