java怎么导出excel模板

Java导出Excel模板的几种常见方法包括：使用Apache POI库、JExcelAPI库、使用第三方工具如EasyExcel、结合模板引擎如Freemarker进行导出。这里，我们将详细介绍如何使用Apache POI库导出Excel模板，因为它是目前Java开发中最常用且功能强大的解决方案。

一、准备工作

在使用Apache POI进行Excel导出之前，我们需要先做好一些准备工作，包括添加所需的依赖库和创建基本的项目结构。

1. 添加Apache POI依赖

Apache POI是一个开源的Java API库，用于操作Microsoft Office文档。我们需要将其依赖添加到项目中。如果你使用的是Maven项目，可以在pom.xml文件中添加如下依赖：

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

2. 创建基本的项目结构

确保你有一个基本的Java项目结构，包含必要的包和类。通常情况下，你会有一个src/main/java目录以及一个包含资源文件的src/main/resources目录。

二、使用Apache POI库导出Excel模板

Apache POI提供了丰富的API来创建和操作Excel文件。我们将通过一个详细的例子来展示如何创建一个Excel模板并填充数据。

1. 创建Excel工作簿和工作表

首先，我们需要创建一个Excel工作簿和工作表。以下是一个简单的例子：

import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.ss.usermodel.WorkbookFactory;
import org.apache.poi.ss.usermodel.Sheet;
public class ExcelExporter {
    public static void main(String[] args) {
        try (Workbook workbook = WorkbookFactory.create(false)) {
            Sheet sheet = workbook.createSheet("Sheet1");
            // 继续往下添加内容
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 定义模板格式

接下来，我们需要定义Excel模板的格式，包括表头、列宽等。以下是一个例子：

import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
public class ExcelExporter {
    public static void main(String[] args) {
        try (Workbook workbook = WorkbookFactory.create(false)) {
            Sheet sheet = workbook.createSheet("Sheet1");
            // 创建表头
            Row headerRow = sheet.createRow(0);
            String[] headers = {"ID", "Name", "Age", "Department"};
            for (int i = 0; i < headers.length; i++) {
                Cell cell = headerRow.createCell(i);
                cell.setCellValue(headers[i]);
            }
            // 设置列宽
            for (int i = 0; i < headers.length; i++) {
                sheet.setColumnWidth(i, 4000);
            }
            // 继续往下添加内容
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 填充数据

在定义好模板格式后，我们可以开始填充数据。以下是一个例子：

import org.apache.poi.ss.usermodel.*;
public class ExcelExporter {
    public static void main(String[] args) {
        try (Workbook workbook = WorkbookFactory.create(false)) {
            Sheet sheet = workbook.createSheet("Sheet1");
            // 创建表头
            Row headerRow = sheet.createRow(0);
            String[] headers = {"ID", "Name", "Age", "Department"};
            for (int i = 0; i < headers.length; i++) {
                Cell cell = headerRow.createCell(i);
                cell.setCellValue(headers[i]);
            }
            // 设置列宽
            for (int i = 0; i < headers.length; i++) {
                sheet.setColumnWidth(i, 4000);
            }
            // 填充数据
            Object[][] data = {
                {1, "John Doe", 25, "HR"},
                {2, "Jane Smith", 30, "Finance"},
                {3, "Mike Johnson", 35, "IT"}
            };
            for (int i = 0; i < data.length; i++) {
                Row row = sheet.createRow(i + 1);
                for (int j = 0; j < data[i].length; j++) {
                    Cell cell = row.createCell(j);
                    if (data[i][j] instanceof String) {
                        cell.setCellValue((String) data[i][j]);
                    } else if (data[i][j] instanceof Integer) {
                        cell.setCellValue((Integer) data[i][j]);
                    }
                }
            }
            // 保存Excel文件
            try (FileOutputStream fileOut = new FileOutputStream("template.xlsx")) {
                workbook.write(fileOut);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

三、导出复杂的Excel模板

在实际应用中，导出的Excel模板可能会更加复杂，包括合并单元格、添加样式等。我们将逐步讲解如何实现这些功能。

1. 合并单元格

Apache POI提供了CellRangeAddress类来实现单元格的合并。以下是一个例子：

import org.apache.poi.ss.util.CellRangeAddress;
public class ExcelExporter {
    public static void main(String[] args) {
        try (Workbook workbook = WorkbookFactory.create(false)) {
            Sheet sheet = workbook.createSheet("Sheet1");
            // 创建表头
            Row headerRow = sheet.createRow(0);
            String[] headers = {"ID", "Name", "Age", "Department"};
            for (int i = 0; i < headers.length; i++) {
                Cell cell = headerRow.createCell(i);
                cell.setCellValue(headers[i]);
            }
            // 合并单元格
            sheet.addMergedRegion(new CellRangeAddress(0, 0, 1, 2));
            // 设置列宽
            for (int i = 0; i < headers.length; i++) {
                sheet.setColumnWidth(i, 4000);
            }
            // 填充数据
            Object[][] data = {
                {1, "John Doe", 25, "HR"},
                {2, "Jane Smith", 30, "Finance"},
                {3, "Mike Johnson", 35, "IT"}
            };
            for (int i = 0; i < data.length; i++) {
                Row row = sheet.createRow(i + 1);
                for (int j = 0; j < data[i].length; j++) {
                    Cell cell = row.createCell(j);
                    if (data[i][j] instanceof String) {
                        cell.setCellValue((String) data[i][j]);
                    } else if (data[i][j] instanceof Integer) {
                        cell.setCellValue((Integer) data[i][j]);
                    }
                }
            }
            // 保存Excel文件
            try (FileOutputStream fileOut = new FileOutputStream("template.xlsx")) {
                workbook.write(fileOut);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 添加样式

为了使Excel看起来更美观，我们可以为单元格添加样式。以下是一个例子：

import org.apache.poi.ss.usermodel.*;
public class ExcelExporter {
    public static void main(String[] args) {
        try (Workbook workbook = WorkbookFactory.create(false)) {
            Sheet sheet = workbook.createSheet("Sheet1");
            // 创建表头
            Row headerRow = sheet.createRow(0);
            String[] headers = {"ID", "Name", "Age", "Department"};
            for (int i = 0; i < headers.length; i++) {
                Cell cell = headerRow.createCell(i);
                cell.setCellValue(headers[i]);
            }
            // 添加样式
            CellStyle headerStyle = workbook.createCellStyle();
            Font headerFont = workbook.createFont();
            headerFont.setBold(true);
            headerStyle.setFont(headerFont);
            for (int i = 0; i < headers.length; i++) {
                headerRow.getCell(i).setCellStyle(headerStyle);
            }
            // 设置列宽
            for (int i = 0; i < headers.length; i++) {
                sheet.setColumnWidth(i, 4000);
            }
            // 填充数据
            Object[][] data = {
                {1, "John Doe", 25, "HR"},
                {2, "Jane Smith", 30, "Finance"},
                {3, "Mike Johnson", 35, "IT"}
            };
            for (int i = 0; i < data.length; i++) {
                Row row = sheet.createRow(i + 1);
                for (int j = 0; j < data[i].length; j++) {
                    Cell cell = row.createCell(j);
                    if (data[i][j] instanceof String) {
                        cell.setCellValue((String) data[i][j]);
                    } else if (data[i][j] instanceof Integer) {
                        cell.setCellValue((Integer) data[i][j]);
                    }
                }
            }
            // 保存Excel文件
            try (FileOutputStream fileOut = new FileOutputStream("template.xlsx")) {
                workbook.write(fileOut);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

四、导出Excel模板的其他方法

1. 使用JExcelAPI库

JExcelAPI是另一个用于操作Excel文件的Java库。它比Apache POI更轻量，但功能也相对较少。以下是一个简单的例子：

import jxl.Workbook;
import jxl.write.*;
import java.io.File;
public class JExcelExporter {
    public static void main(String[] args) {
        try {
            WritableWorkbook workbook = Workbook.createWorkbook(new File("template.xls"));
            WritableSheet sheet = workbook.createSheet("Sheet1", 0);
            // 创建表头
            String[] headers = {"ID", "Name", "Age", "Department"};
            for (int i = 0; i < headers.length; i++) {
                Label label = new Label(i, 0, headers[i]);
                sheet.addCell(label);
            }
            // 填充数据
            Object[][] data = {
                {1, "John Doe", 25, "HR"},
                {2, "Jane Smith", 30, "Finance"},
                {3, "Mike Johnson", 35, "IT"}
            };
            for (int i = 0; i < data.length; i++) {
                for (int j = 0; j < data[i].length; j++) {
                    Label label = new Label(j, i + 1, data[i][j].toString());
                    sheet.addCell(label);
                }
            }
            workbook.write();
            workbook.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 使用EasyExcel库

EasyExcel是阿里巴巴开源的一个快速、简单的Excel操作工具。以下是一个简单的例子：

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;
import java.util.ArrayList;
import java.util.List;
public class EasyExcelExporter {
    public static void main(String[] args) {
        List<ExcelData> dataList = new ArrayList<>();
        dataList.add(new ExcelData(1, "John Doe", 25, "HR"));
        dataList.add(new ExcelData(2, "Jane Smith", 30, "Finance"));
        dataList.add(new ExcelData(3, "Mike Johnson", 35, "IT"));
        String fileName = "template.xlsx";
        EasyExcel.write(fileName, ExcelData.class).sheet("Sheet1").doWrite(dataList);
    }
    public static class ExcelData {
        @ExcelProperty("ID")
        private Integer id;
        @ExcelProperty("Name")
        private String name;
        @ExcelProperty("Age")
        private Integer age;
        @ExcelProperty("Department")
        private String department;
        public ExcelData(Integer id, String name, Integer age, String department) {
            this.id = id;
            this.name = name;
            this.age = age;
            this.department = department;
        }
        // getters and setters
    }
}

五、结合模板引擎进行导出

1. 使用Freemarker

Freemarker是一个模板引擎，可以用于生成各种格式的文本文件。我们可以结合Freemarker和Apache POI来生成Excel文件。以下是一个简单的例子：

首先，创建一个Freemarker模板文件template.ftl：

<#list data as row>
${row.id} ${row.name} ${row.age} ${row.department}
</#list>

接下来，使用Java代码生成Excel文件：

import freemarker.template.Configuration;
import freemarker.template.Template;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileOutputStream;
import java.io.StringWriter;
import java.util.*;
public class FreemarkerExporter {
    public static void main(String[] args) {
        try {
            Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
            cfg.setClassForTemplateLoading(FreemarkerExporter.class, "/");
            Template template = cfg.getTemplate("template.ftl");
            Map<String, Object> dataModel = new HashMap<>();
            List<Map<String, Object>> dataList = new ArrayList<>();
            dataList.add(new HashMap<String, Object>() {{
                put("id", 1);
                put("name", "John Doe");
                put("age", 25);
                put("department", "HR");
            }});
            dataList.add(new HashMap<String, Object>() {{
                put("id", 2);
                put("name", "Jane Smith");
                put("age", 30);
                put("department", "Finance");
            }});
            dataList.add(new HashMap<String, Object>() {{
                put("id", 3);
                put("name", "Mike Johnson");
                put("age", 35);
                put("department", "IT");
            }});
            dataModel.put("data", dataList);
            StringWriter writer = new StringWriter();
            template.process(dataModel, writer);
            String content = writer.toString();
            Workbook workbook = new XSSFWorkbook();
            Sheet sheet = workbook.createSheet("Sheet1");
            String[] lines = content.split("n");
            for (int i = 0; i < lines.length; i++) {
                Row row = sheet.createRow(i);
                String[] values = lines[i].split(" ");
                for (int j = 0; j < values.length; j++) {
                    Cell cell = row.createCell(j);
                    cell.setCellValue(values[j]);
                }
            }
            try (FileOutputStream fileOut = new FileOutputStream("template.xlsx")) {
                workbook.write(fileOut);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

结论

本文详细介绍了如何使用Java导出Excel模板的方法，包括使用Apache POI库、JExcelAPI库、EasyExcel库以及结合Freemarker模板引擎的方法。Apache POI库是功能最强大、应用最广泛的解决方案，EasyExcel库则提供了一个更为简洁和高效的操作方式。结合Freemarker模板引擎，可以实现更加灵活和定制化的Excel导出。

无论是简单的表格导出还是复杂的报表生成，只要掌握了这些方法，你就能在Java开发中轻松实现Excel导出功能。