IT评测·应用市场-qidao123.com技术社区

标题: 《Spring Boot+计谋模式：企业级度假订单Excel导入系统的架构演进与技能实现》 [打印本页]

---

作者: 万有斥力    时间: 2025-4-18 21:57
标题: 《Spring Boot+计谋模式：企业级度假订单Excel导入系统的架构演进与技能实现》
前言

在数字化期间背景下，订单管理系统的高效性与灵活性成为企业竞争力的核心要素。本文档详细分析了一个基于 计谋模式 的度假订单导入系统，通过分层架构计划实现了多源异构数据的标准化处理。系统以 Spring Boot 为核心框架，结合 MyBatis Plus、Excel 工具库和 Swagger 文档化工具，构建了一个支持动态扩展、批量处理、事务安全的订单管明白决方案。
本文将从数据模型界说、计谋模式实现、核心业务流程三个维度展开，深入解读系统怎样通过 灵活的时间解析、高效的事务管理 和 可扩展的架构计划，实现从 Excel 文件到数据库记录的全链路处理。无论是架构师、开辟职员还是技能管理者，均可通过本文快速掌握系统计划精华。

阅读指引

为高效明白本系统，建议按以下路径阅读：
一、架构概览

• 数据层（DAO）
  

• 
  
  
  
  • 核心模型：RouteOrderInfoDO（线路订单数据对象）
    
  • 核心能力：字段映射、状态枚举关联、多租户支持
    
  • 路径：数据层 > RouteOrderInfoDO
    
  
  

• 服务层（Service）
  

• 
  
  
  
  • 计谋模式：VacationOrderImportStrategy（计谋接口）与 TempOrderImportStrategy（具体计谋）
    
  • 工厂模式：VacationProductCategoryFactory（计谋路由工厂）
    
  • 路径：服务层 > 计谋 服务层 > 酒店品类工厂
    
  
  

• 控制层（Controller）
  

• 
  
  
  
  • 核心接口：RouteOrderExcelController（Excel 导入/导出）
    
  • 功能清单：订单导出、多计谋导入、模板下载
    
  • 路径：控制层 > RouteOrderExcelController
    
  
  

二、核心流程

• 订单导入流程
  

• 
  
  
  
  • 阶段分解：Excel 解析 → 数据转换 → 批量持久化
    
  • 关键代码：TempOrderImportStrategy.importExcel()
    
  • 路径：数据处理流程
    
  
  

• 时间处理机制
  

• 
  
  
  
  • 双阶段解析：格式标准化 → 智能降级解析
    
  • 计划亮点：parseDateTime() 方法的多格式兼容性
    
  • 路径：时间处理
    
  
  

三、扩展指南

• 新增订单来源：扩展计谋接口与工厂路由
  
• 性能优化：批量 SQL 优化与异步处理建议
  
• 安全增强：文件校验与防 SQL 注入方案
  

---

核心总结

1. 架构亮点

维度	计划亮点
分层架构	清楚的 Controller-Service-DAO 分层，通过计谋模式实现业务逻辑解耦
扩展性	计谋接口标准化 + 工厂路由动态分发，新增订单来源只需实现新计谋类，符合开闭原则
性能	批量 SQL 操作（insertBatch/updateBatch）减少数据库交互，事务注解保障原子性
健壮性	双重时间解析机制（支持 3+ 时间格式）、非常分类处理（IO/格式/数据库非常）

2. 关键技能栈

1. - 核心框架：Spring Boot + MyBatis Plus  
2. - 策略模式：策略接口 + 工厂路由  
3. - Excel 处理：Alibaba EasyExcel + 自定义 DictConvert 转换器  
4. - 事务管理：Spring @Transactional 注解  
5. - 文档化：Swagger3 + @Schema 注解  

复制代码

3. 性能数据（示例）

指标	数值（单文件）
千级订单处理耗时	≤2s（含IO与DB操作）
内存占用峰值	≤50MB（万级订单）
批量插入效率	5000条/秒

4. 扩展建议

• 校验增强：添加 @Validated 参数校验与自界说校验注解
  
• 监控集成：通过 Micrometer 实现导入乐成率、耗时等指标采集
  
• 异步化改造：使用 @Async 注解实现大文件异步导入，提升接口相应速度
  

---

通过本文的系统解读，读者可快速掌握基于计谋模式的订单导入架构计划方法论，并基于现有代码扩展出符合业务需求的定制化功能。


数据层


RouteOrderInfoDO

2. package cn.iocoder.central.module.vacation.dal.dataobject.order;
5. import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
6. import com.baomidou.mybatisplus.annotation.KeySequence;
7. import com.baomidou.mybatisplus.annotation.TableId;
8. import com.baomidou.mybatisplus.annotation.TableName;
9. import lombok.*;
10.         import java.math.BigDecimal;
11. import java.time.LocalDateTime;
13. /**
14. * 线路订单信息 DO
15. *
16. * @author 陕文旅
17. */
18. @TableName("order_route_order_info")
19. @KeySequence("order_route_order_info_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
20. @Data
21. @EqualsAndHashCode(callSuper = true)
22. @ToString(callSuper = true)
23. @Builder
24. @NoArgsConstructor
25. @AllArgsConstructor
26. public class RouteOrderInfoDO extends BaseDO {
28.     /**
29.      * 主键
30.      */
31.     @TableId
32.     private Long id;
34.     /**
35.      * 渠道订单号
36.      */
37.     private String systemCode;
40.     /**
41.      * 订单状态
42.      *
43.      * 枚举 {@link TODO order_module_order_status 对应的类}
44.      */
45.     private Integer orderStatus;
47.     /**
48.      * 订单总金额
49.      */
50.     private BigDecimal totalAmount;
52.     /**
53.      * 支付方式
54.      *
55.      * 枚举 {@link TODO order_module_payment_method 对应的类}
56.      */
57.     private Integer paymentMethod;
59.     /**
60.      * 支付状态
61.      *
62.      * 枚举 {@link TODO order_module_payment_status 对应的类}
63.      */
64.     private Integer paymentStatus;
66.     /**
67.      * 路线ID
68.      */
69.     private Long routeId;
71.     /**
72.      * 路线名称
73.      */
74.     private String routeName;
76.     /**
77.      * 游玩人数
78.      */
79.     private Integer playPersonNumber;
81.     /**
82.      * 下单时间
83.      */
84.     private LocalDateTime buyTime;
86.     /**
87.      * 游玩开始时间
88.      */
89.     private LocalDateTime playStartTime;
91.     /**
92.      * 游玩结束时间
93.      */
94.     private LocalDateTime playEndTime;
96.     /**
97.      * 取票人/收货人/联系人
98.      */
99.     private String orderUserName;
101.     /**
102.      * 手机号
103.      */
104.     private String orderUserPhone;
106.     /**
107.      * 创建者
108.      */
109.     private String creator;
111.     /**
112.      * 创建时间
113.      */
114.     private LocalDateTime createTime;
116.     /**
117.      * 更新者
118.      */
119.     private String updater;
121.     /**
122.      * 更新时间
123.      */
124.     private LocalDateTime updateTime;
126.     /**
127.      * 是否删除
128.      */
129.     private Boolean deleted;
131.     /**
132.      * 租户编号
133.      */
134.     private Long tenantId;
135.     /*
136.      * 来源渠道
137.      * */
138.     private String origin;
139. }

复制代码

服务层


计谋

TempOrderImportStrategy

1. package cn.iocoder.central.module.vacation.service.order.excel.strategy;
4. import cn.iocoder.central.module.vacation.controller.admin.order.excel.vo.RouteImportRespVo;
5. import cn.iocoder.central.module.vacation.dal.dataobject.order.RouteOrderInfoDO;
6. import cn.iocoder.central.module.vacation.dal.mysql.order.RouteOrderInfoMapper;
7. import cn.iocoder.central.module.vacation.service.order.excel.vo.TempVacationOrderVo;
8. import cn.iocoder.yudao.framework.common.util.date.DateTimeFormatterUtils;
9. import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
10. import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
11. import jakarta.annotation.Resource;
12. import lombok.extern.slf4j.Slf4j;
13. import org.springframework.stereotype.Component;
14. import org.springframework.transaction.annotation.Transactional;
15. import org.springframework.web.multipart.MultipartFile;
17. import java.io.IOException;
18. import java.time.LocalDate;
19. import java.time.LocalDateTime;
20. import java.time.LocalTime;
21. import java.time.format.DateTimeParseException;
22. import java.util.ArrayList;
23. import java.util.Collections;
24. import java.util.List;
26. @Component
27. @Slf4j
28. public class TempOrderImportStrategy implements VacationOrderImportStrategy {
30.     @Resource
31.     private RouteOrderInfoMapper routeOrderInfoMapper;
34.     @Override
35.     @Transactional(rollbackFor = Exception.class)
36.     public RouteImportRespVo importExcel(MultipartFile file, String origin) throws IOException {
37.         // 1. 读取Excel文件内容
38.         List<TempVacationOrderVo> orderList = ExcelUtils.read(file, TempVacationOrderVo.class);
40.         // 2. 初始化数据容器
41.         List<RouteOrderInfoDO> createRouteOrderList = new ArrayList<>();  // 待新增订单列表
42.         List<RouteOrderInfoDO> updateRouteOrderList = new ArrayList<>();  // 待更新订单列表
43.         List<String> addOrderCodes = new ArrayList<>();  // 新增订单编号集合
44.         List<String> updateOrderCodes = new ArrayList<>();  // 更新订单编号集合
46.         // 3. 处理每条订单数据
47.         for (TempVacationOrderVo order : orderList) {
48.             // 3.1 转换VO为DO对象
49.             RouteOrderInfoDO RouteOrderInfoDO = BeanUtils.toBean(order, RouteOrderInfoDO.class);
50.             RouteOrderInfoDO.setOrigin(origin);  // 设置订单来源
52.             // 3.2 格式化时间字段
53.             RouteOrderInfoDO.setBuyTime(parseDateTime(DateTimeFormatterUtils.formatDateTime(order.getBuyTime())));
54.             RouteOrderInfoDO.setPlayStartTime(parseDateTime(DateTimeFormatterUtils.formatDateTime(order.getPlayStartTime())));
55.             RouteOrderInfoDO.setPlayEndTime(parseDateTime(DateTimeFormatterUtils.formatDateTime(order.getPlayEndTime())));
57.             // 3.3 检查订单是否已存在
58.             Long tableId = RouteOrderInfoMapper.selectIdBySystemCodeAndOrigin(
59.                     RouteOrderInfoDO.getSystemCode(),
60.                     RouteOrderInfoDO.getOrigin()
61.             );
63.             if (tableId != null) {
64.                 // 3.4 已存在订单 - 准备更新
65.                 RouteOrderInfoDO.setId(tableId);
66.                 updateRouteOrderList.add(RouteOrderInfoDO);
67.                 updateOrderCodes.add(RouteOrderInfoDO.getSystemCode());
68.             } else {
69.                 // 3.5 新订单 - 准备新增
70.                 createRouteOrderList.add(RouteOrderInfoDO);
71.                 addOrderCodes.add(RouteOrderInfoDO.getSystemCode());
72.             }
73.         }
75.         // 4. 批量数据库操作
76.         if (!createRouteOrderList.isEmpty()) {
77.             routeOrderInfoMapper.insertBatch(createRouteOrderList);// 批量插入新订单
78.         }
79.         if (!updateRouteOrderList.isEmpty()) {
80.             routeOrderInfoMapper.updateBatch(updateRouteOrderList);  // 批量更新已有订单
81.         }
84.         RouteImportRespVo respVo = new RouteImportRespVo();
85.         respVo.setAddOrderCodes(addOrderCodes);  // 设置新增订单编号列表
86.         respVo.setUpdateOrderCodes(updateOrderCodes);  // 设置更新订单编号列表
87.         respVo.setFailureOrderCodes(Collections.emptyList());  // 空列表表示没有失败订单
89.         return respVo;
90.     }
93.     /**
94.      * 自动解析日期或日期时间字符串为LocalDateTime
95.      * 支持以下格式：
96.      * - 日期格式：yyyy-MM-dd
97.      * - 日期时间格式：yyyy-MM-dd'T'HH:mm:ss 或 yyyy-MM-dd HH:mm:ss
98.      *
99.      * @param timeString 输入的时间字符串
100.      * @return 转换后的LocalDateTime
101.      * @throws DateTimeParseException 如果时间字符串格式不正确
102.      */
103.     public static LocalDateTime parseDateTime(String timeString) throws DateTimeParseException {
104.         try {
105.             // 尝试直接解析为LocalDateTime（适用于包含时间的格式）
106.             return LocalDateTime.parse(timeString);
107.         } catch (DateTimeParseException e1) {
108.             try {
109.                 // 尝试解析为LocalDate（适用于只有日期的格式）
110.                 LocalDate date = LocalDate.parse(timeString);
111.                 // 将日期与默认时间00:00:00组合
112.                 return date.atTime(LocalTime.MIDNIGHT);
113.             } catch (DateTimeParseException e2) {
114.                 // 如果两种格式都不匹配，抛出异常
115.                 throw new DateTimeParseException("无法解析时间字符串：" + timeString, timeString, 0);
116.             }
117.         }
118.     }
120. }

复制代码

数据处理流程

我来详细讲解 <mcsymbol name="TempOrderImportStrategy" filename="TempOrderImportStrategy.java" path="c:\project\centralservice\central-module-vacation\central-module-vacation-biz\src\main\java\cn\iocoder\central\module\vacation\service\order\excel\strategy\TempOrderImportStrategy.java" startline="1" type="class"></mcsymbol> 的数据处理流程：
1. 整体流程

这是一个实现 VacationOrderImportStrategy 接口的订单导入计谋类，专门处理临时订单的Excel导入，主要流程分为4个阶段：

• 读取Excel数据
  
• 初始化数据容器
  
• 逐条处理订单数据
  
• 批量数据库操作
  

2. 详细数据流转过程

2.1 读取Excel阶段

1. List<TempVacationOrderVo> orderList = ExcelUtils.read(file, TempVacationOrderVo.class);

复制代码

• 输入：MultipartFile 类型的Excel文件
  
• 输出：List<TempVacationOrderVo> 订单VO列表
  
• 技能：使用 ExcelUtils.read() 将Excel自动映射为Java对象列表
  

2.2 数据容器初始化

1. List<RouteOrderInfoDO> createRouteOrderList = new ArrayList<>();  // 待新增
2. List<RouteOrderInfoDO> updateRouteOrderList = new ArrayList<>();  // 待更新
3. List<String> addOrderCodes = new ArrayList<>();  // 新增订单号
4. List<String> updateOrderCodes = new ArrayList<>();  // 更新订单号

复制代码

• 创建4个集合分别存储：
  

• 
  
  
  
  • 必要新增的DO对象
    
  • 必要更新的DO对象
    
  • 新增订单的编号(用于返回结果)
    
  • 更新订单的编号(用于返回结果)
    
  
  

2.3 单条数据处理流程

对每条订单数据实行以下操作：

• VO转DO转换
  

1. RouteOrderInfoDO RouteOrderInfoDO = BeanUtils.toBean(order, RouteOrderInfoDO.class);
2. RouteOrderInfoDO.setOrigin(origin);  // 设置来源

复制代码

• 使用 BeanUtils.toBean() 进行对象属性拷贝
  
• 手动设置订单来源字段
  

• 时间字段处理
  

1. RouteOrderInfoDO.setBuyTime(parseDateTime(...));
2. RouteOrderInfoDO.setPlayStartTime(parseDateTime(...));
3. RouteOrderInfoDO.setPlayEndTime(parseDateTime(...));

复制代码

• 调用 parseDateTime() 方法统一处理各种时间格式
  
• 支持两种时间格式：
  

• 
  
  
  
  • 完备日期时间格式：yyyy-MM-dd'T'HH:mm:ss 或 yyyy-MM-dd HH:mm:ss
    
  • 简单日期格式：yyyy-MM-dd (会自动补全时间为00:00:00)
    
  
  

• 订单存在性检查
  

1. Long tableId = RouteOrderInfoMapper.selectIdBySystemCodeAndOrigin(
2.         RouteOrderInfoDO.getSystemCode(),
3.         RouteOrderInfoDO.getOrigin()
4. );

复制代码

• 根据系统编号和来源查询是否已存在相同订单
  
• 返回已存在订单的ID或null
  

• 数据分类存储
  

1. if (tableId != null) {
2.     // 更新逻辑
3.     RouteOrderInfoDO.setId(tableId);
4.     updateRouteOrderList.add(RouteOrderInfoDO);
5.     updateOrderCodes.add(RouteOrderInfoDO.getSystemCode());
6. } else {
7.     // 新增逻辑
8.     createRouteOrderList.add(RouteOrderInfoDO);
9.     addOrderCodes.add(RouteOrderInfoDO.getSystemCode());
10. }

复制代码

2.4 批量数据库操作

1. if (!createRouteOrderList.isEmpty()) {
2.     routeOrderInfoMapper.insertBatch(createRouteOrderList);
3. }
4. if (!updateRouteOrderList.isEmpty()) {
5.     routeOrderInfoMapper.updateBatch(updateRouteOrderList);
6. }

复制代码

• 使用批量操作提高性能
  
• 分别处理新增和更新操作
  

2.5 返回结果构造

1. RouteImportRespVo respVo = new RouteImportRespVo();
2. respVo.setAddOrderCodes(addOrderCodes);
3. respVo.setUpdateOrderCodes(updateOrderCodes);
4. respVo.setFailureOrderCodes(Collections.emptyList());

复制代码

• 构造包含处理结果的相应对象
  
• 当前实现没有失败订单(空列表)
  

3. 关键计划点

• 事务管理：@Transactional 确保整个导入过程原子性
  
• 批量处理：使用批量SQL提高性能
  
• 灵活的时间解析：parseDateTime() 方法支持多种时间格式
  
• 结果追踪：记录所有处理过的订单编号
  
• 计谋模式：实现标准接口，便于扩展其他导入方式
  

4. 数据流转图

1. Excel文件
2.   → List<TempVacationOrderVo>
3.     → List<RouteOrderInfoDO> (分新增/更新)
4.       → 批量SQL操作
5.         → RouteImportRespVo (结果统计)

复制代码

这个实现很好地平衡了性能、可靠性和可维护性，是典型的批处理数据导入解决方案。


！！时间处理



我来详细讲解 <mcsymbol name="TempOrderImportStrategy" filename="TempOrderImportStrategy.java" path="c:\project\centralservice\central-module-vacation\central-module-vacation-biz\src\main\java\cn\iocoder\central\module\vacation\service\order\excel\strategy\TempOrderImportStrategy.java" startline="52" type="function"></mcsymbol> 中的时间处理逻辑：
1. 时间处理流程分解

这三行代码处理了三个时间字段（购买时间、游玩开始时间、游玩竣事时间），处理流程完全同等，分为两个关键步调：

1. RouteOrderInfoDO.setBuyTime(parseDateTime(DateTimeFormatterUtils.formatDateTime(order.getBuyTime())));

复制代码

• 格式化阶段：DateTimeFormatterUtils.formatDateTime()
  

• 
  
  
  
  • 将原始时间对象格式化为标准字符串
    
  • 确保时间格式统一化处理
    
  
  

• 解析阶段：parseDateTime()
  

• 
  
  
  
  • 将格式化后的字符串解析为 LocalDateTime 对象
    
  • 支持多种时间格式的灵活解析
    
  
  

2. 关键技能点解析

2.1 格式化阶段

DateTimeFormatterUtils.formatDateTime() 的作用：

• 输入：大概是各种格式的时间对象（Date/LocalDateTime/String等）
  
• 输出：统一格式的字符串（如 yyyy-MM-dd HH:mm:ss）
  
• 确保后续解析阶段输入格式的同等性
  

2.2 解析阶段

parseDateTime() 方法的智能解析逻辑：

• 优先尝试解析完备时间格式：
  

• 
  
  
  
  • 支持 ISO 格式：yyyy-MM-dd'T'HH:mm:ss
    
  • 支持常规格式：yyyy-MM-dd HH:mm:ss
    
  
  

• 降级解析日期格式：
  

• 
  
  
  
  • 当完备时间解析失败时，尝试解析简单日期：yyyy-MM-dd
    
  • 自动补全时间为 00:00:00
    
  
  

• 非常处理：
  

• 
  
  
  
  • 双重非常捕获确保解析可靠性
    
  • 最终会抛出包含详细错误信息的 DateTimeParseException
    
  
  

3. 计划上风

• 格式兼容性：
  

• 
  
  
  
  • 可以处理来自差异数据源的多样化时间格式
    
  • Excel、数据库、API等差异来源的时间数据都能适配
    
  
  

• 数据同等性：
  

• 
  
  
  
  • 最终统一存储为 LocalDateTime 类型
    
  • 确保业务逻辑处理时时间格式统一
    
  
  

• 健壮性计划：
  

• 
  
  
  
  • 通过格式化+解析的两阶段处理增长可靠性
    
  • 清楚的错误提示便于题目排查
    
  
  

4. 处理流程图解

1. 原始时间对象(order.getBuyTime())
2.   → DateTimeFormatterUtils.formatDateTime()
3.     → 标准化时间字符串
4.       → parseDateTime()
5.         → LocalDateTime对象
6.           → 设置到RouteOrderInfoDO

复制代码

5. 典型应用场景

这种处理方式特别适合：

• 从Excel导入的时间数据（大概有各种格式）
  
• 必要与数据库时间字段对接的场景
  
• 必要严格时间盘算的业务逻辑（如游玩时长盘算）
  

这种计划既包管了灵活性，又确保了最终数据的同等性，是时间处理的最佳实践。



VacationOrderImportStrategy

1. package cn.iocoder.central.module.vacation.service.order.excel.strategy;
4. import cn.iocoder.central.module.vacation.controller.admin.order.excel.vo.RouteImportRespVo;
5. import org.springframework.web.multipart.MultipartFile;
7. import java.io.IOException;
9. public interface VacationOrderImportStrategy {
11.     /**
12.      * 导入Excel
13.      *
14.      * @param file
15.      * @param origin
16.      * @return
17.      */
18.     RouteImportRespVo importExcel(MultipartFile file, String origin) throws IOException;
20. }

复制代码

我来详细讲解 <mcsymbol name="VacationOrderImportStrategy" filename="VacationOrderImportStrategy.java" path="c:\project\centralservice\central-module-vacation\central-module-vacation-biz\src\main\java\cn\iocoder\central\module\vacation\service\order\excel\strategy\VacationOrderImportStrategy.java" startline="1" type="interface"></mcsymbol> 这个计谋接口的核心作用：
核心定位

这是订单导入功能的标准计谋接口，采取计谋模式计划，主要作用包括：

• 统一导入规范
  

• 
  
  
  
  • 界说所有订单导入计谋必须实现的importExcel方法
    
  • 标准化输入参数和返回值格式
    
  
  

• 多源订单支持
  

• 
  
  
  
  • 通过origin参数区分差异来源的订单
    
  • 允许为差异来源实现定制化导入逻辑
    
  
  

• 解耦计划
  

• 
  
  
  
  • 将导入逻辑与业务调用方解耦
    
  • 新增导入渠道只需实现新计谋，无需修改现有代码
    
  
  

方法详解

1. RouteImportRespVo importExcel(MultipartFile file, String origin) throws IOException;

复制代码

• 参数分析
  

• 
  
  
  
  • file：必要导入的Excel文件
    
  • origin：订单来源标识（如"shanwenlv"）
    
  
  

• 返回值
  

• 
  
  
  
  • 统一返回RouteImportRespVo结果对象
    
  • 包含乐成/失败订单统计信息
    
  
  

• 非常处理
  

• 
  
  
  
  • 声明抛出IOException处理文件读取非常
    
  • 实现类可添加更多特定非常
    
  
  

计划上风

• 扩展性
  

• 
  
  
  
  • 轻松支持新增订单来源
    
  • 已有计谋互不影响
    
  
  

• 可维护性
  

• 
  
  
  
  • 每种导入计谋独立实现
    
  • 便于单独测试和修改
    
  
  

• 业务隔离
  

• 
  
  
  
  • 差异来源的导入逻辑完全隔离
    
  • 避免代码耦合
    
  
  

典型实现

如之前看到的TempOrderImportStrategy就是其具体实现，处理特定来源的订单导入。
这个接口是订单导入功能的核心抽象，为系统提供了灵活、可扩展的导入架构。


service-vo

1. package cn.iocoder.central.module.vacation.service.order.excel.vo;
3. import cn.iocoder.central.module.vacation.enums.DictTypeConstants;
4. import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
5. import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
6. import com.alibaba.excel.annotation.ExcelProperty;
7. import io.swagger.v3.oas.annotations.media.Schema;
8. import lombok.AllArgsConstructor;
9. import lombok.Builder;
10. import lombok.Data;
11. import lombok.NoArgsConstructor;
12. import lombok.experimental.Accessors;
14. import java.math.BigDecimal;
16. @Data
17. @Builder
18. @AllArgsConstructor
19. @NoArgsConstructor
20. @Accessors(chain = false) // 设置 chain = false，避免用户导入有问题
21. public class TempVacationOrderVo {
23.     //    导入渠道订单号
24.     @ExcelProperty("订单编号")
25.     private String systemCode;
27.     @ExcelProperty(value = "订单状态", converter = DictConvert.class)
28.     @DictFormat(DictTypeConstants.ORDER_MODULE_ORDER_STATUS)
29.     private String orderStatus;
31.     @ExcelProperty("产品名称")
32.     private String routeName;
34.     @ExcelProperty("下单时间")
35.     private String buyTime;
37.     @ExcelProperty("游玩人数")
38.     private Integer playPersonNumber;
40.     @ExcelProperty("开始时间")
41.     private String playStartTime;
43.     @ExcelProperty("结束时间")
44.     private String playEndTime;
46.     @ExcelProperty("金额")
47.     private BigDecimal totalAmount;
50.     @ExcelProperty(value = "支付方式", converter = DictConvert.class)
51.     @DictFormat(DictTypeConstants.ORDER_MODULE_PAYMENT_METHOD)
52.     private String paymentMethod;
54.     @ExcelProperty(value = "支付状态", converter = DictConvert.class)
55.     @DictFormat(DictTypeConstants.ORDER_MODULE_PAYMENT_STATUS)
56.     private String paymentStatus;
58.     @ExcelProperty("联系人")
59.     private String orderUserName;
61.     @ExcelProperty("联系方式")
62.     private String orderUserPhone;
63. }

复制代码

我来详细讲解 TempVacationOrderVo 这个类的作用和计划特点：
核心定位

这是一个Excel导入数据映射的VO（Value Object）类，专门用于临时度假订单的Excel导入场景，主要作用包括：

• Excel数据映射
  

• 
  
  
  
  • 界说了Excel列名与Java字段的映射关系
    
  • 通过注解实现Excel列到对象属性的自动转换
    
  
  

• 数据格式转换
  

• 
  
  
  
  • 处理字典类型数据的转换（如订单状态、支付方式等）
    
  • 规范时间、金额等特殊字段的格式
    
  
  

关键计划特点

• Excel映射配置
  

• 
  
  
  
  • 使用@ExcelProperty注解配置Excel列名
    
  • 支持自界说转换器（如字典转换）
    
  
  

• 字典数据处理
  

• 
  
  
  
  • 通过@DictFormat关联字典常量
    
  • 使用DictConvert实现字典值与显示文本的转换
    
  
  

• 数据类型计划
  

• 
  
  
  
  • 金额使用BigDecimal包管精度
    
  • 时间字段使用String保持原始格式
    
  
  

• Lombok简化
  

• 
  
  
  
  • 自动生成getter/setter等方法
    
  • 禁用链式调用避免导入题目
    
  
  

业务代价

• 标准化导入
  

• 
  
  
  
  • 统一Excel导入的数据布局
    
  • 确保差异来源订单的导入同等性
    
  
  

• 扩展性
  

• 
  
  
  
  • 新增字段只需添加属性
    
  • 不影响现有导入逻辑
    
  
  

• 数据校验
  

• 
  
  
  
  • 通过注解实现基础校验
    
  • 为后续业务处理提供干净数据
    
  
  

这个VO类在订单导入流程中起到了承上启下的关键作用，既对接了前端Excel文件的布局，又为后端业务处理提供了标准化的数据对象。

酒店品类工厂

1. package cn.iocoder.central.module.vacation.service.order.excel;
4. import cn.iocoder.central.module.vacation.service.order.excel.strategy.TempOrderImportStrategy;
5. import cn.iocoder.central.module.vacation.service.order.excel.strategy.VacationOrderImportStrategy;
6. import jakarta.annotation.Resource;
7. import org.springframework.stereotype.Component;
9. /**
10. * 酒店品类工厂工厂
11. */
12. @Component
13. public class VacationProductCategoryFactory {
15.     private static final String TEMP_TYPE = "shanwenlv";
17.     @Resource
18.     private TempOrderImportStrategy tempOrderImportStrategy;
20.     public VacationOrderImportStrategy getImportStrategy(String origin) {
21.         return switch (origin) {
22.             case TEMP_TYPE -> tempOrderImportStrategy;
23.             default -> null;
24.         };
25.     }
26. }

复制代码

我来详细讲解 VacationProductCategoryFactory 这个工厂类的作用和计划特点：
核心定位

这是一个基于计谋模式的工厂类，专门用于管理和提供差异来源的订单导入计谋实现，主要作用包括：

• 计谋集中管理
  

• 
  
  
  
  • 统一管理所有订单导入计谋实现
    
  • 作为计谋模式的入口点
    
  
  

• 计谋动态分发
  

• 
  
  
  
  • 根据订单来源标识动态返回对应计谋
    
  • 隔离调用方与具体计谋实现的耦合
    
  
  

关键计划特点

• 简单工厂模式
  

• 
  
  
  
  • 通过静态常量界说支持的来源类型
    
  • 使用switch-case返回对应计谋
    
  
  

• 松耦合计划
  

• 
  
  
  
  • 依赖注入具体计谋实现
    
  • 新增计谋只需扩展工厂方法
    
  
  

• 可扩展性
  

• 
  
  
  
  • 预留了default分支便于扩展
    
  • 新增来源只需添加case分支
    
  
  

业务代价

• 统一入口
  

• 
  
  
  
  • 为订单导入提供标准化的计谋获取方式
    
  • 简化调用方的使用复杂度
    
  
  

• 灵活扩展
  

• 
  
  
  
  • 支持动态新增订单来源类型
    
  • 不影响现有导入流程
    
  
  

• 维护便利
  

• 
  
  
  
  • 计谋变更只需修改工厂类
    
  • 不影响业务调用代码
    
  
  

这个工厂类在订单导入系统中起到了计谋路由的关键作用，是计谋模式的核心实现组件。

控制层

RouteOrderExcelController

1. package cn.iocoder.central.module.vacation.controller.admin.order.excel;
3. import cn.hutool.core.util.ObjectUtil;
4. import cn.iocoder.central.module.vacation.controller.admin.order.excel.vo.RouteImportRespVo;
5. import cn.iocoder.central.module.vacation.controller.admin.order.excel.vo.RouteImportVo;
6. import cn.iocoder.central.module.vacation.controller.admin.order.vo.RouteOrderInfoPageReqVO;
7. import cn.iocoder.central.module.vacation.controller.admin.order.vo.RouteOrderInfoRespVO;
8. import cn.iocoder.central.module.vacation.dal.dataobject.order.RouteOrderInfoDO;
9. import cn.iocoder.central.module.vacation.service.order.RouteOrderInfoService;
10. import cn.iocoder.central.module.vacation.service.order.excel.VacationProductCategoryFactory;
11. import cn.iocoder.central.module.vacation.service.order.excel.strategy.TempOrderImportStrategy;
12. import cn.iocoder.central.module.vacation.service.order.excel.strategy.VacationOrderImportStrategy;
13. import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
14. import cn.iocoder.yudao.framework.common.pojo.CommonResult;
15. import cn.iocoder.yudao.framework.common.pojo.PageParam;
16. import cn.iocoder.yudao.framework.common.pojo.PageResult;
17. import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
18. import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
19. import io.swagger.v3.oas.annotations.Operation;
20. import io.swagger.v3.oas.annotations.Parameter;
21. import io.swagger.v3.oas.annotations.Parameters;
22. import io.swagger.v3.oas.annotations.tags.Tag;
23. import jakarta.annotation.Resource;
24. import jakarta.servlet.http.HttpServletResponse;
25. import jakarta.validation.Valid;
26. import org.springframework.validation.annotation.Validated;
27. import org.springframework.web.bind.annotation.*;
28. import org.springframework.web.multipart.MultipartFile;
30. import java.io.IOException;
31. import java.util.List;
33. import static cn.iocoder.central.module.vacation.enums.ErrorCodeConstants.*;
34. import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
35. import static cn.iocoder.yudao.framework.common.pojo.CommonResult.error;
36. import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
38. @Tag(name = "管理后台 - 度假订单 Excel")
39. @RestController
40. @RequestMapping("/vacation/order/excel")
41. @Validated
42. public class RouteOrderExcelController {
44.     @Resource
45.     private RouteOrderInfoService routeOrderInfoService;
47.     @Resource
48.     private VacationProductCategoryFactory vacationProductCategoryFactory;
51.     @GetMapping("/export-excel")
52.     @Operation(summary = "导出度假订单信息 Excel")
53. //    @PreAuthorize("@ss.hasPermission('order:child-route-order-info:export')")
54.     @ApiAccessLog(operateType = EXPORT)
55.     public void exportChildRouteOrderInfoExcel(@Valid RouteOrderInfoPageReqVO pageReqVO,
56.                                                HttpServletResponse response) throws IOException {
57.         pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
58.         List<RouteOrderInfoRespVO> list = routeOrderInfoService.getRouteOrderInfoPage(pageReqVO).getList();
59.         // 导出 Excel
60.         ExcelUtils.write(response, "路线订单信息.xls", "数据", RouteOrderInfoRespVO.class,
61.                 BeanUtils.toBean(list, RouteOrderInfoRespVO.class));
63.     }
65.     @PostMapping("/import")
66.     @Operation(summary = "导入度假订单信息")
67.     @Parameters({
68.             @Parameter(name = "file", description = "Excel 文件", required = true),
69.             @Parameter(name = "origin", description = "来源", example = "true")
70.     })
71. //    @PreAuthorize("@ss.hasPermission('order:child-route-order-info:import')")
72.     public CommonResult<RouteImportRespVo> importExcel(@RequestParam("file") MultipartFile file,
73.                                                        @RequestParam("origin") String origin) throws Exception {
74.         VacationOrderImportStrategy importStrategy = vacationProductCategoryFactory.getImportStrategy(origin);
75.         if (ObjectUtil.isEmpty(importStrategy)) {
76.             return error(VACATION_NOT_FOUND_STRATEGY);
77.         }
78.         try {
79.             RouteImportRespVo orderImportRespVo = importStrategy.importExcel(file, origin);
80.             return success(orderImportRespVo);
81.         } catch (IOException e) {
82.             return error(VACATION_IMPORT_ERROR);
83.         }
85.     }
87.     @GetMapping("/get-route-import-template")
88.     @Operation(summary = "获取度假导入模板")
89.     public void RouteImportTemplate(HttpServletResponse response) throws IOException {
90.         ExcelUtils.write(response, "度假导入模板.xlsx", "度假列表", RouteImportVo.class, null);
91.     }
93. }

复制代码

是一个Spring Boot的RESTful控制器，用于处理与度假订单Excel文件相关的操作。具体功能如下：1. 提供导出度假订单信息到Excel文件的接口。2. 提供导入度假订单信息的接口，根据差异来源选择差异的导入计谋。3. 提供获取度假导入模板的接口。



`@Tag(name = "管理后台 - 度假订单 Excel")` ：这是Swagger的注解，用于为API文档添加标签，方便在API文档工具（如Swagger UI）中对接口进行分组和展示。这里将该控制器下的所有接口归为“管理后台 - 度假订单 Excel”这一类别。2.`@RestController` ：这是Spring框架的注解，它是`@Controller` 和`@ResponseBody` 的组合注解。表示该类是一个控制器，而且其方法返回的对象会自动序列化为JSON格式的相应体，用于构建RESTful风格的API。3.`@RequestMapping("/vacation/order/excel")` ：这也是Spring框架的注解，用于映射HTTP请求的URL路径。它将该控制器下的所有处理方法的URL前缀都设置为`/vacation/order/excel` ，即访问该控制器中的任何接口时，URL都必要以这个前缀开头。4.`@Validated` ：这是Spring框架的注解，用于开启方法级别的数据验证。当控制器的方法参数使用了`@Valid` 注解进行验证时，`@Validated` 注解会确保验证逻辑收效。

RouteImportRespVo

1. package cn.iocoder.central.module.vacation.controller.admin.order.excel.vo;
3. import io.swagger.v3.oas.annotations.media.Schema;
4. import lombok.Builder;
5. import lombok.Data;
7. import java.util.List;
9. @Schema(description = "管理后台 - 路线订单导入 Response VO")
10. @Data
11. public class RouteImportRespVo {
14.     @Schema(description = "导入成功的订单编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
15.     public List<String> addOrderCodes;
17.     @Schema(description = "更新成功的订单编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
18.     public List<String> updateOrderCodes;
20.     @Schema(description = "导入失败的订单编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
21.     public List<String> failureOrderCodes;
23.     // 如果需要，可以手动添加其他方法，如自定义的 getter、setter 或者业务逻辑方法
24. }

复制代码

文件界说了一个名为`RouteImportRespVo` 的类，它是一个用于管理后台的路线订单导入相应视图对象（VO）。该类使用了`@Schema` 注解来形貌类的用途，方便生成API文档。类中包含三个`List<String>` 类型的属性，分别记录导入乐成、更新乐成和导入失败的订单编号数组，便于前端展示导入结果。同时，使用了`@Data` 注解自动生成getter、setter等方法。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 IT评测·应用市场-qidao123.com技术社区 (https://dis.qidao123.com/)

Powered by Discuz! X3.4