当前位置：首页 > news >正文

通过xml配置实现数据动态导入导出Excel

news 来源：原创 2024/9/29 5:27:38

spring-dj-excel-common.jar 一个可以通过动态配置 xml 建立 Excel 与数据关系现实数据导入导出的 spring 组件包，在 xml 配置文件里，你可以很方便的定义 Excel - sheet 表列头文本与数据表、数据实体属性的对应关系，对于创建 Excel 文件，你可以通过增加某一标签列的子项实现列头跨列展示效果，同时你也可以通过设置列头对应的样式属性 headStyle 来设置sheet表列头的文字、颜色、边框的展示效果，你也可以针对每一列进行单独的样式设置。

首先，为Excel文件与项目中的数据模型和数据表之间的关系创建一个配置文件，如果要将数据导入到Excel文件中，那么也可以在配置文件中对Excel文件进行基本的样式设置，例如，可以设置列宽， Excel 的文本大小、颜色、字体等。

单击此链接，可以下载资源编译代码生成的 JAR 包文件

单击此链接，可以下载 spring-dj-excel-common.jar 包的源代码

下面是一个简单的配置文件示例，配置文件名称可以根据实际业务进行命名，可以在源码包的 resources/excelconfigs 路径下看到示例配置文件。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<FieldMappings table="UserInfo"title="User information"headStyle="text-align:center;text-valign:center;background-color:green;color:white;border-width:1px;border-color:yellow;">    <column alias="name" allowEmpty="false" columnWidth="100" length="5" name="name" text="Name" type="string" style=""/><column alias="sex" allowEmpty="false" columnWidth="80" length="1" name="gender" text="Gender" type="string" style=""/><column alias="age" allowEmpty="true" columnWidth="80" name="age" text="Age" type="int" style=""/><column alias="phone" allowEmpty="false" columnWidth="180" length="20" name="phone" text="Phone" type="string" style=""/><!--If the column has children, it means that the parent column needs to be displayed across columns--><column alias="course" name="course" text="Course"><column alias="chinese" allowEmpty="false" columnWidth="120" length="0" name="chinese" text="Chinese" type="float" style=""/><column alias="physics" allowEmpty="false" columnWidth="120" length="0" name="physics" text="Physics" type="float" style=""/></column><column alias="address" allowEmpty="true" width="300" length="100" name="address" text="Address" type="string" style=""/>
</FieldMappings>

配置说明：
name - 对相应数据表中的列的名称
alias - 列的别名（对应于数据模型的属性名称）
text - Excel 文件中表格的列标题文本
columnWidth - 设置 Excel 文件中表的列宽，也可以使用 width 属性
allowEmpty - 在将数据导入 Excel 时，是否允许数据为空, 设置为 true 表示允许为空
type - 数据类型, 类型范围: string, int, float, double, boolean, date
length - 数据允许的长度，类型为 string 时有效
headStyle - Excel文件列标题样式设置，可以设置单元格背景颜色、单元格前景色、单元格边框线宽和边框线颜色、文本大小、文本在单元格中的位置、文本字体类型、文本粗体
style - 为指定列设置单独的样式，与 headStyle 类似，此属性优先于 headStyle 属性

通常，配置文件位于项目的资源目录中：
main
--java
--resources
----excelconfig
------excel-user-info.xml
----application.yml

向启动类添加 @EnableExcelConfigScan 注解，并指定 XML 配置文件目录位置。
示例：

  @SpringBootApplicatio@EnableExcelConfigScan(configPackages = {"excelconfig"})public class UserInformationApplication {public static void main(String[] args) {SpringApplication.run(UserInformationApplication.class, args);}}

如何使用该组件呢？

该组件支持xls和xlsx文件格式两种格式的数据导入和导出，在程序中，Excel2003表示后缀为xls文件格式，Excel2007表示xlsx文件格式后缀。

1、从 Excel 文件获取数据

@Autowired
private IExcel2003Export excel2003Export;
@Autowired
private IExcel2007Import excel2007Import;@Test
void getDataFromExcel() throws Exception {        String fPath = "D:\\user-info.xls";//The third parameter value 'UserInfo', corresponds to the value of the table attribute in the xml configuration fileexcel2003Export.exportToEntityFromFile(fPath, "Sheet1", "UserInfo", UserInfo.class, ((entity, rowIndex) -> {//Get the data for each row in the Excel fileSystem.out.println("row: " + rowIndex + ", data: " + entity.toString());return true;}));
}

2、把数据导入到 Excel 中

@Autowired
private IExcel2003Export excel2003Export;
@Autowired
private IExcel2007Import excel2007Import;private byte[] createExcel(IExcelImport excelImport) {String extName = "xls";if (IExcel2007Import.class.isAssignableFrom(excelImport.getClass())) extName = "xlsx";   try {//Getting an IExcelBuilder interface object is equivalent to creating a new sheet formIExcelBuilder builder = excelImport.createBuilder("UserInfo");UserInfo userInfo = new UserInfo();userInfo.setName("DJ").setAge(18).setPhone("1231456789").setGender(1).setUid("admin").setPwd("admin").setEmail("dj@qq.com").setAddress("China").setOrder_by(1).setIs_enabled(true);builder.createRow(userInfo, UserInfo.class);//Here we get another IExcelBuilder interface object, and we create a new sheet againbuilder = excelImport.createBuilder("UserInfo");builder.setSheetName("UserInfoQueryDTO");//Here's how to get the UserInfo data from the database and import it into the newly created sheet formList<UserInfoQueryDTO> dtos = findUserInfoByName("allan");builder.createRows(dtos, UserInfoQueryDTO.class);byte[] datas = excelImport.getBytes();//You can also choose to save the created Excel file to a specified disk location//excelImport.save("D:\\user-info.xlsx");return datas;} catch (Exception e) {System.out.println("Excel import exception: " + e);} finally {try {excelImport.close();} catch (Exception e) {//}}return new byte[0];
}

//使用 IExcel2003Export 去调用 createExcel 方法
byte[] data = createExcel(excel2003Import);

//使用 IExcel2007Export 去调用 createExcel 方法
byte[] data = createExcel(excel2007Import);