本文共 1825 字，大约阅读时间需要 6 分钟。

引入以下依赖以支持Excel操作：

   
    
    
     org.apache.poi
    
    
    
     poi
    
    
    
     3.17
    
   

Java模型类与Excel的绑定

为了简化Excel数据与Java对象的映射，我们定义了一个自定义注解Excel，用于描述字段对应的Excel列信息。该注解支持以下配置：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Excel {
    String name(); // 列的名称
    int width() default 6000; // 列的宽度
    int index() default -1; // 生成的顺序索引
    boolean isMust() default true; // 是否为必须值，默认为必须
}

Java对象与Excel的转换工具类

[mining](# mining) 为您提供了一款优雅的Excel数据转换工具，其核心功能包括对象字段提取与Excel文件解析。如果您使用该工具，可以通过指定目标Class和自定义映射关系来实现数据转换。

核心功能说明

工具首先读取对象模型类的字段信息，获取每个字段的注解设置，并基于这些设置生成对应的Excel文件。字段对应的值通过反射调用get/set方法获取。

public class ExcelUtil {
    private static final Logger logger = LoggerFactory.getLogger(ExcelUtil.class);
    public static HSSFWorkbook toExcel(List
    objList) {
        // ... 详细逻辑 ...
        // 最终返回Excel工作簿
    }
}

2. Excel文件到对象的反射赋值

工具内置了对Excel文件的解析功能，根据文件的列信息反射赋值到目标对象上。支持批量导入多个对象。

public static List
    
      excelFileToObject(MultipartFile file, Class
     
       c) {
    // ... 详细逻辑 ...
    // 最终返回模型列表
}
     
    

---

导出与导入的使用示例

导出示例

3. 准备数据

List
    
      models = Arrays.asList(
    new GoodsExcelModel("商品编码", "型号", "系列", "库存", "属性值", "价格", "商品编码", 1234),
    // 其他对象
);
    

2. 执行导出

Workbook wb = ExcelUtil.toExcel(models);
// 定义输出文件路径
FileOutputStream fileOutputStream = new File("output.xlsx").getOption("output");
ExcelUtil.writeFile(wb, fileOutputStream);

导入示例

3. 准备Excel文件

LocalFileInputStream fileInputStream = new LocalFileInputStream(new File("input.xlsx"));
ListBox box = ExcelUtil.readExcel(fileInputStream);

2. 反射赋值

List
      
        models = ExcelUtil.excelFileToObject(box, GoodsExcelModel.class);
      

---

测试与调试

为了确保系统稳定，建议在应用程序部署前进行以下测试：

3. 验证字段映射正确性

   • 确保Excel文件的列顺序与模型字段顺序一致
   • 验证字段名称与Excel列名称匹配

4. 测试特殊场景

   • 模拟必填字段空缺
   • 测试列宽度与对齐配置
   • 导入数据时确保序列一致性

---

接下来，您可以根据实际需求定制工具类配置，添加更多先进的Excel处理功能。