《Java操作Excel实战教程：Apache POI从入门到精通》

Java操作Excel之POI详解

一、Excel操作方式概述

在Java开发中，操作Excel文件主要有两种方式：

Apache POI：Apache基金会的开源项目，用于操作Microsoft Office格式文件，包括Excel。
EasyExcel：阿里巴巴开源的Excel处理框架，是对POI的封装，简化了Excel操作。

本文将重点介绍Apache POI的使用方法，帮助大家快速掌握Java操作Excel的核心技能。

二、Java基础IO流操作Excel的局限性

使用Java基础IO流可以实现文件的复制，但无法直接以字符串形式读取Excel文件中的数据，读取结果会是乱码或无法解析的字符。

java 复制代码

// 错误演示：用字符流读取Excel文件
import java.io.FileReader;
import java.io.BufferedReader;
import java.io.IOException;

public class WrongExcelReaderDemo {
    public static void main(String[] args) {
        // 待读取的Excel文件路径（.xls或.xlsx均可，都会报错/乱码）
        String excelFilePath = "src/test/java/Demo.xlsx";
        
        // 声明字符流对象
        FileReader fileReader = null;
        BufferedReader bufferedReader = null;

        try {
            // 1. 初始化字符流，尝试读取Excel文件
            fileReader = new FileReader(excelFilePath);
            bufferedReader = new BufferedReader(fileReader);

            // 2. 按行读取文件内容
            String line;
            System.out.println("尝试用字符流读取Excel文件内容：");
            while ((line = bufferedReader.readLine()) != null) {
                // 3. 输出读取到的内容（会是乱码或无法解析的字符）
                System.out.println(line);
            }

        } catch (IOException e) {
            // 捕获IO异常（可能直接抛出文件读取失败，或读取过程中报错）
            e.printStackTrace();
        } finally {
            // 4. 手动关闭流（避免资源泄露，即使读取失败也执行）
            try {
                if (bufferedReader != null) {
                    bufferedReader.close();
                }
                if (fileReader != null) {
                    fileReader.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

不能直接使用IO,虽然能用二进制的形式实现文件转移这一类行为.

三、Apache POI入门

3.1 POI简介

Apache POI（Poor Obfuscation Implementation）是Apache基金会的开源项目，提供了Java API来处理Microsoft Office格式的文件，包括Excel、Word、PowerPoint等。

3.2 Excel文件格式

Excel有两种主要文件格式：

.xls：Excel 2003及之前版本的文件格式，最多包含65536行，256列。
.xlsx：Excel 2007及之后版本的文件格式，最多包含1048576行，16384列。

3.3 导入POI依赖

不同版本的Excel文件需要使用不同的POI依赖：

xml 复制代码

<!-- POI依赖（xls格式） -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.4</version>
</dependency>

<!-- POI依赖（xlsx格式） -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.4</version>
</dependency>

四、POI写入Excel文件

下面我们通过一个实例来学习如何使用POI写入Excel文件：

4.1 核心API说明

Workbook ：工作簿接口，代表整个Excel文件
- HSSFWorkbook：对应.xls格式
- XSSFWorkbook：对应.xlsx格式
Sheet：工作表，一个Workbook可以包含多个Sheet
Row：行，一个Sheet可以包含多个Row
Cell：单元格，一个Row可以包含多个Cell

4.2 写入Excel示例

java 复制代码

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileOutputStream;
import java.io.IOException;

// 生成实习记录Excel文件（.xls格式）
public class Test {
    public static void main(String[] args) throws Exception {
        // 1. 创建Workbook（HSSFWorkbook对应.xls，XSSFWorkbook对应.xlsx）
        Workbook workbook = new HSSFWorkbook();
        
        // 2. 创建Sheet，命名为「实习记录」（核心修改点1）
        Sheet sheet = workbook.createSheet("实习记录");
        
        // 3. 创建表头行（第一行，索引0）
        Row headerRow = sheet.createRow(0);
        // 表头单元格：姓名、性别、工作、公司
        headerRow.createCell(0).setCellValue("姓名");
        headerRow.createCell(1).setCellValue("性别");
        headerRow.createCell(2).setCellValue("工作");
        headerRow.createCell(3).setCellValue("公司");
        
        // 4. 创建数据行（第二行，索引1），填充指定数据（核心修改点2）
        Row dataRow = sheet.createRow(1);
        dataRow.createCell(0).setCellValue("小当家");  // 姓名
        dataRow.createCell(1).setCellValue("男");      // 性别
        dataRow.createCell(2).setCellValue("后端开发");// 工作
        dataRow.createCell(3).setCellValue("xxx");     // 公司

        // 5. 自动调整列宽（优化显示效果）
        for (int i = 0; i < 4; i++) {
            sheet.autoSizeColumn(i);
        }
        
        // 6. 写入文件并关闭资源
        try (FileOutputStream fos = new FileOutputStream("D:\\实习记录.xls")) {
            workbook.write(fos);
            System.out.println("实习记录Excel生成成功！路径：D:\\实习记录.xls");
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            workbook.close();
        }
    }
}

4.3 运行结果

运行上述代码后，会在D盘根目录生成一个名为"实习记录.xls"的Excel文件：

这里的报错是日志依赖,无视即可,不影响demo演示

五、POI读取Excel文件

5.1 基本读取示例

java 复制代码

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileInputStream;
import java.io.InputStream;

public class TestRead {
    public static void main(String[] args) throws Exception {
        // 获取文件的数据流（实习记录Excel路径）
        InputStream inputStream = new FileInputStream("D:\\实习记录.xls");
        
        // 创建文件对象（仅支持.xls格式）
        Workbook workbook = new HSSFWorkbook(inputStream);
        
        // 获取Sheet（按索引取第一个Sheet）
        Sheet sheet = workbook.getSheetAt(0);
        
        // ========== 读取小当家的信息 ==========
        // 读取第二行（数据行，索引1）：第一行是表头（索引0）
        Row dataRow = sheet.getRow(1);
        
        // 读取"姓名"列（第二行第一列，索引0）
        Cell nameCell = dataRow.getCell(0);
        String name = nameCell.getStringCellValue();
        
        // 读取"性别"列（第二行第二列，索引1）
        Cell genderCell = dataRow.getCell(1);
        String gender = genderCell.getStringCellValue();
        
        // 读取"工作"列（第二行第三列，索引2）
        Cell jobCell = dataRow.getCell(2);
        String job = jobCell.getStringCellValue();
        
        // 读取"公司"列（第二行第四列，索引3）
        Cell companyCell = dataRow.getCell(3);
        String company = companyCell.getStringCellValue();
        
        // 打印读取结果
        System.out.println("姓名：" + name);
        System.out.println("性别：" + gender);
        System.out.println("工作：" + job);
        System.out.println("公司：" + company);
        
        // 关闭流
        inputStream.close();
    }
}

5.2 运行结果

5.3 处理不同类型的单元格

在实际开发中，Excel单元格可能包含不同类型的数据（字符串、数字、日期等）。如果直接使用getStringCellValue()读取数字类型的单元格，会报错。因此，我们需要根据单元格类型进行不同的处理：

java 复制代码

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileInputStream;
import java.io.InputStream;

public class TestRead {
    public static void main(String[] args) throws Exception {
        // 获取文件的数据流（实习记录Excel路径）
        InputStream inputStream = new FileInputStream("D:\\实习记录.xls");
        
        // 创建文件对象（仅支持.xls格式）
        Workbook workbook = new HSSFWorkbook(inputStream);
        
        // 获取Sheet（按索引取第一个Sheet）
        Sheet sheet = workbook.getSheetAt(0);
        
        // ========== 读取小当家的信息 ==========
        // 读取第二行（数据行，索引1）：第一行是表头（索引0）
        Row dataRow = sheet.getRow(1);
        
        // 读取"姓名"列（第二行第一列，索引0）
        Cell nameCell = dataRow.getCell(0);
        String name = nameCell.getStringCellValue();
        
        // 读取"性别"列（第二行第二列，索引1）
        Cell genderCell = dataRow.getCell(1);
        String gender = genderCell.getStringCellValue();
        
        // 读取"工作"列（第二行第三列，索引2）
        Cell jobCell = dataRow.getCell(2);
        if (jobCell.getCellType() == CellType.STRING) {
            String job = jobCell.getStringCellValue();
        } else if (jobCell.getCellType() == CellType.NUMERIC) {
            double jobNum = jobCell.getNumericCellValue();
            String job = String.valueOf(jobNum);
        }
        
        // 读取"公司"列（第二行第四列，索引3）
        Cell companyCell = dataRow.getCell(3);
        if (companyCell.getCellType() == CellType.STRING) {
            String company = companyCell.getStringCellValue();
        } else if (companyCell.getCellType() == CellType.NUMERIC) {
            double companyNum = companyCell.getNumericCellValue();
            String company = String.valueOf(companyNum);
        }
        
        // 打印读取结果
        System.out.println("姓名：" + name);
        System.out.println("性别：" + gender);
        System.out.println("工作：" + job);
        System.out.println("公司：" + company);
        
        // 关闭流
        inputStream.close();
    }
}

六、总结

通过本文的学习，我们了解了：

Java操作Excel的两种主要方式：POI和EasyExcel
基础IO流操作Excel的局限性
POI的核心API和使用方法
如何使用POI写入Excel文件
如何使用POI读取Excel文件
如何处理不同类型的Excel单元格

POI作为Java操作Excel的经典库，功能强大但使用相对复杂。在实际开发中，如果需要处理大量数据或追求更简洁的代码，可以考虑使用EasyExcel等封装库。

希望本文能帮助大家快速掌握POI的基本使用，为后续的Excel操作开发打下坚实的基础！