init version

2025-12-08 17:05:28 +08:00
commit ce3b71964a
4669 changed files with 224358 additions and 0 deletions
--- a/joju-framework/joju-spring-boot-starter-excel/joju-spring-boot-starter-excel.iml
+++ b/joju-framework/joju-spring-boot-starter-excel/joju-spring-boot-starter-excel.iml
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4" />
--- a/joju-framework/joju-spring-boot-starter-excel/pom.xml
+++ b/joju-framework/joju-spring-boot-starter-excel/pom.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>com.jojubanking.boot</groupId>
+        <artifactId>joju-framework</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>joju-spring-boot-starter-excel</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>Excel 拓展</description>
+    <url>https://www.jojubanking.com</url>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.jojubanking.boot</groupId>
+            <artifactId>joju-common</artifactId>
+        </dependency>
+
+        <!-- 业务组件 -->
+        <dependency>
+            <groupId>com.jojubanking.boot</groupId>
+            <artifactId>joju-spring-boot-starter-biz-dict</artifactId>
+            <optional>true</optional> <!-- 如果希望使用 @DictFormat 注解，需要引入该依赖 -->
+            <version>${revision}</version>
+        </dependency>
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-web</artifactId>
+            <scope>provided</scope> <!-- 设置为 provided，只有 ExcelUtils 使用 -->
+        </dependency>
+
+        <dependency>
+            <groupId>jakarta.servlet</groupId>
+            <artifactId>jakarta.servlet-api</artifactId>
+            <scope>provided</scope> <!-- 设置为 provided，只有 ExcelUtils 使用 -->
+        </dependency>
+
+        <!-- 工具类相关 -->
+        <dependency>
+            <groupId>com.alibaba</groupId>
+            <artifactId>easyexcel</artifactId>
+        </dependency>
+
+    </dependencies>
+
+</project>
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/ExcelTitleHandler.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/ExcelTitleHandler.java
@@ -0,0 +1,59 @@
+package com.jojubanking.boot.framework.excel.core;
+
+import cn.hutool.core.collection.CollectionUtil;
+import cn.hutool.core.util.ObjectUtil;
+import com.alibaba.excel.metadata.Head;
+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.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.Row;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.util.PropertyPlaceholderHelper;
+
+import java.util.List;
+import java.util.Properties;
+
+
+public class ExcelTitleHandler implements CellWriteHandler {
+    /**
+     错误信息处理时正则表达式的格式
+     */
+    private final String EXCEL_ERROR_REG = "^(.*)(\\(错误:)(.*)(\\))$";
+
+    private String bigHead;
+
+    private String dateHead;
+
+    PropertyPlaceholderHelper placeholderHelper = new PropertyPlaceholderHelper("${", "}");
+
+    public ExcelTitleHandler( String bigHead,String dateHead) {
+        this.bigHead = bigHead; //表头1
+        this.dateHead = dateHead;  //表头2
+    }
+
+    @Override
+    public void beforeCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Head head, Integer columnIndex, Integer relativeRowIndex, Boolean isHead) {
+        // 动态设置表头字段
+        if (!ObjectUtil.isEmpty(head)) {
+            List<String> headNameList = head.getHeadNameList();
+            if (CollectionUtil.isNotEmpty(headNameList)) {
+                Properties properties = new Properties();
+                properties.setProperty("bigHead", bigHead);
+                properties.setProperty("dateHead", dateHead);
+                for (int i = 0 ; i < headNameList.size() ; i++){
+                    // 循环遍历替换
+                    headNameList.set(i, placeholderHelper.replacePlaceholders(headNameList.get(i), properties));
+                }
+            }
+        }
+    }
+    @Override
+    public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {
+    }
+    @Override
+    public void afterCellDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {
+    }
+}
+
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/annotations/DictFormat.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/annotations/DictFormat.java
@@ -0,0 +1,22 @@
+package com.jojubanking.boot.framework.excel.core.annotations;
+
+import java.lang.annotation.*;
+
+/**
+ * 字典格式化
+ *
+ * 实现将字典数据的值，格式化成字典数据的标签
+ */
+@Target({ElementType.FIELD})
+@Retention(RetentionPolicy.RUNTIME)
+@Inherited
+public @interface DictFormat {
+
+    /**
+     * 例如说，SysDictTypeConstants、InfDictTypeConstants
+     *
+     * @return 字典类型
+     */
+    String value();
+
+}
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/convert/DictConvert.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/convert/DictConvert.java
@@ -0,0 +1,72 @@
+package com.jojubanking.boot.framework.excel.core.convert;
+
+import cn.hutool.core.convert.Convert;
+import com.jojubanking.boot.framework.dict.core.util.DictFrameworkUtils;
+import com.jojubanking.boot.framework.excel.core.annotations.DictFormat;
+import com.alibaba.excel.converters.Converter;
+import com.alibaba.excel.enums.CellDataTypeEnum;
+import com.alibaba.excel.metadata.GlobalConfiguration;
+import com.alibaba.excel.metadata.data.ReadCellData;
+import com.alibaba.excel.metadata.data.WriteCellData;
+import com.alibaba.excel.metadata.property.ExcelContentProperty;
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * Excel 数据字典转换器
+ *
+ * @author TW
+ */
+@Slf4j
+public class DictConvert implements Converter<Object> {
+
+    @Override
+    public Class<?> supportJavaTypeKey() {
+        throw new UnsupportedOperationException("暂不支持，也不需要");
+    }
+
+    @Override
+    public CellDataTypeEnum supportExcelTypeKey() {
+        throw new UnsupportedOperationException("暂不支持，也不需要");
+    }
+
+    @Override
+    public Object convertToJavaData(ReadCellData readCellData, ExcelContentProperty contentProperty,
+                                    GlobalConfiguration globalConfiguration) {
+        // 使用字典解析
+        String type = getType(contentProperty);
+        String label = readCellData.getStringValue();
+        String value = DictFrameworkUtils.parseDictDataValue(type, label);
+        if (value == null) {
+            log.error("[convertToJavaData][type({}) 解析不掉 label({})]", type, label);
+            return null;
+        }
+        // 将 String 的 value 转换成对应的属性
+        Class<?> fieldClazz = contentProperty.getField().getType();
+        return Convert.convert(fieldClazz, value);
+    }
+
+    @Override
+    public WriteCellData<String> convertToExcelData(Object object, ExcelContentProperty contentProperty,
+                                                    GlobalConfiguration globalConfiguration) {
+        // 空时，返回空
+        if (object == null) {
+            return new WriteCellData<>("");
+        }
+
+        // 使用字典格式化
+        String type = getType(contentProperty);
+        String value = String.valueOf(object);
+        String label = DictFrameworkUtils.getDictDataLabel(type, value);
+        if (label == null) {
+            log.error("[convertToExcelData][type({}) 转换不了 label({})]", type, value);
+            return new WriteCellData<>("");
+        }
+        // 生成 Excel 小表格
+        return new WriteCellData<>(label);
+    }
+
+    private static String getType(ExcelContentProperty contentProperty) {
+        return contentProperty.getField().getAnnotation(DictFormat.class).value();
+    }
+
+}
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/convert/JsonConvert.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/convert/JsonConvert.java
@@ -0,0 +1,34 @@
+package com.jojubanking.boot.framework.excel.core.convert;
+
+import com.jojubanking.boot.framework.common.util.json.JsonUtils;
+import com.alibaba.excel.converters.Converter;
+import com.alibaba.excel.enums.CellDataTypeEnum;
+import com.alibaba.excel.metadata.GlobalConfiguration;
+import com.alibaba.excel.metadata.data.WriteCellData;
+import com.alibaba.excel.metadata.property.ExcelContentProperty;
+
+/**
+ * Excel Json 转换器
+ *
+ * @author TW
+ */
+public class JsonConvert implements Converter<Object> {
+
+    @Override
+    public Class<?> supportJavaTypeKey() {
+        throw new UnsupportedOperationException("暂不支持，也不需要");
+    }
+
+    @Override
+    public CellDataTypeEnum supportExcelTypeKey() {
+        throw new UnsupportedOperationException("暂不支持，也不需要");
+    }
+
+    @Override
+    public WriteCellData<String> convertToExcelData(Object value, ExcelContentProperty contentProperty,
+                                                    GlobalConfiguration globalConfiguration) {
+        // 生成 Excel 小表格
+        return new WriteCellData<>(JsonUtils.toJsonString(value));
+    }
+
+}
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/util/ExcelUtils.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/core/util/ExcelUtils.java
@@ -0,0 +1,333 @@
+package com.jojubanking.boot.framework.excel.core.util;
+
+import com.alibaba.excel.EasyExcel;
+import com.alibaba.excel.write.metadata.style.WriteCellStyle;
+import com.alibaba.excel.write.style.HorizontalCellStyleStrategy;
+import com.alibaba.excel.write.style.column.LongestMatchColumnWidthStyleStrategy;
+import com.jojubanking.boot.framework.excel.core.ExcelTitleHandler;
+import org.apache.poi.ss.usermodel.BorderStyle;
+import org.apache.poi.ss.usermodel.HorizontalAlignment;
+import org.springframework.web.multipart.MultipartFile;
+
+import javax.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.util.List;
+
+/**
+ * Excel 工具类
+ *
+ * @author TW
+ */
+public class ExcelUtils {
+
+    /**
+     * 生成有图片的excel
+     * @param dataList 数据列表
+     */
+//    public static <T>  void generateImageExcel(HttpServletResponse response,List<T> dataList) throws Exception {
+//
+//        if (CollectionUtils.isEmpty(dataList)) return ;
+//        String fileName = "数据列表";
+//        String sheetName = "数据列表";
+//
+//        String picHeadName = "截图";
+//
+//        //图片列最大图片数
+////        AtomicReference<Integer> maxImageSize = new AtomicReference<>(0);
+////        dataList.forEach(item -> {
+////            String picUrls = item.getReportPicUrl();
+////            if (StringUtils.isNotEmpty(picUrls)){
+////                if (picUrls.split(",").length > maxImageSize.get()) {
+////                    maxImageSize.set(picUrls.split(",").length);
+////                }
+////            }
+////        });
+//
+//        // 表头名称和列宽的映射
+////        Map<String, Integer> stringIntegerMap = HandleObjDataUtil.headNameColumnWidthMap(ReportQuestionReplyExportDTO.class);
+////        //设置列长度所用类
+////        AutoColumnWidthStyleStrategy longWidth = new AutoColumnWidthStyleStrategy();
+//
+////        Integer partitionSize = dataList.size()/10;
+////        // 对集合切割分区并发处理
+////        List<List<ReportQuestionReplyExportDTO>> dataPartition = Lists.partition(dataList, partitionSize > 20? 20 : partitionSize);
+//
+////        dataPartition.parallelStream().forEach(objList -> {
+////            objList.forEach(item -> {
+//                WriteCellData<Void> writeCellData = new WriteCellData<>();
+//                if (StringUtils.isNotEmpty(item.getReportPicUrl())) {
+//                    //每张图片间距
+//                    Integer splitWidth = -2;
+//                    //每张图片的长度
+//                    Integer imageWidth = 60;
+//                    //图片列的最大长度
+//                    Integer sumWidth = maxImageSize.get() * (imageWidth + splitWidth);
+//
+//                    List<ImageData> imageDataList = new ArrayList<>();
+//
+//                    List<String> imagePathList = Lists.newArrayList(item.getReportPicUrl().split(","));
+//                    for (int i = 1; i <= imagePathList.size(); i++) {
+//                        String path = imagePathList.get(i - 1);
+//                        Integer left = imageWidth * (i - 1) + i * splitWidth;
+//                        Integer right = sumWidth - imageWidth - left;
+//                        ImageData imageData = new ImageData();
+//
+//                        byte[] bytes = null;
+//                        InputStream inputStream = null;
+//                        ByteArrayOutputStream outputStream = null;
+//                        try {
+//                            inputStream = new URL(path).openStream();
+//                            outputStream = new ByteArrayOutputStream();
+//                            // 对图片进行压缩
+//                            Thumbnails.of(inputStream).scale(0.9f).outputQuality(0.3f).toOutputStream(outputStream);
+//                            bytes = outputStream.toByteArray();
+//                        } catch (IOException e) {
+//                            e.printStackTrace();
+//                            continue;
+//                        } finally {
+//                            if (inputStream != null){
+//                                try {
+//                                    inputStream.close();
+//                                } catch (IOException e) {
+//                                    e.printStackTrace();
+//                                }
+//                            }
+//                        }
+//                        if (bytes.length < 1) continue;
+//
+//                        imageData.setImage(bytes);
+//                        imageData.setImageType(ImageData.ImageType.PICTURE_TYPE_PNG);
+//                        //距离单元格顶部距离
+//                        imageData.setTop(1);
+//                        //距离单元格底部距离
+//                        imageData.setBottom(1);
+//                        //距离单元格左边距离
+//                        imageData.setLeft(left);
+//                        //距离单元格右边距离
+//                        imageData.setRight(right);
+//                        imageData.setAnchorType(ClientAnchorData.AnchorType.MOVE_AND_RESIZE);
+//                        imageDataList.add(imageData);
+//                    }
+//                    writeCellData.set .setImageDataList(imageDataList);
+//
+//
+//                    Map<String, Integer> zdyColumnWidth = new HashMap<>();
+//                    //图片列名称，对应导出对象的列名称，图片列长度
+//                    zdyColumnWidth.put(picHeadName, sumWidth / 6);
+//                    //设置列长度所用类
+//                    longWidth.setZdyColumnWidth(zdyColumnWidth,stringIntegerMap);
+//                }
+//                item.setWriteCellDataFile(writeCellData);
+////            });
+////        });
+//
+//        ResponseDataUtils.setExcelRespProp(response,fileName);
+//        EasyExcel.write(response.getOutputStream())
+//                .registerWriteHandler(longWidth)
+//                .head(ReportQuestionReplyExportDTO.class)
+//                .excelType(ExcelTypeEnum.XLSX)
+//                .sheet(sheetName)
+//                .doWrite(dataList);
+//    }
+
+    /**
+     * 将列表以 Excel 响应给前端
+     *
+     * @param response 响应
+     * @param filename 文件名
+     * @param sheetName Excel sheet 名
+     * @param head Excel head 头
+     * @param data 数据列表哦
+     * @param <T> 泛型，保证 head 和 data 类型的一致性
+     * @throws IOException 写入失败的情况
+     */
+    public static <T> void writexytj(HttpServletResponse response, String xyrwname, String filename, String sheetName,
+                                 Class<T> head, List<T> data) throws IOException {
+
+        WriteCellStyle contentWriteCellStyle = new WriteCellStyle();
+        contentWriteCellStyle.setBorderLeft(BorderStyle.THIN);//细实线
+        contentWriteCellStyle.setBorderTop(BorderStyle.THIN);
+        contentWriteCellStyle.setBorderRight(BorderStyle.THIN);
+        contentWriteCellStyle.setBorderBottom(BorderStyle.THIN);
+        contentWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
+        contentWriteCellStyle.setWrapped(true);
+
+        WriteCellStyle headWriteCellStyle = new WriteCellStyle();
+        headWriteCellStyle.setBorderLeft(BorderStyle.THIN);//细实线
+        headWriteCellStyle.setBorderTop(BorderStyle.THIN);
+        headWriteCellStyle.setBorderRight(BorderStyle.THIN);
+        headWriteCellStyle.setBorderBottom(BorderStyle.THIN);
+        //设置头部标题居中
+        headWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
+        // 这个策略是 头是头的样式 内容是内容的样式 其他的策略可以自己实现
+        HorizontalCellStyleStrategy horizontalCellStyleStrategy =
+                new HorizontalCellStyleStrategy(headWriteCellStyle, contentWriteCellStyle);
+
+//        //创建ExcelWriter写入对象
+//        ExcelWriter excelWriter = EasyExcel.write(response.getOutputStream())
+//                .autoCloseStream(false)
+//                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())
+//
+//                .build();
+//        //创建Sheet对象
+//        WriteSheet sheet = new WriteSheet();
+//        //设置第N个Sheet
+//        sheet.setSheetNo(1);
+//        //设置Sheet名称
+//        sheet.setSheetName(sheetName);
+//        //创建表格对象
+//        WriteTable table = new WriteTable();
+//        //设置第N个表格
+//        table.setTableNo(1);
+//
+//        xyrwname = "2024年第一批次";
+//        //创建表头集合
+//        List<List<String>> headList = new ArrayList<List<String>>();
+//
+//        //第N列的表头
+//        List<String> headTitle1 = new ArrayList<>();
+//        List<String> headTitle2 = new ArrayList<>();
+//        List<String> headTitle3 = new ArrayList<>();
+//        List<String> headTitle4 = new ArrayList<>();
+//        List<String> headTitle5 = new ArrayList<>();
+//        List<String> headTitle6 = new ArrayList<>();
+//        List<String> headTitle7 = new ArrayList<>();
+//        List<String> headTitle8 = new ArrayList<>();
+//        List<String> headTitle9 = new ArrayList<>();
+//        List<String> headTitle10 = new ArrayList<>();
+//        List<String> headTitle11 = new ArrayList<>();
+//        List<String> headTitle12 = new ArrayList<>();
+//        headTitle1.add(xyrwname);
+//        headTitle1.add("就诊ID");
+//        headTitle2.add("xyrwname");
+//        headTitle2.add("学校");
+//        headTitle3.add("xyrwname");
+//        headTitle3.add("班级");
+//        headTitle4.add("");
+//        headTitle4.add("姓名");
+//        headTitle5.add("");
+//        headTitle5.add("性别");
+//        headTitle6.add("");
+//        headTitle6.add("身份证号");
+//        headTitle7.add("");
+//        headTitle7.add("基础项目");
+//        headTitle8.add("");
+//        headTitle8.add("基础项目总额(元)");
+//        headTitle9.add("");
+//        headTitle9.add("可选项目");
+//        headTitle10.add("");
+//        headTitle10.add("可选项目总额(元)");
+//        headTitle11.add("");
+//        headTitle11.add("缴费总额(元)");
+//        headTitle12.add("");
+//        headTitle12.add("就诊ID条码");
+//
+//        headList.add(headTitle1);
+//        headList.add(headTitle2);
+//        headList.add(headTitle3);
+//        headList.add(headTitle4);
+//        headList.add(headTitle5);
+//        headList.add(headTitle6);
+//        headList.add(headTitle7);
+//        headList.add(headTitle8);
+//        headList.add(headTitle9);
+//        headList.add(headTitle10);
+//        headList.add(headTitle11);
+//        headList.add(headTitle12);
+//        table.setHead(headList);
+//
+//        List<List<Object>> list = new ArrayList<>();
+//        excelWriter.write(list, sheet, table);
+//        // 记得 释放资源
+//        excelWriter.finish();
+
+        //指定写出的excel文件
+/*        String fileName = "C:\\Users\\admin\\Desktop\\demo.xlsx";
+        //指定读取的图片文件
+        String imagePath = "C:\\Users\\admin\\Desktop\\路飞.jpg";
+        //如果插入多张
+        List<ImageDemoData> list = new ArrayList<>();
+        //图片对象
+        ImageDemoData imageDemoData = new ImageDemoData();
+        //加入到list
+        list.add(imageDemoData);
+        //这里只用了File，还可以用对象里的InputStream、String、byte[]、URL
+        imageDemoData.setFile(new File(imagePath));
+        EasyExcel.write(fileName, ImageDemoData.class).sheet().doWrite(list);*/
+
+        // 输出 Excel
+        String dateHead = "";
+//        EasyExcel.write(response.getOutputStream(), head)
+//                .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理
+//                .registerWriteHandler(new ExcelTitleHandler(xyrwname, dateHead))
+//                //.registerWriteHandler(new SimpleColumnWidthStyleStrategy(20))
+//                .registerWriteHandler(horizontalCellStyleStrategy)
+//                //.registerWriteHandler(new LongestMatchColumnWidthStyleStrategy()) // 基于 column 长度，自动适配。最大 255 宽度
+//                .sheet(sheetName).doWrite(data);
+        EasyExcel.write(filename, head)
+                .autoCloseStream(true) // 不要自动关闭，交给 Servlet 自己处理
+                .registerWriteHandler(new ExcelTitleHandler(xyrwname, dateHead))
+                //.registerWriteHandler(new SimpleColumnWidthStyleStrategy(20))
+                .registerWriteHandler(horizontalCellStyleStrategy)
+                //.registerWriteHandler(new LongestMatchColumnWidthStyleStrategy()) // 基于 column 长度，自动适配。最大 255 宽度
+                .sheet(sheetName).doWrite(data);
+
+        // 设置 header 和 contentType。写在最后的原因是，避免报错时，响应 contentType 已经被修改了
+//        response.addHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename, "UTF-8"));
+//        response.setContentType("application/vnd.ms-excel;charset=UTF-8");
+    }
+
+
+    /**
+     * 将列表以 Excel 响应给前端
+     *
+     * @param response 响应
+     * @param filename 文件名
+     * @param sheetName Excel sheet 名
+     * @param head Excel head 头
+     * @param data 数据列表哦
+     * @param <T> 泛型，保证 head 和 data 类型的一致性
+     * @throws IOException 写入失败的情况
+     */
+    public static <T> void write(HttpServletResponse response, String filename, String sheetName,
+                                 Class<T> head, List<T> data) throws IOException {
+
+        WriteCellStyle contentWriteCellStyle = new WriteCellStyle();
+        contentWriteCellStyle.setBorderLeft(BorderStyle.THIN);//细实线
+        contentWriteCellStyle.setBorderTop(BorderStyle.THIN);
+        contentWriteCellStyle.setBorderRight(BorderStyle.THIN);
+        contentWriteCellStyle.setBorderBottom(BorderStyle.THIN);
+        contentWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
+        contentWriteCellStyle.setWrapped(true);
+
+        WriteCellStyle headWriteCellStyle = new WriteCellStyle();
+        headWriteCellStyle.setBorderLeft(BorderStyle.THIN);//细实线
+        headWriteCellStyle.setBorderTop(BorderStyle.THIN);
+        headWriteCellStyle.setBorderRight(BorderStyle.THIN);
+        headWriteCellStyle.setBorderBottom(BorderStyle.THIN);
+        //设置头部标题居中
+        headWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
+        // 这个策略是 头是头的样式 内容是内容的样式 其他的策略可以自己实现
+        HorizontalCellStyleStrategy horizontalCellStyleStrategy =
+                new HorizontalCellStyleStrategy(headWriteCellStyle, contentWriteCellStyle);
+
+        // 输出 Excel
+        EasyExcel.write(response.getOutputStream(), head)
+                .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理
+//                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy()) // 基于 column 长度，自动适配。最大 255 宽度
+                .registerWriteHandler(horizontalCellStyleStrategy)
+                .sheet(sheetName).doWrite(data);
+
+        // 设置 header 和 contentType。写在最后的原因是，避免报错时，响应 contentType 已经被修改了
+        response.addHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename, "UTF-8"));
+        response.setContentType("application/vnd.ms-excel;charset=UTF-8");
+    }
+
+    public static <T> List<T> read(MultipartFile file, Class<T> head) throws IOException {
+       return EasyExcel.read(file.getInputStream(), head, null)
+                .autoCloseStream(false)  // 不要自动关闭，交给 Servlet 自己处理
+                .doReadAllSync();
+    }
+
+}
--- a/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/package-info.java
+++ b/joju-framework/joju-spring-boot-starter-excel/src/main/java/com/jojubanking/boot/framework/excel/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * 基于 EasyExcel 实现 Excel 相关的操作
+ */
+package com.jojubanking.boot.framework.excel;
--- a/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/ExcelTitleHandler.class
+++ b/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/ExcelTitleHandler.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/annotations/DictFormat.class
+++ b/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/annotations/DictFormat.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/convert/DictConvert.class
+++ b/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/convert/DictConvert.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/convert/JsonConvert.class
+++ b/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/convert/JsonConvert.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/util/ExcelUtils.class
+++ b/joju-framework/joju-spring-boot-starter-excel/target/classes/com/jojubanking/boot/framework/excel/core/util/ExcelUtils.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/joju-spring-boot-starter-excel-2.0.0-beta.jar
+++ b/joju-framework/joju-spring-boot-starter-excel/target/joju-spring-boot-starter-excel-2.0.0-beta.jar
--- a/joju-framework/joju-spring-boot-starter-excel/target/maven-archiver/pom.properties
+++ b/joju-framework/joju-spring-boot-starter-excel/target/maven-archiver/pom.properties
@@ -0,0 +1,5 @@
+#Generated by Maven
+#Fri Aug 16 12:46:19 CST 2024
+version=2.0.0-beta
+groupId=com.jojubanking.boot
+artifactId=joju-spring-boot-starter-excel
--- a/joju-framework/joju-spring-boot-starter-excel/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst
+++ b/joju-framework/joju-spring-boot-starter-excel/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst
@@ -0,0 +1,5 @@
+com\jojubanking\boot\framework\excel\core\util\ExcelUtils.class
+com\jojubanking\boot\framework\excel\core\annotations\DictFormat.class
+com\jojubanking\boot\framework\excel\core\convert\DictConvert.class
+com\jojubanking\boot\framework\excel\core\ExcelTitleHandler.class
+com\jojubanking\boot\framework\excel\core\convert\JsonConvert.class
--- a/joju-framework/joju-spring-boot-starter-excel/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst
+++ b/joju-framework/joju-spring-boot-starter-excel/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst
@@ -0,0 +1,6 @@
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\core\annotations\DictFormat.java
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\core\convert\JsonConvert.java
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\core\convert\DictConvert.java
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\package-info.java
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\core\ExcelTitleHandler.java
+E:\D-Springboot\kfdj\kfdj\joju-framework\joju-spring-boot-starter-excel\src\main\java\com\jojubanking\boot\framework\excel\core\util\ExcelUtils.java