搜索到
20
篇与
的结果
-
Java + EasyExcel 实现单个接口导出多个Excel 在日常开发中，我们经常会遇到 Excel 导出的需求，大多是单个接口导出单个 Excel 文件。但偶尔也会有特殊场景——需要一个接口同时导出两个（或多个）独立的 Excel 文件，比如同时导出“用户列表”和“订单列表”，方便用户一次性获取完整数据。今天就基于 Spring Boot + EasyExcel（目前主流稳定版本），分享一种简单、通用、可直接落地的实现方案，全程附完整代码，新手也能快速上手～一、核心问题与解决方案首先要明确一个关键前提：HTTP 协议单次响应只能返回一个字节流，无法直接返回两个独立的 Excel 文件（相当于一次请求只能下载一个文件）。那怎么实现“一个接口导出多个 Excel”？答案很简单——将多个 Excel 文件打包成 ZIP 压缩包，接口返回 ZIP 流，用户下载后解压，就能得到多个 Excel 文件。这是最通用、最合规的解决方案，既不违背 HTTP 协议，也能满足用户一次性获取多份文件的需求。二、前置准备：引入依赖首先在项目中引入 EasyExcel 核心依赖、ZIP 压缩依赖（用于打包多文件），以及 Spring Web 依赖（接口开发必备）。以下是 Maven 配置，Gradle 可对应转换，版本可根据自己项目需求微调（建议保持和示例一致，避免兼容问题）。<!-- EasyExcel 核心依赖 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>4.0.3</version> </dependency> <!-- ZIP 压缩依赖（处理多文件打包） --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-compress</artifactId> <version>1.27.1</version> </dependency> <!-- Spring Web 依赖（已有则忽略，接口开发必备） --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>三、步骤1：定义Excel对应的实体类假设我们需要导出两个 Excel 文件：用户列表 和 订单列表，分别创建对应的实体类，通过 EasyExcel 的 @ExcelProperty 注解指定 Excel 表头名称（注解参数就是最终 Excel 中显示的表头）。实体类用 Lombok 的 @Data 注解简化 getter/setter 代码，无需手动编写，节省开发时间。3.1 用户实体类（UserData.java）import com.alibaba.excel.annotation.ExcelProperty; import lombok.Data; /** * 用户列表 Excel 对应的实体类 */ @Data public class UserData { // Excel 表头：用户ID @ExcelProperty("用户ID") private Long userId; // Excel 表头：用户名称 @ExcelProperty("用户名称") private String userName; // Excel 表头：手机号 @ExcelProperty("手机号") private String phone; }3.2 订单实体类（OrderData.java）import com.alibaba.excel.annotation.ExcelProperty; import lombok.Data; /** * 订单列表 Excel 对应的实体类 */ @Data public class OrderData { // Excel 表头：订单ID @ExcelProperty("订单ID") private String orderId; // Excel 表头：用户ID（关联用户表） @ExcelProperty("用户ID") private Long userId; // Excel 表头：订单金额 @ExcelProperty("订单金额") private Double amount; // Excel 表头：创建时间 @ExcelProperty("创建时间") private String createTime; }四、步骤2：封装通用工具类（核心）为了避免接口层代码冗余，我们封装一个工具类 ExcelZipExportUtil，专门处理“将多个 Excel 写入 ZIP 流”和“初始化 HTTP 响应头”的逻辑。这个工具类是通用的，后续不管导出多少个 Excel，都能直接复用，无需重复编码。import com.alibaba.excel.EasyExcel; import org.apache.commons.compress.archivers.zip.ZipArchiveEntry; import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServletResponse; import java.io.ByteArrayOutputStream; import java.net.URLEncoder; import java.util.List; /** * EasyExcel 多文件导出 ZIP 工具类（通用可复用） */ public class ExcelZipExportUtil { /** * 将单个 Excel 文件写入 ZIP 输出流 * @param zipOut ZIP 输出流 * @param excelFileName 单个 Excel 的文件名（如：用户列表.xlsx） * @param data Excel 中的数据列表 * @param clazz Excel 对应的实体类（用于解析表头） */ public static <T> void writeExcelToZip(ZipArchiveOutputStream zipOut, String excelFileName, List<T> data, Class<T> clazz) throws Exception { // 1. 临时存储 Excel 内容（内存级，不写入磁盘，性能更高） ByteArrayOutputStream bos = new ByteArrayOutputStream(); // 2. 使用 EasyExcel 写入数据（sheet1 是工作表名称，可自定义） EasyExcel.write(bos, clazz) // 不要自动关闭，交给 Servlet 自己处理 .autoCloseStream(false) // 基于 column 长度，自动适配。最大 255 宽度 .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy()) // 避免 Long 类型丢失精度 .registerConverter(new LongStringConverter()) // 工作表名称 .sheet("sheet1") .doWrite(data); // 3. 将 Excel 作为 ZIP 的一个条目写入 zipOut.putArchiveEntry(new ZipArchiveEntry(excelFileName)); zipOut.write(bos.toByteArray()); zipOut.closeArchiveEntry(); // 关闭当前 ZIP 条目（必须，否则后续条目无法写入） // 4. 关闭临时流 bos.close(); } /** * 初始化 HTTP 响应头（设置 ZIP 下载、解决中文文件名乱码） * @param response 响应对象 * @param zipFileName 最终下载的 ZIP 压缩包名称（如：用户订单数据.zip） */ public static void initZipResponse(HttpServletResponse response, String zipFileName) throws Exception { // 设置响应类型为 ZIP response.setContentType("application/zip"); // 设置下载头，URLEncoder.encode 解决中文文件名乱码（兼容所有浏览器） response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(zipFileName, "UTF-8")); // 禁止缓存（避免浏览器缓存旧文件） response.setHeader("Pragma", "no-cache"); response.setHeader("Cache-Control", "no-cache"); } }五、步骤3：接口层实现（最终落地）创建 Controller 接口，模拟构造两个 Excel 的测试数据（实际项目中，这里可以替换成从数据库查询数据），然后调用上面封装的工具类，将两个 Excel 打包成 ZIP 流，通过 HttpServletResponse 返回，实现“一次请求下载两个 Excel”。import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletResponse; import java.util.ArrayList; import java.util.List; /** * Excel 导出接口控制器 */ @RestController @RequestMapping("/export") public class ExcelExportController { /** * 单个接口导出两个 Excel 文件（打包成 ZIP 下载） * 访问地址：http://localhost:8080/export/twoExcel */ @GetMapping("/twoExcel") public void exportTwoExcel(HttpServletResponse response) { try { // 1. 初始化响应头，设置 ZIP 压缩包名称（用户下载时显示的文件名） ExcelZipExportUtil.initZipResponse(response, "用户订单数据.zip"); // 2. 获取 HTTP 响应输出流，关联 ZIP 输出流 ServletOutputStream servletOut = response.getOutputStream(); ZipArchiveOutputStream zipOut = new ZipArchiveOutputStream(servletOut); // 3. 构造第一个 Excel 的数据（用户列表，实际项目中替换为数据库查询） List<UserData> userList = new ArrayList<>(); // 3.1 完善数据逻辑省略 // 4. 构造第二个 Excel 的数据（订单列表，实际项目中替换为数据库查询） List<OrderData> orderList = new ArrayList<>(); // 4.1 完善数据逻辑省略 // 5. 关键操作：将两个 Excel 分别写入 ZIP 流 ExcelZipExportUtil.writeExcelToZip(zipOut, "用户列表.xlsx", userList, UserData.class); ExcelZipExportUtil.writeExcelToZip(zipOut, "订单列表.xlsx", orderList, OrderData.class); // 6. 关闭流（顺序不能错！否则 ZIP 包会损坏，无法解压） zipOut.finish(); // 完成 ZIP 写入 zipOut.close(); servletOut.flush(); servletOut.close(); } catch (Exception e) { e.printStackTrace(); // 实际项目中建议自定义异常处理，给前端返回明确的错误提示 response.setStatus(500); } } }六、关键注意事项（避坑重点）这部分一定要仔细看！很多新手实现后，出现 ZIP 包损坏、中文乱码、数据缺失等问题，大多是因为忽略了这些细节。流的关闭顺序：必须先执行 zipOut.closeArchiveEntry()（关闭当前 ZIP 条目），再执行 zipOut.finish()，最后关闭 ZIP 流和响应流。顺序颠倒会导致 ZIP 包损坏，无法解压。中文文件名乱码：通过 URLEncoder.encode(zipFileName, "UTF-8") 对 ZIP 文件名和 Excel 文件名编码，兼容 Chrome、Firefox、Edge 等所有主流浏览器，避免中文乱码。Excel 写入方式：示例中使用 ByteArrayOutputStream 临时存储 Excel 内容，属于内存级写入，不占用磁盘空间，性能更高。不建议直接写入磁盘文件再打包，会增加磁盘 IO 开销。异常处理：实际项目中，建议替换 try-catch 中的 printStackTrace()，使用全局异常处理器，给前端返回明确的错误信息（如“导出失败，请重试”），提升用户体验。七、扩展：导出更多Excel文件如果需要导出 3 个、4 个甚至更多 Excel 文件，无需修改工具类，只需在接口中继续调用 ExcelZipExportUtil.writeExcelToZip() 方法即可。示例（新增“商品列表”Excel）：// 新增商品列表数据（假设已有 GoodsData 实体类） List<GoodsData> goodsList = new ArrayList<>(); // ... 构造商品数据 // 新增一个 Excel 写入 ZIP 流 ExcelZipExportUtil.writeExcelToZip(zipOut, "商品列表.xlsx", goodsList, GoodsData.class);八、测试效果验证代码写完后，启动 Spring Boot 项目，通过以下步骤测试，确保导出正常：访问接口地址：http://localhost:8080/export/twoExcel（端口号根据自己项目配置调整）；浏览器会自动弹出下载提示，下载的文件名为“用户订单数据.zip”；解压 ZIP 压缩包，会得到两个 Excel 文件：用户列表.xlsx 和 订单列表.xlsx；打开 Excel 文件，检查表头和数据是否正常（和接口中构造的测试数据一致）。九、总结代码通用可复用，总结下来就是 3 步：引入 EasyExcel 和 ZIP 依赖，做好前置准备；定义 Excel 对应的实体类，封装通用工具类（处理 ZIP 打包和响应头）；在接口中构造数据，调用工具类将多个 Excel 写入 ZIP 流，返回给前端。该方案适用于所有 Spring Boot 项目，支持任意数量的 Excel 导出，避开了新手常踩的坑（流顺序、中文乱码），直接复制代码就能落地使用。如果你的项目中有类似需求，不妨试试这个方案～ -
为什么不建议使用Executors创建线程池？ 在Java开发中，线程池是优化并发性能的核心工具，但线程池的创建方式却藏着不少坑。《阿里巴巴Java开发手册》明确规定：线程池不允许使用Executors创建，必须通过ThreadPoolExecutor手动创建。很多新手可能会疑惑：Executors提供的方法简洁又方便，为什么会被禁止？今天就从底层实现出发，彻底讲清楚这个问题，同时补充线程池的核心知识，帮你避开面试和开发中的高频陷阱。一、先认识下「背锅侠」：Executors类Executors是JUC（java.util.concurrent）包下的工具类，专门用于快速创建线程池，提供了4个核心方法：newFixedThreadPool：固定线程数的线程池newSingleThreadExecutor：单线程线程池newCachedThreadPool：可缓存的线程池newScheduledThreadPool：支持定时/周期性任务的线程池这些方法看似「开箱即用」，但底层参数配置存在致命缺陷，我们逐个拆解。1. 隐患1：newFixedThreadPool & newSingleThreadExecutor——内存溢出风险先看newFixedThreadPool的底层实现代码：public static ExecutorService newFixedThreadPool(int nThreads, ThreadFactory threadFactory) { return new ThreadPoolExecutor(nThreads, nThreads, 0L, TimeUnit.MILLISECONDS, new LinkedBlockingQueue<Runnable>(), threadFactory); }核心问题出在等待队列LinkedBlockingQueue上。我们点进LinkedBlockingQueue的无参构造：public LinkedBlockingQueue() { this(Integer.MAX_VALUE); // 队列长度默认是Integer.MAX_VALUE }关键坑点：Integer.MAX_VALUE是2147483647，相当于「无界队列」。当任务提交速度远大于线程处理速度时，任务会不断堆积在队列中，导致JVM内存持续飙升，最终触发OOM（内存溢出）。newSingleThreadExecutor的问题和它完全一致，底层也是用了无界的LinkedBlockingQueue，且核心线程数固定为1，任务堆积的风险更高：public static ExecutorService newSingleThreadExecutor() { return new FinalizableDelegatedExecutorService (new ThreadPoolExecutor(1, 1, 0L, TimeUnit.MILLISECONDS, new LinkedBlockingQueue<Runnable>())); }2. 隐患2：newCachedThreadPool & newScheduledThreadPool——资源耗尽风险再看newCachedThreadPool的实现：public static ExecutorService newCachedThreadPool() { return new ThreadPoolExecutor(0, Integer.MAX_VALUE, 60L, TimeUnit.SECONDS, new SynchronousQueue<Runnable>()); }核心问题有两个：核心线程数为0：没有常驻线程，每次有任务都需要创建新线程（除非有空闲线程可复用）最大线程数为Integer.MAX_VALUE：理论上可以创建无限多线程关键坑点：当短时间内提交大量任务时，线程池会疯狂创建新线程，而每个线程都会占用一定的内存和CPU资源，最终导致系统资源耗尽，程序崩溃。newScheduledThreadPool的问题类似，最大线程数同样是Integer.MAX_VALUE，存在相同的资源耗尽风险：public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize) { return new ScheduledThreadPoolExecutor(corePoolSize); } // 父类构造（ScheduledThreadPoolExecutor继承自ThreadPoolExecutor） public ScheduledThreadPoolExecutor(int corePoolSize) { super(corePoolSize, Integer.MAX_VALUE, DEFAULT_KEEPALIVE_MILLIS, MILLISECONDS, new DelayedWorkQueue()); }二、正确姿势：ThreadPoolExecutor手动创建（推荐）Executors的问题本质是「参数固化」，无法根据业务场景灵活配置。而ThreadPoolExecutor允许我们手动指定所有核心参数，从根源上避免上述隐患。1. 核心参数详解（面试高频考点）ThreadPoolExecutor的核心构造方法：public ThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, ThreadFactory threadFactory, RejectedExecutionHandler handler) { // ... 省略参数校验逻辑 }7个参数的作用必须记牢，直接关系到线程池的性能和稳定性：corePoolSize（核心线程数）：线程池的常驻线程数，即使空闲也不会销毁（除非设置allowCoreThreadTimeOut=true）。maximumPoolSize（最大线程数）：线程池允许创建的最大线程数，超出核心线程数的是「非核心线程」。keepAliveTime（空闲线程存活时间）：非核心线程空闲后的最大存活时间，超时会被销毁，释放资源。unit（时间单位）：keepAliveTime的时间单位，如MILLISECONDS（毫秒）、SECONDS（秒）。workQueue（工作队列）：用于存放等待执行的任务，必须使用「有界队列」（如ArrayBlockingQueue），避免任务堆积。threadFactory（线程工厂）：用于创建线程，可自定义线程名称（方便问题排查）、设置线程优先级等。handler（拒绝策略）：当线程数达最大且队列满时，新任务的处理策略（如丢弃任务、抛出异常、由提交线程执行等）。2. 推荐实践：自定义线程池示例结合业务场景（如处理用户订单任务），手动创建线程池：import java.util.concurrent.*; public class ThreadPoolDemo { // 线程工厂：自定义线程名称，方便排查问题 private static final ThreadFactory THREAD_FACTORY = new ThreadFactory() { private int count = 1; @Override public Thread newThread(Runnable r) { Thread thread = new Thread(r); thread.setName("order-thread-pool-" + count++); return thread; } }; // 拒绝策略：队列满时抛出异常，及时发现问题 private static final RejectedExecutionHandler REJECTED_HANDLER = new ThreadPoolExecutor.AbortPolicy(); // 自定义线程池 public static final ThreadPoolExecutor ORDER_THREAD_POOL = new ThreadPoolExecutor( 5, // 核心线程数：根据CPU核心数或业务量配置 10, // 最大线程数：不超过CPU核心数*2（IO密集型可适当增加） 60, // 空闲线程存活时间：60秒 TimeUnit.SECONDS, new ArrayBlockingQueue<>(100), // 有界队列：容量100，避免任务堆积 THREAD_FACTORY, REJECTED_HANDLER ); public static void main(String[] args) { // 提交任务 for (int i = 0; i < 100; i++) { int finalI = i; ORDER_THREAD_POOL.submit(() -> { System.out.println(Thread.currentThread().getName() + " 处理订单：" + finalI); }); } // 关闭线程池（实际项目中可在应用关闭时调用） ORDER_THREAD_POOL.shutdown(); } }三、加餐：线程池工作流程（面试必问）理解线程池的工作流程，能帮你更合理地配置参数。当任务提交后，线程池会按以下步骤处理：提交任务：通过execute()或submit()方法提交任务。检查核心线程：若当前运行的线程数 < corePoolSize，立即创建核心线程执行任务；否则进入下一步。检查工作队列：若队列未满，将任务放入队列等待执行；否则进入下一步。检查最大线程：若当前运行的线程数 < maximumPoolSize，创建非核心线程执行任务；否则进入下一步。触发拒绝策略：线程数达最大且队列满时，执行拒绝策略处理任务。记忆小技巧：核心线程优先接活 → 活太多就放队列 → 队列满了就加临时线程 → 临时线程也满了就拒绝。四、总结Executors被禁止的核心原因是「参数不可控」，导致线程池存在内存溢出或资源耗尽的风险；而ThreadPoolExecutor通过手动配置核心参数，能根据业务场景精准控制线程池的行为，从根源上规避风险。最后再划几个重点：必须使用有界队列（如ArrayBlockingQueue），避免任务堆积。最大线程数需合理配置（CPU密集型：核心数+1；IO密集型：核心数*2）。自定义线程工厂，方便问题排查。选择合适的拒绝策略，避免静默失败。掌握线程池的正确创建方式，不仅能提升程序的稳定性，也是Java面试中的高频考点。希望这篇文章能帮你彻底搞懂这个问题～
-
EasyExcel 实战：导出带图片的 Excel 完整方案 在实际开发中，可能会遇到导出 Excel 时需要包含图片的场景。EasyExcel 作为阿里开源的高效 Excel 处理工具，虽然原生支持图片导出，但在图片格式适配、单元格样式调整等细节上需要自定义扩展。本文将详细讲解如何基于 EasyExcel 实现带图片的 Excel 导出，包含完整代码示例和关键细节说明。一、最终效果展示导出的 Excel 中，图片将自适应单元格大小，无图片时显示"无图"提示，整体格式整洁规范：二、实现步骤详解1. 引入依赖首先在 pom.xml 中添加 EasyExcel 核心依赖（本文使用 4.0.3 版本，适配大部分场景）：<dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>4.0.3</version> </dependency>2. 定义导出实体类创建 RecordExcelVO 作为 Excel 导出的数据载体，核心关注图片字段的配置：package com.retail.ocr.model.vo; import com.alibaba.excel.annotation.ExcelProperty; import com.alibaba.excel.annotation.write.style.ColumnWidth; import com.retail.ocr.excel.converter.ImageConverter; import lombok.Data; /** * Excel 导出实体（识别记录） * * @author jucunqi * @since 2025/11/20 */ @Data public class RecordExcelVO { @ColumnWidth(20) // 列宽设置 @ExcelProperty("手机号") // Excel 表头名称 private String phoneNumber; @ColumnWidth(25) @ExcelProperty("识别时间") private String createTime; @ColumnWidth(20) @ExcelProperty("识别读数") private String number1; @ColumnWidth(20) @ExcelProperty("识别条码") private String number2; // 图片字段：使用自定义转换器处理 byte[] 类型 @ExcelProperty(value = "识别照片", converter = ImageConverter.class) private byte[] imageBytes; @ColumnWidth(20) @ExcelProperty("标记内容") private String markDesc; @ColumnWidth(20) @ExcelProperty("备注") private String remark; }关键说明：图片字段类型为 byte[]：便于存储图片二进制数据（可从文件、数据库 BLOB 字段、网络图片转换获取）。@ExcelProperty(converter = ImageConverter.class)：指定自定义转换器，将 byte[] 转换为 Excel 可识别的图片格式。@ColumnWidth：统一设置列宽，优化 Excel 显示效果。3. 实现图片转换器（核心）自定义 ImageConverter 实现 Converter<byte[]> 接口，负责将图片二进制数据转换为 EasyExcel 支持的 ImageData 格式：package com.retail.ocr.excel.converter; import com.alibaba.excel.converters.Converter; import com.alibaba.excel.enums.CellDataTypeEnum; import com.alibaba.excel.metadata.GlobalConfiguration; import com.alibaba.excel.metadata.data.ImageData; import com.alibaba.excel.metadata.data.ReadCellData; import com.alibaba.excel.metadata.data.WriteCellData; import com.alibaba.excel.metadata.property.ExcelContentProperty; import com.alibaba.excel.util.ListUtils; import lombok.extern.slf4j.Slf4j; import org.springframework.util.CollectionUtils; import java.util.List; @Slf4j public class ImageConverter implements Converter<byte[]> { @Override public Class<?> supportJavaTypeKey() { return List.class; } @Override public CellDataTypeEnum supportExcelTypeKey() { return CellDataTypeEnum.EMPTY; } @Override public byte[] convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception { return null; } @Override public WriteCellData<?> convertToExcelData(byte[] value, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception { // 这里进行对数据实体类的byte[]进行处理 List<ImageData> data = ListUtils.newArrayList(); ImageData imageData; try { imageData = new ImageData(); imageData.setImage(value); data.add(imageData); } catch (Exception e) { log.error("导出临时记录图片异常：", e); } WriteCellData<?> cellData = new WriteCellData<>(); if (!CollectionUtils.isEmpty(data)) { // 图片返回图片列表 cellData.setImageDataList(data); cellData.setType(CellDataTypeEnum.EMPTY); } else { // 没有图片使用汉字表示 cellData.setStringValue("无图"); cellData.setType(CellDataTypeEnum.STRING); } return cellData; } }核心逻辑：校验图片二进制数据有效性，避免空指针异常。有图片时：封装 ImageData 列表，指定 Excel 单元格类型为 IMAGE。无图片时：设置文本"无图"，单元格类型为 STRING，提升用户体验。4. 自定义图片写入处理器由于 EasyExcel 原生图片导出不支持自适应单元格、多图片排列等需求，需自定义 CellWriteHandler 处理图片的位置、大小和样式：package com.retail.ocr.excel.handler; import com.alibaba.excel.enums.CellDataTypeEnum; import com.alibaba.excel.metadata.Head; import com.alibaba.excel.metadata.data.ImageData; import com.alibaba.excel.metadata.data.WriteCellData; import com.alibaba.excel.write.handler.CellWriteHandler; import com.alibaba.excel.write.metadata.holder.WriteSheetHolder; import com.alibaba.excel.write.metadata.holder.WriteTableHolder; import org.apache.commons.collections4.CollectionUtils; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.*; import org.apache.poi.util.Units; import org.apache.poi.xssf.usermodel.XSSFDrawing; import org.apache.poi.xssf.usermodel.XSSFPicture; import org.apache.poi.xssf.usermodel.XSSFShape; import java.util.List; import java.util.concurrent.CopyOnWriteArrayList; import java.util.concurrent.atomic.AtomicReference; public class ImageWriteHandler implements CellWriteHandler { /** * 已经处理的Cell */ private final CopyOnWriteArrayList<String> REPEATS = new CopyOnWriteArrayList<>(); /** * 单元格的图片最大张数（每列的单元格图片张数不确定，单元格宽度需按照张数最多的长度来设置） */ private final AtomicReference<Integer> MAX_IMAGE_SIZE = new AtomicReference<>(0); /** * 标记手动添加的图片，用于排除EasyExcel自动添加的图片 */ private final CopyOnWriteArrayList<Integer> CREATE_PIC_INDEX = new CopyOnWriteArrayList<>(); @Override public void beforeCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Head head, Integer columnIndex, Integer relativeRowIndex, Boolean isHead) { } @Override public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { } @Override public void afterCellDataConverted(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, WriteCellData<?> cellData, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { // 在 数据转换成功后 不是头就把类型设置成空 if (isHead) { return; } // 将要插入图片的单元格的type设置为空,下面再填充图片 if (CollectionUtils.isNotEmpty(cellData.getImageDataList())) { cellData.setType(CellDataTypeEnum.EMPTY); } } @Override public void afterCellDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { // 在 单元格写入完毕后 ，自己填充图片 if (isHead || CollectionUtils.isEmpty(cellDataList)) { return; } boolean listFlag = false; Sheet sheet = cell.getSheet(); // 此处为ExcelUrlConverterUtil的返回值 List<ImageData> imageDataList = cellDataList.get(0).getImageDataList(); if (CollectionUtils.isNotEmpty(imageDataList)) { listFlag = true; } if (!listFlag && imageDataList == null) { return; } String key = cell.getRowIndex() + "_" + cell.getColumnIndex(); if (REPEATS.contains(key)) { return; } REPEATS.add(key); if (imageDataList.size() > MAX_IMAGE_SIZE.get()) { MAX_IMAGE_SIZE.set(imageDataList.size()); } // 默认要导出的图片大小为60*60px,60px的行高大约是900,60px列宽大概是248*8 sheet.getRow(cell.getRowIndex()).setHeight((short) 900); sheet.setColumnWidth(cell.getColumnIndex(), listFlag ? 240 * 8 * MAX_IMAGE_SIZE.get() : 240 * 8); if (listFlag) { for (int i = 0; i < imageDataList.size(); i++) { ImageData imageData = imageDataList.get(i); if (imageData == null) { continue; } byte[] image = imageData.getImage(); this.insertImage(sheet, cell, image, i); } } else { this.insertImage(sheet, cell, imageDataList.get(0).getImage(), 0); } // 清除EasyExcel自动添加的没有格式的图片 XSSFDrawing drawingPatriarch = (XSSFDrawing) sheet.getDrawingPatriarch(); List<XSSFShape> shapes = drawingPatriarch.getShapes(); for (int i = 0; i < shapes.size(); i++) { XSSFShape shape = shapes.get(i); if (shape instanceof XSSFPicture && !CREATE_PIC_INDEX.contains(i)) { CREATE_PIC_INDEX.add(i); XSSFPicture picture = (XSSFPicture) shape; picture.resize(0); } } } /** * 重新插入一个图片 * * @param sheet Excel页面 * @param cell 表格元素 * @param pictureData 图片数据 * @param i 图片顺序 */ private void insertImage(Sheet sheet, Cell cell, byte[] pictureData, int i) { int picWidth = Units.pixelToEMU(60); int index = sheet.getWorkbook().addPicture(pictureData, HSSFWorkbook.PICTURE_TYPE_PNG); CREATE_PIC_INDEX.add(index); Drawing<?> drawing = sheet.getDrawingPatriarch(); if (drawing == null) { drawing = sheet.createDrawingPatriarch(); } CreationHelper helper = sheet.getWorkbook().getCreationHelper(); ClientAnchor anchor = helper.createClientAnchor(); // 设置图片坐标 anchor.setDx1(picWidth * i); anchor.setDx2(picWidth + picWidth * i); anchor.setDy1(0); anchor.setDy2(0); // 设置图片位置 int columnIndex = cell.getColumnIndex(); anchor.setCol1(columnIndex); anchor.setCol2(columnIndex); int rowIndex = cell.getRowIndex(); anchor.setRow1(rowIndex); anchor.setRow2(rowIndex + 1); // ClientAnchor.AnchorType里有多种类型可选，从网上看的之前是不移动，直接悬浮在单元格上了，现在这个是随着单元格移动 anchor.setAnchorType(ClientAnchor.AnchorType.MOVE_AND_RESIZE); drawing.createPicture(anchor, index); } }核心功能：自适应行列宽：根据图片数量动态调整列宽，固定行高适配 60*60px 图片。多图片横向排列：支持单元格内多图片横向显示，间距 10px，避免重叠。图片随单元格移动：设置锚点类型为 MOVE_AND_RESIZE，图片会随单元格位置变化而同步移动。5. 业务层导出实现最后在 Controller 中编写导出接口，整合上述组件完成 Excel 导出：@GetMapping("/recognizeRecordExport") public void recognizeRecordExport(RecognizeRecordPageReqVo reqVo, HttpServletResponse response) throws IOException { // 获取数据逻辑省略 List<RecordExcelVO> excelVOList = getRecordExcelVOS(reqVo); String filename = "识别数据.xlsx"; // 输出 Excel EasyExcel.write(response.getOutputStream(), RecordExcelVO.class) .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理 .registerWriteHandler(new ImageWriteHandler()) .sheet(filename).doWrite(excelVOList); // 设置 header 和 contentType。写在最后的原因是，避免报错时，响应 contentType 已经被修改了 response.addHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename)); response.setContentType("application/vnd.ms-excel;charset=UTF-8"); }关键注意事项：中文文件名乱码：使用 URLEncoder.encode 编码文件名，并指定 filename*=UTF-8'' 格式，兼容主流浏览器。响应头设置：contentType 对于 xlsx 格式需设置为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，xls 格式需改为 application/vnd.ms-excel。流关闭策略：设置 autoCloseStream(false)，避免 EasyExcel 提前关闭响应流导致下载失败。以上就是使用EasyExcel导出带图片文件的所有内容了，希望对大家有所帮助～
-
Java 高效替换 Word 文档内容（模板填充方案） 使用java操作Excel大家应该非常熟悉，但是操作word可能会稍微少一点。本文将提供一套基于 Apache POI 的完整解决方案，支持普通段落+表格单元格的占位符替换，逻辑简洁、可直接复用。一、核心思路模板设计：在 Word 文档中，用 {{占位符名}} 标记需要替换的内容（如 {{name}}、{{date}}）；技术选型：使用 Apache POI（poi-ooxml）解析 .docx 文档，遍历段落和表格，替换占位符；核心优势：无需依赖第三方付费组件，支持复杂文档结构，兼容主流 Word 版本。二、实现步骤1. 环境准备（添加 Maven 依赖）核心依赖 poi-ooxml 用于处理 Office Open XML 格式（.docx），兼容 5.2.0 及以上版本（推荐使用最新稳定版）：<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.0</version> <!-- 你可以使用最新版本 --> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.0</version> </dependency>2. 编写工具类（完整可运行代码）工具类封装了「读取模板、替换占位符、保存文件」全流程，支持普通段落和表格单元格的替换，还保留了原文本格式（字体、大小、颜色）：package com.water.ocrimagerecognize.util; import org.apache.poi.xwpf.usermodel.*; import java.io.*; import java.util.HashMap; import java.util.List; import java.util.Map; public class WordTemplateExporter { public static void main(String[] args) { // 输出文件路径 String outputPath = "output.docx"; try { Map<String,String> contractData = new HashMap<>(); // 占位符替换 contractData.put("date", "2025"); contractData.put("s15", "FF"); contractData.put("s16", "增效降本"); contractData.put("name", "张三"); contractData.put("luca", "lucaju"); contractData.put("s1", "game"); // 加载资源文件夹resources/tem文件夹下的合同模板 //不在resources获取模板文件需要修改此处，通过这个方法只能获取resources中的资源文件 InputStream templateInputStream = new FileInputStream("/Users/lucaju/Documents/文档/水务/word/template.docx"); XWPFDocument document = new XWPFDocument(templateInputStream); // 遍历文档中的段落 for (XWPFParagraph paragraph : document.getParagraphs()) { if (paragraph == null || paragraph.getRuns().size() == 0){ continue; } //替换占位符 change(paragraph,contractData); } // 遍历文档中的表格 for (XWPFTable table : document.getTables()) { for (XWPFTableRow row : table.getRows()) { for (XWPFTableCell cell : row.getTableCells()) { // 遍历单元格中的段落 for (XWPFParagraph cellParagraph : cell.getParagraphs()) { //替换占位符 change(cellParagraph,contractData); } } } } // 遍历文档中的图片 for (XWPFPictureData picture : document.getAllPictures()) { // 图片不会被修改，直接跳过 //需要修改图片在此处 System.out.println("图片： " + picture.getFileName()); } //该路径为相对路径，默认创建保存位置为项目文件所在盘符的根目录下 // 保存填充后的合同（将毫秒数添加到文件名防止命名冲突） String filePath = "contract_" + System.currentTimeMillis() + ".docx"; //检查目录是否存在，不存在则创建 File directory = new File(filePath); // 使用 FileOutputStream 保存填充后的合同 try (FileOutputStream out = new FileOutputStream(filePath)) { document.write(out); // 将内容写入文件 } System.out.println("输出完成"); } catch (Exception e) { e.printStackTrace(); } } //替换占位符方法 public static void change(XWPFParagraph paragraph, Map<String, String> contractData){ for (XWPFRun run : paragraph.getRuns()) { // 获取当前 run 的文本 String runText = run.getText(0); if (runText == null){ continue; } StringBuilder newText = new StringBuilder(runText); // 替换占位符 for (Map.Entry<String, String> entry : contractData.entrySet()) { //此处的占位符“{{”和“}}”可以任意更改，合同模板文件随着替换即可。 String placeholder = "{{" + entry.getKey() + "}}"; int startIndex = newText.indexOf(placeholder); while (startIndex != -1) { newText.replace(startIndex, startIndex + placeholder.length(), entry.getValue()); startIndex = newText.indexOf(placeholder, startIndex + entry.getValue().length()); } } // 更新替换后的文本 run.setText(newText.toString(), 0); } } /** * 替换 Word 文件中的占位符（支持普通段落 + 表格单元格） * * @param document Word 文档对象 * @param placeholder 占位符，例如 {{name}} * @param replacement 替换后的值，例如 "张三" */ private static void replacePlaceholder(XWPFDocument document, String placeholder, String replacement) { // 1. 替换普通段落中的占位符（原有逻辑保留） for (XWPFParagraph paragraph : document.getParagraphs()) { replaceRunInParagraph(paragraph, placeholder, replacement); } // 2. 替换表格中的占位符（新增核心逻辑） for (XWPFTable table : document.getTables()) { // 遍历所有表格 for (XWPFTableRow row : table.getRows()) { // 遍历表格的所有行 for (XWPFTableCell cell : row.getTableCells()) { // 遍历行的所有单元格 for (XWPFParagraph paragraph : cell.getParagraphs()) { // 遍历单元格内的所有段落 replaceRunInParagraph(paragraph, placeholder, replacement); // 替换段落中的占位符 } } } } } /** * 替换单个段落中所有 Run 里的占位符（抽取通用逻辑，避免重复代码） */ private static void replaceRunInParagraph(XWPFParagraph para, String placeholder, String replacement) { List<XWPFRun> runs = para.getRuns(); int runCount = runs.size(); // 情况1：段落只有1个 Run（直接替换） if (runCount == 1) { XWPFRun run = runs.get(0); String text = run.getText(0); if (text != null && text.contains(placeholder)) { run.setText(text.replace(placeholder, replacement), 0); } return; } // 情况2：段落有多个 Run（合并文本后替换） StringBuilder mergedText = new StringBuilder(); // 第一步：合并所有 Run 的文本 for (XWPFRun run : runs) { String text = run.getText(0); if (text != null) { mergedText.append(text); } } // 检查合并后的文本是否包含占位符 String finalText = mergedText.toString(); if (!finalText.contains(placeholder)) { return; // 不包含则无需处理 } // 第二步：替换占位符 finalText = finalText.replace(placeholder, replacement); // 第三步：清空原有所有 Run（兼容低版本 POI 的写法） // 注意：要倒序删除，避免索引错乱 for (int i = runCount - 1; i >= 0; i--) { para.removeRun(i); } // 第四步：创建新的 Run，写入替换后的文本 XWPFRun newRun = para.createRun(); newRun.setText(finalText, 0); // （可选）复制原有文本的格式（如字体、大小、颜色） if (runCount > 0) { XWPFRun originalFirstRun = runs.get(0); // 取第一个 Run 的格式 newRun.setFontFamily(originalFirstRun.getFontFamily()); newRun.setFontSize(originalFirstRun.getFontSize()); newRun.setColor(originalFirstRun.getColor()); } } }3. 模板编辑规范占位符格式：统一使用 {{占位符名}}（如 {{name}}、{{date}}），可自定义分隔符（需同步修改代码中 placeholder 的拼接逻辑）；关键注意点：占位符必须作为一个整体输入（直接复制粘贴 {{name}}，或一次性输入完成）；避免输入一半保存、再续输的操作（会导致占位符被拆分成多个 Run，替换失败）；模板文件需保存为 .docx 格式（不支持 .doc 旧格式，如需兼容可先转成 .docx）。三、使用示例编辑模板 template.docx，内容如下：姓名：{{name}} 日期：{{date}} 项目：{{s1}} 目标：{{s16}}运行 main 方法，传入替换数据；生成的文件中，占位符会被自动替换为对应值：姓名：张三 日期：2025年11月 项目：game 目标：增效降本这套方案轻量化、无额外依赖，适合合同生成、报表导出、通知书批量制作等场景，可直接集成到 Spring Boot、SSM 等主流 Java 项目中。
-
Spring Boot 整合 Milvus 向量数据库：CRUD封装 本文围绕 Spring Boot 集成 Milvus 向量数据库展开，详细介绍了二次封装的完整方案：首先通过配置类实现 Milvus 连接池与连接参数管理，再以@CollectionName和@PrimaryKey注解建立实体与 Milvus Collection 的映射，搭配驼峰转下划线命名策略解决字段名适配问题；核心封装泛型MilvusBaseService
类，实现新增、主键查询、分页查询等通用 CRUD 方法，并针对 Milvus 无原生更新的特性，采用 “先删除后插入” 策略实现更新功能；同时提供 Lambda 查询构造器简化条件查询，辅以工具类处理主键解析等通用逻辑。文中还给出业务层 Service、Controller 的使用示例与完整配置文件，附项目 GitHub 地址，帮助开发者快速落地 Milvus 相关业务。
