Freemarker模版导出Excel：终结打开时“文件损坏”的困扰

2023-05-30 00:00:14

使用 FreeMarker 模板导出 Excel 文件时避免“文件已损坏”提示

问题

当使用 FreeMarker 模板导出 Excel 文件时，您是否遇到过在用微软 Office 打开文件时出现“文件已损坏”提示的情况？如果您为此感到烦恼，那么这篇文章将为您提供一个简单有效的解决方案，让您轻松解决此问题。

问题原因

在 FreeMarker 模板中，默认使用 POI 库来导出 Excel 文件。然而，POI 库默认导出的 Excel 文件格式是 OLE2，此格式与微软 Office 使用的 OOXML 格式不兼容。因此，当使用微软 Office 打开 OLE2 格式的 Excel 文件时，就会出现“文件已损坏”提示。

解决方案

要解决此问题，我们可以使用 POI 库提供的 HSSFWorkbook 类来导出 Excel 文件。HSSFWorkbook 类导出的 Excel 文件格式是 XLS，此格式与微软 Office 使用的 OOXML 格式兼容。因此，当使用微软 Office 打开 XLS 格式的 Excel 文件时，就不会出现“文件已损坏”提示了。

步骤

在您的 Java 项目中引入 POI 库的依赖项。
使用 HSSFWorkbook 类创建一个新的工作簿。
使用 HSSFSheet 类创建工作表。
使用 HSSFRow 类和 HSSFCell 类添加数据。
使用 HSSFWorkbook 类的 write() 方法将工作簿保存为 XLS 格式的文件。

示例代码

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFCell;

public class FreemarkerExportExcel {

    public static void main(String[] args) {
        // 创建工作簿
        HSSFWorkbook workbook = new HSSFWorkbook();

        // 创建工作表
        HSSFSheet sheet = workbook.createSheet("Sheet1");

        // 创建行
        HSSFRow row = sheet.createRow(0);

        // 创建单元格
        HSSFCell cell = row.createCell(0);

        // 设置单元格的值
        cell.setCellValue("Hello World");

        // 保存工作簿
        workbook.write(new FileOutputStream("test.xls"));
    }
}

以上代码将创建一个名为“test.xls”的 XLS 格式的 Excel 文件。您可以使用微软 Office 正常打开此文件，而不会出现“文件已损坏”提示。

注意事项

如果您使用 FreeMarker 的模板导出 Excel 文件，则需要在模板中使用 HSSFWorkbook 类而不是 Workbook 类。否则，导出的 Excel 文件仍然是 OLE2 格式的，无法使用微软 Office 正常打开。

解决后的优点

解决了此问题后，您将体验到：

轻松导出 Excel 文件，无需担心文件损坏的烦恼。
文件兼容性更强，可以在微软 Office 和国产 Office 中正常打开。
导出速度更快，因为 XLS 格式的 Excel 文件体积更小。

常见问题解答

如何将数据从 FreeMarker 模板导出到 Excel 文件？

使用 HSSFWorkbook 类创建工作簿，使用 HSSFSheet 类创建工作表，并使用 HSSFRow 和 HSSFCell 类添加数据。
导出为 XLS 格式的 Excel 文件有何好处？

XLS 格式的 Excel 文件与微软 Office 兼容，并且体积更小，导出速度更快。
如果我仍然遇到“文件已损坏”错误怎么办？

确保您使用 HSSFWorkbook 类导出 XLS 格式的 Excel 文件，并且文件路径和文件名没有特殊字符。
我可以使用 FreeMarker 模板动态导出 Excel 数据吗？

是的，您可以使用 FreeMarker 的数据模型和模板语法动态填充 Excel 文件。
导出为 XLS 格式会影响 Excel 文件的质量吗？

不会，XLS 格式支持与 OOXML 格式相同的功能和数据完整性。