快捷導(dǎo)航

java基于poi-ooxml編寫Excel導(dǎo)出的工具類

更新時間：2025年08月22日 10:15:53 作者：yujkss

這篇文章主要為大家詳細介紹了java如何基于poi-ooxml編寫一個Excel導(dǎo)出功能的工具類,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

1. 添加poi-ooxml依賴

在 pom.xml 中添加 Apache POI 依賴：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

2. Excel導(dǎo)出工具類

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;
import java.io.IOException;
import java.lang.reflect.Field;
import java.util.List;

/**
 * Excel導(dǎo)出工具類
 */
public class ExcelExporter {

    /**
     * 導(dǎo)出數(shù)據(jù)到Excel文件
     * @param dataList  數(shù)據(jù)列表（泛型支持任意對象）
     * @param headers   表頭配置，格式：{ {"列名1", "字段名1"}, {"列名2", "字段名2"} }
     * @param filePath  導(dǎo)出文件路徑（如：/tmp/data.xlsx）
     */
    public static <T> void exportToExcel(List<T> dataList, String[][] headers, String filePath) {
        try (Workbook workbook = new XSSFWorkbook()) { // 創(chuàng)建Excel工作簿（xlsx格式）
            Sheet sheet = workbook.createSheet("Sheet1"); // 創(chuàng)建Sheet頁

            // 1. 創(chuàng)建表頭行
            Row headerRow = sheet.createRow(0);
            for (int i = 0; i < headers.length; i++) {
                Cell cell = headerRow.createCell(i);
                cell.setCellValue(headers[i][0]); // 寫入列名
            }

            // 2. 填充數(shù)據(jù)行
            for (int rowIdx = 0; rowIdx < dataList.size(); rowIdx++) {
                T data = dataList.get(rowIdx);
                Row dataRow = sheet.createRow(rowIdx + 1); // 數(shù)據(jù)從第2行開始

                // 通過反射獲取字段值
                for (int colIdx = 0; colIdx < headers.length; colIdx++) {
                    String fieldName = headers[colIdx][1]; // 獲取字段名
                    Object value = getFieldValue(data, fieldName);
                    
                    Cell cell = dataRow.createCell(colIdx);
                    setCellValue(cell, value); // 寫入單元格值
                }
            }

            // 3. 自動調(diào)整列寬
            for (int i = 0; i < headers.length; i++) {
                sheet.autoSizeColumn(i);
            }

            // 4. 寫入文件
            try (FileOutputStream fos = new FileOutputStream(filePath)) {
                workbook.write(fos);
            }
            System.out.println("Excel導(dǎo)出成功，路徑：" + filePath);

        } catch (IOException | ReflectiveOperationException e) {
            System.err.println("導(dǎo)出Excel失?。? + e.getMessage());
        }
    }

    /**
     * 通過反射獲取對象的字段值
     */
    private static <T> Object getFieldValue(T data, String fieldName) 
            throws NoSuchFieldException, IllegalAccessException {
        Field field = data.getClass().getDeclaredField(fieldName);
        field.setAccessible(true); // 允許訪問私有字段
        return field.get(data);
    }

    /**
     * 設(shè)置單元格的值（支持String、Number、Boolean類型）
     */
    private static void setCellValue(Cell cell, Object value) {
        if (value == null) {
            cell.setCellValue("");
        } else if (value instanceof Number) {
            cell.setCellValue(((Number) value).doubleValue());
        } else if (value instanceof Boolean) {
            cell.setCellValue((Boolean) value);
        } else {
            cell.setCellValue(value.toString());
        }
    }
}

import java.util.Arrays;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        // 模擬數(shù)據(jù)
        List<User> userList = Arrays.asList(
            new User("張三", 25, true),
            new User("李四", 30, false)
        );

        // 表頭配置：{ "列顯示名", "實體類字段名" }
        String[][] headers = {
            {"姓名", "name"},
            {"年齡", "age"},
            {"是否VIP", "isVip"}
        };

        // 導(dǎo)出Excel
        ExcelExporter.exportToExcel(userList, headers, "users.xlsx");
    }
}