Java 下载 XLS 文件的实用指南

在现代软件开发中，处理 Excel 文件是一个常见的需求，特别是在企业应用和数据分析中。许多 Java 开发者在构建 web 应用时会遇到需要下载 Excel 文件的场景。本文将介绍如何使用 Java 下载 XLS 文件，并提供代码示例。

1. 使用 Apache POI 创建 XLS 文件

Apache POI 是一个强大的 Java 库，用于读取和写入 Microsoft Office 文档。我们可以使用 Apache POI 来创建一个简单的 XLS 文件，并通过 Servlet 下载这个文件。

1.1 添加 Maven 依赖

如果我们的项目使用 Maven 管理依赖，需要在 pom.xml 文件中添加 Apache POI 的依赖：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.3</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
1.2 创建 XLS 文件

以下是一个简单的示例，展示如何创建一个 XLS 文件并填写数据：

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;

import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelGenerator {
    public static void main(String[] args) {
        HSSFWorkbook workbook = new HSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");

        Row row = sheet.createRow(0);
        Cell cell = row.createCell(0);
        cell.setCellValue("Hello, Excel!");

        try (FileOutputStream fileOut = new FileOutputStream("example.xls")) {
            workbook.write(fileOut);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.

在上述代码中，我们使用 HSSFWorkbook 创建了一个工作簿，并添加了一个简单的表格。

2. 通过 Servlet 下载 XLS 文件

接下来，我们将创建一个 Servlet，当用户访问特定 URL 时，它会返回创建的 XLS 文件。

2.1 创建 DownloadServlet

下面是一个简单的 Servlet 示例，它会通过 HTTP 响应将 XLS 文件发送到客户端：

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/downloadExcel")
public class DownloadServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        HSSFWorkbook workbook = new HSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");
        
        Row row = sheet.createRow(0);
        Cell cell = row.createCell(0);
        cell.setCellValue("Hello, Excel!");

        response.setContentType("application/vnd.ms-excel");
        response.setHeader("Content-Disposition", "attachment; filename=example.xls");

        try {
            workbook.write(response.getOutputStream());
            response.flushBuffer();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            workbook.close();
        }
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
2.2 说明

在上述代码中，我们设置了响应的 Content-Type 为 application/vnd.ms-excel，然后通过 setHeader 方法设置文件下载的文件名。当用户访问 /downloadExcel URL 时，Servlet 将创建并下载一个 XLS 文件。

3. 测试下载功能

将代码集成到你的 Java Web 应用程序后，我们需要启动服务器并访问相应的 URL，例如 http://localhost:8080/yourapp/downloadExcel。如果一切正常，浏览器将会触发文件下载。

结论

在本文中，我们探讨了如何使用 Java 和 Apache POI 库创建和下载 XLS 文件。从创建简单的 Excel 文件，到通过 Servlet 发送文件，整个过程相对简单且易于实现。掌握这些技能后，您可以根据需要灵活地生成和处理各种 Excel 文件，以满足不同的商业需求。希望本篇文章能对您在 Java 开发中处理 XLS 文件有所帮助！