spring boot xls打不开

原创

mob649e815c3b9e 2024-08-07 07:50:09 ©著作权

文章标签 apache java Apache 文章分类 spring boot 后端开发

©著作权归作者所有：来自51CTO博客作者mob649e815c3b9e的原创作品，请联系作者获取转载授权，否则将追究法律责任

Spring Boot XLS 文件打不开问题及解决方案

在使用 Spring Boot 开发项目时，经常需要处理 Excel 文件（如 XLS、XLSX 格式）。然而，开发者在生成或读取 XLS 文件后，可能会遇到打不开文件的情况。本文将深入探讨这个问题的根源，并提供解决方案，以及相关的代码示例。

XLS 文件打不开的原因

文件格式不匹配：如果生成的文件格式不符合 Excel 的标准，Excel 不会识别文件。
字符编码问题：生成的 Excel 文件可能包含了不支持的字符编码，从而导致打不开。
库的使用不当：使用的 Excel 操作库可能存在 Bugs，或者使用不当导致文件生成错误。
写入流未关闭：在生成文件时未正确关闭输出流，可能导致文件损坏。

解决方案

使用 Apache POI 进行 XLS 操作

在 Spring Boot 项目中，可以使用 Apache POI 库来处理 Excel 文件。确保在 pom.xml 中添加相关依赖：

<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>

然后，使用以下代码生成一个简单的 XLS 文件：

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

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

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

        // 创建表格头
        Row header = sheet.createRow(0);
        header.createCell(0).setCellValue("Name");
        header.createCell(1).setCellValue("Age");

        // 填写数据
        Row row = sheet.createRow(1);
        row.createCell(0).setCellValue("John Doe");
        row.createCell(1).setCellValue(30);

        // 写入文件
        try (FileOutputStream fileOut = new FileOutputStream("workbook.xls")) {
            workbook.write(fileOut);
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                workbook.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

代码解析

使用 HSSFWorkbook 创建一个新的工作簿。
使用 createSheet 方法创建一个新表。
用 createRow 和 createCell 方法填充数据。
使用 FileOutputStream 将文件写入磁盘，确保流被关闭，以避免文件损坏。

读取 XLS 文件

如果要读取 XLS 文件，可以使用以下代码示例：

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

import java.io.FileInputStream;
import java.io.IOException;

public class ExcelReader {
    public static void main(String[] args) {
        try (FileInputStream fileInputStream = new FileInputStream("workbook.xls");
             Workbook workbook = new HSSFWorkbook(fileInputStream)) {

            Sheet sheet = workbook.getSheetAt(0);
            for (Row row : sheet) {
                System.out.println("Name: " + row.getCell(0).getStringCellValue() +
                                   ", Age: " + row.getCell(1).getNumericCellValue());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

代码解析

使用 FileInputStream 打开 XLS 文件。
使用 HSSFWorkbook 读取文件内容。
遍历表中的每一行并输出信息。

旅行图示例

通过以下的旅行图，您可以了解使用 Apache POI 库处理 XLS 文件的过程：

journey
    title 处理 XLS 文件的旅程
    section 创建 XLS 文件
      创建工作簿       : 5: 工作簿创建中...
      创建表           : 3: 表创建中...
      填写数据         : 4: 数据准备中...
      写入文件         : 5: 文件写入中...
      关闭流           : 5: 流关闭成功
    section 读取 XLS 文件
      打开文件         : 5: 文件打开成功
      读取内容         : 4: 内容读取中...
      输出结果         : 5: 输出成功