三十四、面向对象底层逻辑-SpringMVC九大组件之FlashMapManager接口设计哲学

在构建符合 RESTful 原则或追求用户体验流畅性的 Web 应用时,“重定向后刷新”(PRG - Post/Redirect/Get)模式是避免表单重复提交、实现页面无刷新跳转的黄金法则。然而,重定向(REDIRECT:)的本质是客户端发起一次全新的 GET 请求,原始请求中的数据(如成功/错误消息、表单暂存值)如何在两次请求间安全传递?Spring MVC 的 FlashMapManager 接口及其配套机制,正是为解决这一核心痛点而生的优雅设计,它如同一位隐形的信使,在重定向的间隙悄然传递关键信息。

一、 核心挑战:跨重定向请求的属性传递

设想一个典型场景:

  1. 用户提交表单(POST /submit)。

  2. 服务器处理成功,需要重定向到结果页面(GET /result)以避免刷新导致重复提交。

  3. 同时,服务器需在结果页面上显示一条“操作成功”的消息。

问题核心:POST 请求处理过程中生成的“成功消息”如何安全、可靠地传递到后续的 GET 请求中?

  • HttpSession 直接存储:可行但笨重。需手动存/取/清理属性,易导致 Session 膨胀,并发场景需处理属性命名冲突。

  • URL 拼接参数:如 /result?msg=Success。暴露信息、长度受限、不适用于敏感或复杂数据。

  • 请求转发(Forward):能保留请求属性,但浏览器地址栏不更新,刷新可能导致重新提交。

FlashMapManager 的设计目标清晰:提供一种轻量级、安全、自动清理的机制,在重定向操作前暂存数据,并在重定向后的目标请求中自动恢复这些数据,且仅限一次访问

二、 FlashMap 与 FlashMapManager:协作的孪生核心

解决方案的核心是两个紧密协作的组件:

  1. FlashMap:数据的载体容器。

  • 本质是一个 Map<String, Object>,用于存储需要在重定向间传递的键值对(如 "successMessage" -> "操作成功!")。

  • 关键属性:
    targetRequestPath:指定此 FlashMap 应应用到的目标请求路径(可选,用于精确匹配)。
    expirationTime:设置过期时间戳,确保数据不会无限期驻留。

  1. FlashMapManager:接口定义管理 FlashMap 的生命周期。

public interface FlashMapManager {@NullableFlashMap retrieveAndUpdate(HttpServletRequest request, HttpServletResponse response);void saveOutputFlashMap(FlashMap flashMap, HttpServletRequest request, HttpServletResponse response);
}
  • saveOutputFlashMap(FlashMap flashMap, ...)

    • 重定向发生前(通常在 DispatcherServlet 处理内部重定向逻辑时),由框架调用。

    • 职责:将当前请求上下文中准备好的 FlashMap 安全地存储起来,供后续重定向请求检索。

    • 存储位置:通常基于 HttpSession (默认实现),也可自定义(如分布式缓存)。

  • retrieveAndUpdate(HttpServletRequest request, ...)

    • 重定向后的目标请求到达时DispatcherServlet 开始处理新请求时),由框架调用。

    • 职责:

    1. 根据当前请求信息(如路径、Session ID)查找匹配的 FlashMap

    2. 将找到的 FlashMap 中的数据提取并放入当前请求的属性中(默认属性名 DispatcherServlet.OUTPUT_FLASH_MAP_ATTRIBUTE)。

    3. 将已使用的 FlashMap 标记为过期或直接移除,确保数据仅被目标请求访问一次。

    • 返回值:找到的 FlashMap(框架内部使用)。

三、 开发者视角:简洁的 RedirectAttributes API

Spring MVC 并未让开发者直接操作底层的 FlashMapManager 和 FlashMap,而是提供了更友好、更语义化的 RedirectAttributes 接口:

public interface RedirectAttributes extends Model {RedirectAttributes addFlashAttribute(String attributeName, @Nullable Object attributeValue);RedirectAttributes addFlashAttribute(Object attributeValue);// ... 其他方法如 addAttribute (会拼接到URL)
}

使用流程 (Controller 内)

  1. 准备重定向

    @PostMapping("/submit")
    public String handleSubmit(..., RedirectAttributes redirectAttrs) {// 业务处理...// 添加 Flash 属性 (不暴露在URL)redirectAttrs.addFlashAttribute("successMessage", "数据保存成功!");// 添加普通属性 (会拼接到重定向URL)redirectAttrs.addAttribute("id", savedEntity.getId()); // -> /result?id=123return "redirect:/result";
    }
  2. 在重定向目标中获取

    @GetMapping("/result")
    public String showResult(Model model) {// Flash 属性已由框架自动从 FlashMap 取出并添加到 Model 中!// 可直接在视图中通过 ${successMessage} 访问return "resultView";
    }

设计优势

  • 高度抽象:开发者只需操作 RedirectAttributes,完全屏蔽 FlashMapManager 的复杂性。

  • 类型安全addFlashAttribute 方法清晰区分 Flash 数据与 URL 参数。

  • 自动集成:与 Spring MVC 的 Model 和视图渲染无缝结合。

四、 核心实现:SessionFlashMapManager 剖析

Spring MVC 默认提供 org.springframework.web.servlet.support.SessionFlashMapManager,其工作原理如下:

  1. 存储 (saveOutputFlashMap)

    • 获取或创建当前 Session。

    • 从 Session 中获取一个名为 FlashMapManager.FLASH_MAPS_SESSION_ATTRIBUTE 的 List<FlashMap>

    • 将待保存的 FlashMap 添加到这个 List 中。

    • 将更新后的 List 存回 Session。

  2. 检索与更新 (retrieveAndUpdate)

    • 从当前请求的 Session 中获取 List<FlashMap>

    • 遍历 List

      • 检查 FlashMap 是否过期 (expirationTime < currentTime)。

      • 检查 targetRequestPath 是否匹配当前请求路径(如果设置了)。

      • 如果找到匹配且未过期的 FlashMap

        • 将其数据放入当前请求的属性中。

        • 将其从 List 中移除(确保一次性访问)。

        • 将更新后的 List 存回 Session(移除了已使用的 FlashMap)。

    • 返回找到的 FlashMap (内部使用)。

  3. 过期清理

    • retrieveAndUpdate 方法在查找时同步清理过期项。即使目标请求未触发匹配,过期的 FlashMap 也会在下次任何请求调用 retrieveAndUpdate 时被清除。

    • 提供 setFlashMapTimeout(int seconds) 设置 FlashMap 默认存活时间(默认 180 秒)。

五、 设计精妙之处

  1. “一次性”语义保障:通过检索后立即移除的机制,严格确保 Flash 属性仅对重定向后的第一个请求可见。刷新 /result 页面不会再次显示消息,符合 PRG 模式预期。

  2. 请求隔离与精确投递

    • targetRequestPath 允许将 Flash 数据精准关联到特定目标 URL,避免在无关请求中泄露。

    • 基于 Session ID 的存储自然隔离不同用户的数据。

  3. 自动垃圾回收:内置的过期检查和清理机制有效防止 Session 因残留 FlashMap 而膨胀。

  4. 可插拔的存储策略FlashMapManager 是接口。默认 SessionFlashMapManager 适用于大多数应用。在分布式/无状态场景下,可轻松实现基于 Redis、Memcached 或数据库的 FlashMapManager 替代 Session 存储。

  5. 与框架深度集成

    • DispatcherServlet 在内部流程关键点(处理重定向前、处理新请求前)自动调用 FlashMapManager 的方法。

    • RequestMappingHandlerAdapter 在调用 Controller 方法前,将检索到的 FlashMap 数据合并到 Model 中。

六、 最佳实践与考量

  • 内容类型:适合传递短小、非敏感的即时消息(成功/失败提示)、表单校验错误对象(BindingResult)、或少量需要在重定向后页面显示的临时状态数据切勿用于传递大型对象或敏感信息。

  • 命名规范:使用清晰、一致的属性名(如 messageerrorMessageinfo)。

  • 分布式环境:默认 SessionFlashMapManager 依赖 Session 亲和性(Sticky Session)。在集群部署且 Session 不共享时,必须实现自定义的分布式 FlashMapManager

  • 自定义实现:实现 FlashMapManager 接口,重写 saveOutputFlashMap 和 retrieveAndUpdate 方法,选择所需的存储后端(如 Redis)。注册自定义 Bean 覆盖默认实现。

  • 测试:Spring 提供了 MockFlashMapManager 方便单元测试 Controller 中的重定向和 Flash 属性逻辑。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.pswp.cn/bicheng/83876.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

android手势创建及识别保姆级教程

手势交互&#xff0c;简单来说&#xff0c;就是通过手指在屏幕上的滑动、点击、缩放等动作与设备沟通的方式&#xff0c;早已成为现代移动设备用户体验的核心支柱。想想看&#xff0c;无论是日常刷短视频时的上下滑动&#xff0c;还是地图导航时的双指缩放&#xff0c;甚至是游…

Python | Windows11通过离线方式安装pyserial

导言 因公司网络访问的限制&#xff0c;没办法使用pip install pyserial轻松地安装pyserial库。 打开网页&#xff1a;https://pypi.org/project/pyserial/#files 下载.whl cmd命令行 如下是命令行指令&#xff1a; pip install .\pyserial-3.5-py2.py3-none-any.whlpython …

【nano与Vim】常用命令

使用nano编辑器 保存文件 &#xff1a; 按下CtrlO组合键&#xff0c;然后按Enter键确认文件名。 退出编辑器 &#xff1a; 按下CtrlX组合键。 使用vi或vim编辑器 保存文件 &#xff1a; 按Esc键退出插入模式&#xff0c;然后输入:w并按Enter键保存文件。 退出编辑器 &#xf…

(Python网络爬虫);抓取B站404页面小漫画

目录 一. 分析网页 二. 准备工作 三. 实现爬虫 1. 抓取工作 2. 分析工作 3. 拼接主函数&运行结果 四. 完整代码清单 1.多线程版本spider.py&#xff1a; 2.异步版本async_spider.py&#xff1a; 经常逛B站的同志们可能知道&#xff0c;B站的404页面做得别具匠心&…

实战设计模式之模板方法模式

概述 模板方法模式定义了一个操作中的算法骨架&#xff0c;并将某些步骤延迟到子类中实现。模板方法使得子类可以在不改变算法结构的前提下&#xff0c;重新定义算法中的某些步骤。简单来说&#xff0c;就是在一个方法中定义了要执行的步骤顺序或算法框架&#xff0c;但允许子类…

ROS1: 使用rosbag的方式将点云topic保存为pcd文件

ROS1: 使用rosbag的方式将点云topic保存为pcd文件。 分为两步&#xff1a;步骤1&#xff1a;通过rosbag录制点云 &#xff0c;步骤2&#xff1a;通过ros1将rosbag保存为点云pcd文件。 ------------------------ 步骤一&#xff1a;指令示例如下&#xff1a; # topic 名称&a…

MySQL 高级学习篇

一、连结&#xff08;Join&#xff09; 1.1 概念 联结&#xff08;Join&#xff09;操作用于将多个表中的列组合在一起&#xff0c;形成一个新的查询结果集。它允许我们从多个表中提取数据&#xff0c;并基于表之间的关系进行查询。 1.2 类型 1. 内联结&#xff08;INNER J…

clickhouse 学习总结

在 ClickHouse 中&#xff0c;配置文件通常位于 /etc/clickhouse 目录下。这个目录包含了多个配置文件&#xff0c;用于控制 ClickHouse 的各种服务&#xff08;如服务器、用户、远程服务等&#xff09;的配置。 数据存储目录/var/lib/clickhouse 配置 文件目录 /etc/clickho…

理解JavaScript中map和parseInt的陷阱:一个常见的面试题解析

前言 在JavaScript面试中&#xff0c;map和parseInt的组合常常被用作考察候选人对这两个方法理解深度的题目。让我们通过一个简单的例子来深入探讨其中的原理。 问题现象 [1, 2, 3].map(parseInt) // 输出结果是什么&#xff1f;很多人可能会预期输出[1, 2, 3]&#xff0c;但…

字符串 金额转换

package heima.Test09;import java.util.Scanner;public class Money {public static void main(String[] args) {//1。键盘录入一个金额Scanner sc new Scanner(System.in);//请输入一个数据String result "";int money;while (true) {System.out.println("请…

静态相机中的 CCD和CMOS的区别

文章目录 CCD处理方式CMOS处理方式两者区别 首先根据 成像原理&#xff0c;CCD和CMOS的作用是一致的&#xff0c;都是为了将光子转化为数字图像&#xff0c;只是 转换的方式出现差异。 CCD处理方式 获取光子&#xff1a; 在电荷耦合器件&#xff08;CCD&#xff09;传感器中…

Pycharm的终端无法使用Anaconda命令行问题详细解决教程

很多初学者在Windows系统上安装了Anaconda后&#xff0c;在PyCharm终端中运行Conda命令时&#xff0c;会遇到以下错误&#xff1a; conda : 无法将“conda”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。 请检查名称的拼写&#xff0c;如果包括路径&#xff0c;请确保…

[大语言模型]在个人电脑上部署ollama 并进行管理,最后配置AI程序开发助手.

ollama官网: 下载 https://ollama.com/ 安装 查看可以使用的模型 https://ollama.com/search 例如 https://ollama.com/library/deepseek-r1/tags # deepseek-r1:7bollama pull deepseek-r1:7b改token数量为409622 16384 ollama命令说明 ollama serve #&#xff1a…

TDengine 替换 Hadoop,彻底解决数据丢失问题 !

完全替换 Hadoop&#xff0c;彻底解决写入丢数问题 &#xff01;TDengine 助力积成电子更好服务电力客户&#xff01; 小T导读&#xff1a;在内蒙古某新能源集控项目中&#xff0c;三区需接入并分析大量风电、光伏逆变器及储能设备的监测数据。随着数据规模不断扩大&#xff0c…

从0到1认识ElasticStack

一、ES集群部署 操作系统Ubuntu22.04LTS/主机名IP地址主机配置elk9110.0.0.91/244Core8GB100GB磁盘elk9210.0.0.92/244Core8GB100GB磁盘elk9310.0.0.93/244Core8GB100GB磁盘 1. 什么是ElasticStack? # 官网 https://www.elastic.co/ ElasticStack早期名称为elk。 elk分别…

MySQL账号权限管理指南:安全创建账户与精细授权技巧

在MySQL数据库管理中&#xff0c;合理创建用户账号并分配精确权限是保障数据安全的核心环节。直接使用root账号进行所有操作不仅危险且难以审计操作行为。今天我们来全面解析MySQL账号创建与权限分配的专业方法。 一、为何需要创建独立账号&#xff1f; 最小权限原则&#xf…

DFT测试之TAP/SIB/TDR

TAP的作用 tap全称是test access port&#xff0c;是将jtag接口转为reset、sel、ce、ue、se、si、tck和so这一系列测试组件接口的模块。 jtag的接口主要是下面几个信号&#xff1a; 信号名称信号方向信号描述TCK&#xff08;测试时钟&#xff09;输入测试时钟&#xff0c;同…

Python对接印度股票数据源实战指南

Python对接印度股票数据源实战指南 基于StockTV API实现印度证券市场数据对接&#xff0c;覆盖实时行情、K线、指数等核心功能&#xff0c;提供完整开发方案与避坑指南 一、数据源选型要点&#xff08;技术维度对比&#xff09; 根据2025年最新实测数据&#xff0c;印度市场主…

usbutils工具的使用帮助

作为嵌入式系统开发中的常用工具&#xff0c;usbutils 是一套用于管理和调试USB设备的Linux命令行工具集。以下是其核心功能和使用方法的详细说明&#xff1a; 1. 工具组成 核心命令&#xff1a; lsusb&#xff1a;列出所有连接的USB设备及详细信息&#xff08;默认安装&#…

k8s入门教程(集群部署、使用,镜像拉取失败网络问题排查)

文章目录 K8S基础创建centos虚拟机K3S部署配置k3s容器containerd镜像2025年4月测试可用镜像源配置 Pod容器Deployment&#xff08;部署&#xff09;和ReplicaSet&#xff08;副本集&#xff09;镜像拉取失败问题排查 Service服务ServiceType取值 NameSpace命名空间声明式对象配…