Spring Boot 2.4下如何基于Spring Session跨多请求初始化同一对象
Spring Boot 2.4下跨多请求逐步初始化会话对象的合规实现
临时实现的典型问题
- 手动操作HttpSession时容易出现key拼写错误,比如现有代码中
enteredC方法读取b、c值时,全部错误读取了key为"a"的会话属性,数据错位完全无法提前发现 - 每个接口重复编写会话属性的读写逻辑,代码冗余度高,无统一的会话对象生命周期管控
- 缺少前置步骤的存在性校验,用户跳步提交时会拿到null值初始化业务对象
基于@SessionAttributes的标准实现
多数开发者对@SessionAttributes存在误解,认为该机制只能在单次请求绑定完整对象后再存入会话,实际上它的设计本身就支持跨多次请求逐步累积模型属性值,完全匹配分步收集表单的场景。
1. 基础类改造
保留原有全final不可变RequestForm的业务设计不变,单独创建一个可被Spring数据绑定的可变临时暂存类,用于跨步骤累积分散接收的字段:
// 会话暂存专用可变对象,仅用于跨步骤字段累积,不直接暴露给业务层 public class SessionFormTemp { // 字段不使用final修饰,支持逐次赋值 private String a; private String b; private String c; // 必须提供无参构造,否则Spring数据绑定流程会报错 public SessionFormTemp() {} // 提供统一的不可变对象生成方法,在全字段收集完成后调用 public RequestForm toImmutableRequestForm() { return new RequestForm(a, b, c); } // 标准getter/setter方法 public String getA() {return a;} public void setA(String a) {this.a = a;} public String getB() {return b;} public void setB(String b) {this.b = b;} public String getC() {return c;} public void setC(String c) {this.c = c;} }
原业务实体RequestForm保持原有全final的设计无需改动:
public class RequestForm { private final String a; private final String b; private final String c; // 原有构造器、getter方法保持不变 }
2. Controller层适配
在Controller类上标注@SessionAttributes,声明需要跨会话共享的模型对象名称,无需手动调用HttpSession的读写方法:
@RestController @RequestMapping(URL) // 声明名为"stepCollectForm"的模型属性需要存入HttpSession,实现跨请求共享 @SessionAttributes("stepCollectForm") public class StepFormCollectController { private final FormBusinessService formBusinessService; // 原有业务依赖注入保持不变 public StepFormCollectController(FormBusinessService formBusinessService) { this.formBusinessService = formBusinessService; } // 第一步:接收字段a @PostMapping("/1") public ResponseEntity<Void> receiveFieldA(@RequestBody String a, Model model) { SessionFormTemp tempForm = getOrInitTempForm(model); tempForm.setA(a); // 将暂存对象放回模型,Spring会自动同步到对应HttpSession中 model.addAttribute("stepCollectForm", tempForm); return ResponseEntity.ok().build(); } // 第二步:接收字段b @PostMapping("/2") public ResponseEntity<Void> receiveFieldB(@RequestBody String b, Model model) { SessionFormTemp tempForm = getOrInitTempForm(model); log.info("b : {} ", b); tempForm.setB(b); model.addAttribute("stepCollectForm", tempForm); return ResponseEntity.ok().build(); } // 第三步:接收字段c,完成全量字段收集 @PostMapping("/3") public ResponseEntity<Void> receiveFieldC(@RequestBody String c, Model model, SessionStatus sessionStatus) { SessionFormTemp tempForm = getOrInitTempForm(model); log.info("c : {} ", c); tempForm.setC(c); // 全字段收集完成后生成不可变业务对象,交给原有业务逻辑处理 RequestForm requestForm = tempForm.toImmutableRequestForm(); formBusinessService.save(requestForm); // 标记当前会话暂存对象处理完成,Spring会自动从HttpSession中清除对应属性,避免残留过期数据 sessionStatus.setComplete(); return ResponseEntity.ok().build(); } // 封装统一的暂存对象获取逻辑,消除重复代码 private SessionFormTemp getOrInitTempForm(Model model) { SessionFormTemp tempForm = (SessionFormTemp) model.getAttribute("stepCollectForm"); if (tempForm == null) { tempForm = new SessionFormTemp(); } return tempForm; } }
方案特点
- 所有会话属性的读写完全由Spring托管,不需要手动拼接会话key,从根源上避免原实现中的拼写错误、数据错位问题
- 统一管控会话对象生命周期:对象在首次访问第一步接口时自动初始化,在最后一步处理完成后自动从会话清除
- 可在每一步接口中灵活增加前置校验逻辑,比如检查暂存对象中前置步骤的字段是否已填充,拦截跳步提交的异常请求
- 保持原有业务实体的不可变设计,不会因为分步收集的需求破坏业务层的对象约束
落地注意事项
- 前后端分离场景下需要确保会话关联正常:跨域请求时需配置前端开启携带Cookie的配置,保证每一步请求都能匹配到同一个HttpSession
- 修正原临时实现中的语法问题:比如
Stirng的拼写错误、save(new RequestForm(a, b, c)缺失右括号的问题 - 无需手动注入HttpSession对象,通过Model、SessionStatus参数即可完成全流程的会话交互,完全适配Spring Boot 2.4的版本特性
内容的提问来源于stack exchange,提问作者Hoon
相关产品推荐
相关产品推荐

