关于POI包处理excel方法详解（一）

原创最新推荐文章于 2026-04-24 23:25:45 发布 3.8k 阅读 AI写同款

收录于

java技能提升

面试系列

境里婆娑

码龄10年墨衍会员 · AI 创作全网分发

1万+粉丝300篇原创

关注

四、java基于poi源码操作excel之XSSFCell源码类 XSSFCell源码类 pom配置  <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>4.1.2</version> </depend 阅读详情

AI摘要

本文介绍了ApachePOI库及其子项目HSSF、XSSF、HWPF、XWPF和HSLF在处理不同版本Office文档中的作用，重点讲解了XSSFWorkbook、XSSFSheet、XSSFRow和XSSFCell的详细用法，展示了如何使用这些工具进行数据读写和格式操作。

POI (Poor Obfuscation Implementation) 是一个 Java 库，用于处理 Microsoft Office文档，如Excel、Word和PowerPoint。它提供了一组类和方法，使开发人员能够读取、创建和修改这些文档，以及从中提取数据。

一、POI 组件介绍

POI 主要包括以下几个组件：

HSSF（Horrible Spreadsheet Format）：HSSF 是 POI 的子项目，用于处理 Excel 97-2003 格式（.xls 文件）。它允许您读取、创建和修改 Excel 文档，包括工作簿、工作表、单元格、公式等。
XSSF（XML Spreadsheet Format）：XSSF 是 POI 的子项目，用于处理 Excel 2007及更高版本的 XLSX 格式（基于XML的文件格式）。它支持读取和写入 XLSX 文件，并提供了对新 Excel 特性的支持。
HWPF（Horrible Word Processor Format）：HWPF 是 POI 的子项目，用于处理 Word 97-2003 格式的文档（.doc 文件）。它允许您读取、创建和修改 Word 文档，包括文本、表格、图像等。
XWPF（XML Word Processor Format）：XWPF 是 POI 的子项目，用于处理 Word 2007 及更高版本的 DOCX 格式（基于XML的文件格式）。它支持读取和写入 DOCX 文件，包括文本、样式、表格等。
HSLF（Horrible Slide Layout Format）：HSLF 是 POI 的子项目，用于处理 PowerPoint 97-2003 格式的演示文稿（.ppt 文件）。它允许您读取、创建和修改 PowerPoint 文档，包括幻灯片、文本、图形等。
XSLF（XML Slide Layout Format）：XSLF 是 POI 的子项目，用于处理 PowerPoint 2007 及更高版本的 PPTX 格式（基于XML的文件格式）。它支持读取和写入 PPTX 文件，包括幻灯片、文本、图形等。

使用 POI，您可以执行各种操作，如读取 Excel 文件中的数据、将数据写入 Excel 文件、操作 Word 文档的内容和格式、创建 PowerPoint 演示文稿等。它是一个强大的工具，特别适合需要自动化处理 Office 文档的 Java 应用程序。

使用 POI 的简单示例，用于读取 Excel 文件中的数据：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

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

public class ExcelReader {
    public static void main(String[] args) {
        try {
            FileInputStream file = new FileInputStream(new File("example.xlsx"));
            Workbook workbook = new XSSFWorkbook(file);
            Sheet sheet = workbook.getSheetAt(0);

            for (Row row : sheet) {
                for (Cell cell : row) {
                    System.out.print(cell.toString() + "\t");
                }
                System.out.println();
            }

            file.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

二、XSSFWorkbook 详解

XSSFWorkbook 是 Apache POI 库中用于操作 Excel 2007及更高版本（.xlsx 格式）文档的类。它是 org.apache.poi.xssf.usermodel.XSSFWorkbook 类的一个实现。XSSFWorkbook 提供了许多方法，用于创建、修改和操作 Excel 工作簿，包括工作表、单元格、样式等。以下是一些常用的 XSSFWorkbook 方法的详解：

构造函数：

XSSFWorkbook()：创建一个新的空白工作簿。
XSSFWorkbook(InputStream is)：从输入流加载现有的工作簿。
XSSFWorkbook(String path)：从指定文件路径加载现有的工作簿。
XSSFWorkbook(OPCPackage pkg)：使用 OPCPackage 对象创建工作簿，这通常用于高级用途。

创建工作表：

XSSFSheet createSheet(String sheetName)：创建一个新的工作表，并指定工作表的名称。
XSSFSheet getSheetAt(int index)：通过索引获取工作表。
XSSFSheet getSheet(String name)：通过名称获取工作表。

工作表操作：

int getNumberOfSheets()：获取工作簿中的工作表数量。
void removeSheetAt(int index)：删除指定索引处的工作表。
XSSFSheet cloneSheet(int sheetIndex)：克隆工作表。

保存工作簿：

void write(OutputStream out)：将工作簿内容写入输出流，通常用于将工作簿保存到文件。
void write(File file)：将工作簿内容写入指定的文件。
void close()：关闭工作簿，释放资源。

样式和格式：

XSSFCellStyle createCellStyle()：创建一个新的单元格样式。
XSSFFont createFont()：创建一个新的字体对象。
short createDataFormat()：创建一个新的数据格式。

日期处理：

void setCreationHelper(CreationHelper createHelper)：设置工作簿的 CreationHelper，用于日期处理和其他数据类型的转换。

密码保护：

void lockStructure()：锁定工作簿的结构，防止用户对工作表的结构进行更改。
void unlockStructure()：解锁工作簿的结构，允许用户对工作表的结构进行更改。

其他：

int getActiveSheetIndex()：获取当前活动工作表的索引。
void setActiveSheet(int sheetIndex)：设置当前活动工作表的索引。
XSSFFormulaEvaluator getCreationHelper().createFormulaEvaluator()：用于计算公式的创建和计算器。

三、XSSFSheet详解

XSSFSheet 是 Apache POI 中用于表示 Excel 工作表的类，通常用于对 Excel 表格的数据进行读取和修改。XSSFSheet 类是 org.apache.poi.xssf.usermodel.XSSFSheet 的实现。以下是一些常用的 XSSFSheet 类的方法和属性：

属性和基本信息：

int getPhysicalNumberOfRows(): 获取工作表中的物理行数，即非空行的数量。
int getFirstRowNum(): 获取第一个行的索引，通常为0。
int getLastRowNum(): 获取最后一个行的索引。
String getSheetName(): 获取工作表的名称。

行操作：

XSSFRow createRow(int rowIndex): 创建一个新的行，指定行的索引。
XSSFRow getRow(int rowIndex): 获取工作表中指定行索引的行对象。
void removeRow(XSSFRow row): 从工作表中删除指定的行。
void shiftRows(int startRow, int endRow, int n)：向下或向上移动工作表中的行。

列操作：

int getColumnWidth(int columnIndex): 获取指定列的宽度。
void setColumnWidth(int columnIndex, int width): 设置指定列的宽度。

工作表的属性：

boolean getDisplayFormulas(): 获取是否显示公式。
void setDisplayFormulas(boolean show)：设置是否显示公式。

合并单元格：

void addMergedRegion(CellRangeAddress region): 合并单元格区域。
void addMergedRegionUnsafe(CellRangeAddress region): 合并单元格区域（不检查冲突）。
void removeMergedRegion(int index): 移除合并单元格区域。

保护工作表：

void protectSheet(String password): 保护工作表并设置密码。
void unprotectSheet(String password): 取消保护工作表，需要提供正确的密码。

页眉和页脚：

Header getHeader(): 获取工作表的页眉。
Footer getFooter(): 获取工作表的页脚。

注释：

XSSFRichTextString getSheetComment(): 获取工作表的注释。
void setSheetComment(XSSFRichTextString comment): 设置工作表的注释。

图表：

XSSFDrawing createDrawingPatriarch(): 创建绘图对象，用于插入图表和图形。

数据有效性：

XSSFDataValidationHelper getDataValidationHelper(): 获取数据有效性帮助器，用于创建数据有效性约束。

打印设置：

void setPrintArea(int startColumn, int endColumn, int startRow, int endRow): 设置要打印的区域。

其它方法：

boolean isSelected(): 检查工作表是否被选中。
void setSelected(boolean select): 设置工作表是否被选中。

四、XSSFRow详解

XSSFRow 是 Apache POI 中用于表示 Excel 工作表中的行的类，通常用于对 Excel 表格的数据进行读取和修改。XSSFRow 类是 org.apache.poi.xssf.usermodel.XSSFRow 的实现。下面是一些常用的 XSSFRow 类的方法和属性：

属性和基本信息：

int getRowNum(): 获取行的索引，从0开始。
int getPhysicalNumberOfCells(): 获取该行的物理单元格数量，即非空单元格的数量。

单元格操作：

XSSFCell createCell(int columnIndex): 创建一个新的单元格，指定单元格在行中的列索引。
XSSFCell getCell(int columnIndex): 获取行中指定列索引的单元格。
void removeCell(XSSFCell cell): 从行中删除指定的单元格。
int getFirstCellNum(): 获取第一个单元格的列索引。
int getLastCellNum(): 获取最后一个单元格的列索引，包括空单元格。

设置行高和默认列宽：

void setHeight(short height): 设置行的高度（以20分之1个点为单位）。
void setZeroHeight(boolean zHeight): 设置行是否为零高度（隐藏行）。

其它方法：

void shiftCellsRight(int firstCellNum, int lastCellNum, int step): 将行中指定范围内的单元格向右移动。
void shiftCellsLeft(int firstCellNum, int lastCellNum, int step): 将行中指定范围内的单元格向左移动。
void shiftCellsRight(int firstCellNum, int lastCellNum): 将行中指定范围内的单元格向右移动一个位置。
void shiftCellsLeft(int firstCellNum, int lastCellNum): 将行中指定范围内的单元格向左移动一个位置。

五、XSSFCell 详解

XSSFCell 是 Apache POI 中用于表示 Excel 工作表中单元格的类，通常用于读取和修改 Excel 表格中的数据。XSSFCell 类是 org.apache.poi.xssf.usermodel.XSSFCell 的实现。以下是一些常用的 XSSFCell 类的方法和属性：

获取单元格的内容：