parent-spring-tools

包含多个小型 Spring/工具模块的单体仓库，用于常见开发任务。

模块列表

spring-excel-mapper — 轻量级、注解驱动的 Excel 导入/导出映射器
- 📖 API 与设计文档
- 📖 English Documentation
spring-tools-simples — 演示/示例应用，包含使用模式
- 📖 使用示例与模式

快速开始

<dependency>
    <groupId>org.springtools</groupId>
    <artifactId>spring-excel-mapper</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>

// 1. 使用注解定义模型（支持正则、数值范围等校验）
@ExcelSheet
@ExcelRow(startRowIndex = 1)
public class StudentExcelModel {
    @ExcelColumn(col = "A", required = true)
    public String name;
    
    @ExcelColumn(col = "B", regex = "^[\\w-\\.]+@([\\w-]+\\.)+[\\w-]{2,4}$")
    public String email;
    
    @ExcelColumn(col = "C", min = 18, max = 65)
    public Integer age;
}

// 2. 解析 Excel（带验证）
Workbook workbook = WorkbookFactory.create(inputStream);
ImportResult<StudentExcelModel> result = 
    ExcelMapper.parseWorkbookWithResult(workbook, StudentExcelModel.class, false);

// 3. 导出到模板（保留样式）
Sheet sheet = workbook.getSheet("Students");
ExcelExporter.fillTableRows(sheet, 1, result.getSuccessList(), StudentExcelModel.class);

查看使用模式了解详细示例。

构建

# 构建所有模块
mvn clean package

# 构建特定模块
mvn -pl spring-excel-mapper -am package

# 运行示例应用
mvn -pl spring-tools-simples spring-boot:run

文档

API 参考与设计： spring-excel-mapper/README-zh.md
使用模式： spring-tools-simples/README-zh.md
English Documentation: README.md

系统要求

Java 17+
Spring Boot 2.7+（示例模块需要）
Apache POI 5.x

This site is open source. Improve this page.