在需要实时更新数据的接口中使用 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

相关文章

使用Python构建一个Hexo博客发布工具

《使用Python构建一个Hexo博客发布工具》虽然Hexo的命令行工具非常强大,但对于日常的博客撰写和发布过程,我总觉得缺少一个直观的图形界面来简化操作,下面我们就来看看如何使用Python构建一个... 目录引言Hexo博客系统简介设计需求技术选择代码实现主框架界面设计核心功能实现1. 发布文章2. 加

SpringBoot集成Milvus实现数据增删改查功能

《SpringBoot集成Milvus实现数据增删改查功能》milvus支持的语言比较多,支持python,Java,Go,node等开发语言,本文主要介绍如何使用Java语言,采用springboo... 目录1、Milvus基本概念2、添加maven依赖3、配置yml文件4、创建MilvusClient

shell编程之函数与数组的使用详解

《shell编程之函数与数组的使用详解》:本文主要介绍shell编程之函数与数组的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录shell函数函数的用法俩个数求和系统资源监控并报警函数函数变量的作用范围函数的参数递归函数shell数组获取数组的长度读取某下的

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

SpringValidation数据校验之约束注解与分组校验方式

《SpringValidation数据校验之约束注解与分组校验方式》本文将深入探讨SpringValidation的核心功能,帮助开发者掌握约束注解的使用技巧和分组校验的高级应用,从而构建更加健壮和可... 目录引言一、Spring Validation基础架构1.1 jsR-380标准与Spring整合1

Python虚拟环境终极(含PyCharm的使用教程)

《Python虚拟环境终极(含PyCharm的使用教程)》:本文主要介绍Python虚拟环境终极(含PyCharm的使用教程),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录一、为什么需要虚拟环境?二、虚拟环境创建方式对比三、命令行创建虚拟环境(venv)3.1 基础命令3

Python Transformer 库安装配置及使用方法

《PythonTransformer库安装配置及使用方法》HuggingFaceTransformers是自然语言处理(NLP)领域最流行的开源库之一,支持基于Transformer架构的预训练模... 目录python 中的 Transformer 库及使用方法一、库的概述二、安装与配置三、基础使用:Pi

关于pandas的read_csv方法使用解读

《关于pandas的read_csv方法使用解读》:本文主要介绍关于pandas的read_csv方法使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录pandas的read_csv方法解读read_csv中的参数基本参数通用解析参数空值处理相关参数时间处理相关

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

SpringBoot条件注解核心作用与使用场景详解

《SpringBoot条件注解核心作用与使用场景详解》SpringBoot的条件注解为开发者提供了强大的动态配置能力,理解其原理和适用场景是构建灵活、可扩展应用的关键,本文将系统梳理所有常用的条件注... 目录引言一、条件注解的核心机制二、SpringBoot内置条件注解详解1、@ConditionalOn