在需要实时更新数据的接口中使用 304 状态码

2024-03-10 18:18

本文主要是介绍在需要实时更新数据的接口中使用 304 状态码,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一、前言

Http 状态码是接口设计中不可或缺的一部分,它简洁却蕴含着丰富的含义,这里就简单介绍一下 304 状态码的使用示例吧。

二、场景

比如最近的一个需求是:在 Web 页面中查看任务详情时,要求能够不刷新页面便自动的更新它的状态与日志等信息(任务的执行会花费一定的时间,同时后台在处理任务的过程中会同步它的状态与日志的更新)。

三、分析与方案

使用Ajax不定时的获取数据是肯定的(不采用WebSocket方式),问题在于如何获取与传输数据。

因为任务的状态更新可接受短暂的延时,所以不必采用长连接的方式,客户端只需要定时往服务器发送获取数据的请求即可,但是任务的数据量较大,如果任务并未发生改变,就查询它全部的相关信息并返回到客户端对性能而言必然不是最优的选择,所以我们需要在它发生改变后才查询并返回数据,那么这里就可以引入 304 状态码来解决任务无变化时的返回结果。

304 Not Modified,只读/无变化

由于任务在更新状态或日志时,都会同时更新最后修改时间字段(modified),所以只需要客户端在请求时传入上一次的最后更新时间,服务端以此作为比较,便可知数据是否有发生改变,Api 请求示例如下:

/api/task/{id}/details?modified=1507716647

服务端:
1) 如果判断数据发生变化,则获取最新的数据并返回
2) 如果判断数据未发生改变,则返回空的数据,并返回304状态码

客户端:
1) 客户端收到返回的结果后,只需要根据状态码便可作出对应的操作

以上的请求是使用短连接轮询的方式,然而在实际中即使使用长连接也可使用此种方式。

四、附录

Http 状态码的作用远不止于,根据业务的实际情况可灵活的选择使用,当然每一个状态码的使用都应该尽量满足它的本意,下面就贴一下常用状态码的大概含义吧:

1xx 消息
100:继续 Contine
101:转换协议 Switching Protocols

2xx 成功
200:OK
201:创建 Created
202:接受 Accepted
203:非权威信息 Non-Authoritative Information
204:无内容 No Content
205:重置内容 Reset Content
206:局部内容 Partial Content

3xx 重定向
300:多样选择 Multiple Choices
301:永久移动 Moved Permanently
302:创建 Move temporarily
303:观察别的部分 See Other
304:只读/无变化 Not Modified
305:用户代理 Use Proxy
307:临时重发 Temporary Redirect

4xx 请求错误
400:坏请求 Bad Request
401:未授权的 Unauthorized
402:必要的文件 Payment Required
403:禁用 Forbidden
404:没找到 Not Found
405:不允许的方式 Method Not Allowed
406:不接受 Not Acceptable
407:需要代理验证 Proxy Authentication Required
408:请求超时 Request Timeout
409:冲突 Conflict
410:停止 Gone
411:需要的长度 Length Required
412:预处理失败 Precondition Failed
413:请求实体太长 Request Entity Too Large
414:请求URI太长 Request-URL Too Long
415:不支持的媒体类型 Unsupported Media Type
416:请求的范围不满足 Requested Range Not Satisfiable
417:期望失败 Expectation Failed

5xx 服务器错误
500:服务器内部错误 Internal Server Error
501:不能实现 Not Implemented
502:坏网关 Bad Gateway
503:服务不能实现 Service Unavailable
504:网关超时 Gateway Timeout
505:HTTP版本不支持 HTTP Version Not Supported

更多详细内容可参见RFC 2616文档

这篇关于在需要实时更新数据的接口中使用 304 状态码的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/795097

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

k8s按需创建PV和使用PVC详解

《k8s按需创建PV和使用PVC详解》Kubernetes中,PV和PVC用于管理持久存储,StorageClass实现动态PV分配,PVC声明存储需求并绑定PV,通过kubectl验证状态,注意回收... 目录1.按需创建 PV(使用 StorageClass)创建 StorageClass2.创建 PV

Redis 基本数据类型和使用详解

《Redis基本数据类型和使用详解》String是Redis最基本的数据类型,一个键对应一个值,它的功能十分强大,可以存储字符串、整数、浮点数等多种数据格式,本文给大家介绍Redis基本数据类型和... 目录一、Redis 入门介绍二、Redis 的五大基本数据类型2.1 String 类型2.2 Hash

Redis中Hash从使用过程到原理说明

《Redis中Hash从使用过程到原理说明》RedisHash结构用于存储字段-值对,适合对象数据,支持HSET、HGET等命令,采用ziplist或hashtable编码,通过渐进式rehash优化... 目录一、开篇:Hash就像超市的货架二、Hash的基本使用1. 常用命令示例2. Java操作示例三

Linux创建服务使用systemctl管理详解

《Linux创建服务使用systemctl管理详解》文章指导在Linux中创建systemd服务,设置文件权限为所有者读写、其他只读,重新加载配置,启动服务并检查状态,确保服务正常运行,关键步骤包括权... 目录创建服务 /usr/lib/systemd/system/设置服务文件权限:所有者读写js,其他