Apache POI
- User
Apache POI
Assistant
Apache POI 是一个非常流行的 Java 库,用于读写 Microsoft Office 格式的文件,如 Excel(.xls 和 .xlsx)、Word(.doc 和 .docx)和 PowerPoint(.ppt 和 .pptx)。它提供了对这些二进制和 OOXML 格式的低级访问,使开发者可以在 Java 程序中创建、修改和显示 Office 文档。
🧰 Apache POI 主要组件
组件 用途 POIFS 处理 OLE2 文件(如 .xls,.doc,.ppt)的底层 APIHSSF Excel 2003 及以前版本( .xls)的读写支持XSSF Excel 2007+( .xlsx)的读写支持HWPF Word 2003( .doc)的读写支持XWPF Word 2007+( .docx)的读写支持HSLF PowerPoint 2003( .ppt)的读写支持XSLF PowerPoint 2007+( .pptx)的读写支持HDGF Visio 二进制格式( .vsd)的读取支持HPBF Publisher 文件的支持 EMF 增强型图元文件(Enhanced Metafile)处理
📊 Apache POI 示例:Excel 操作
✅ 创建一个简单的 Excel 文件(XSSF - .xlsx)
import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.apache.poi.ss.usermodel.*; import java.io.FileOutputStream; import java.io.IOException; public class ExcelDemo { public static void main(String[] args) throws IOException { Workbook workbook = new XSSFWorkbook(); Sheet sheet = workbook.createSheet("员工表"); Row headerRow = sheet.createRow(0); String[] headers = {"ID", "姓名", "年龄", "部门"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); } Row dataRow = sheet.createRow(1); dataRow.createCell(0).setCellValue(1); dataRow.createCell(1).setCellValue("张三"); dataRow.createCell(2).setCellValue(30); dataRow.createCell(3).setCellValue("技术部"); try (FileOutputStream fos = new FileOutputStream("员工信息.xlsx")) { workbook.write(fos); } System.out.println("Excel 文件已生成!"); } }
🔍 读取 Excel 文件内容(兼容 HSSF / XSSF)
import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import java.io.FileInputStream; import java.io.IOException; public class ReadExcel { public static void main(String[] args) throws IOException { String filePath = "员工信息.xlsx"; FileInputStream fis = new FileInputStream(filePath); Workbook workbook = new XSSFWorkbook(fis); // 如果是.xls 使用 HSSFWorkbook Sheet sheet = workbook.getSheetAt(0); for (Row row : sheet) { for (Cell cell : row) { switch (cell.getCellType()) { case STRING: System.out.print(cell.getStringCellValue() + "\t"); break; case NUMERIC: System.out.print(cell.getNumericCellValue() + "\t"); break; default: System.out.print("未知类型\t"); } } System.out.println(); } workbook.close(); fis.close(); } }
🚀 Maven 依赖(以 Excel 为例)
如果你使用的是
.xlsx文件:<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.3</version> <!-- 注意保持最新 --> </dependency>如果是
.xls文件:<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.3</version> </dependency>
📌 小贴士
- 内存问题:使用
XSSF时如果数据量大,建议使用SXSSF来减少内存占用。 - 兼容性:
.xls:使用HSSF.xlsx:使用XSSF
- 文档结构复杂:可以使用
POIXMLDocumentPart、CT...等类来操作更复杂的结构。 - 样式与公式:POI 支持设置字体、颜色、边框、公式等高级功能。
📚 官方资源
如果你有具体的需求(比如导出带样式的 Excel、读取 Word 表格内容、操作 PPT 图表等),欢迎告诉我,我可以提供更详细的示例代码。
- 内存问题:使用
- User
алгоритма работы библиотеки Apache POI
Assistant
Apache POI — это Java-библиотека, которая позволяет читать и записывать файлы Microsoft Office (например, Excel, Word, PowerPoint) в программе на Java. Чтобы понять алгоритм работы Apache POI, важно разобраться, как он взаимодействует с форматами Office-файлов на низком уровне.
🧠 Общая идея
Apache POI работает напрямую с внутренними структурами файлов Microsoft Office:
- Для старых форматов (
.xls,.doc,.ppt) используется OLE2 (также называется OLE Compound Document Format). - Для новых форматов (
.xlsx,.docx,.pptx) используются XML + ZIP-архивы (OOXML).
🔍 Алгоритм работы Apache POI
1. Определение формата файла
POI определяет тип файла по расширению или сигнатуре:
.xls→ HSSF.xlsx→ XSSF.doc→ HWPF.docx→ XWPF- и т.д.
Например: при открытии файла
workbook = new XSSFWorkbook(inputStream)— мы явно указываем, что это.xlsx.
2. Чтение/запись внутренней структуры
✅ Для
.xls(HSSF):- Формат OLE2 — это своего рода "файловая система внутри файла".
- POI использует POIFSFileSystem для чтения/записи OLE2-файлов.
- Внутри файла есть потоки данных (например,
Workbook,Sheet1,BoundSheet, и т.д.) - POI анализирует эти потоки и строит объектную модель (DOM-like), которую можно использовать в Java.
✅ Для
.xlsx(XSSF):- Это ZIP-архив, содержащий XML-файлы.
- POI использует OPCPackage из пакета
org.apache.poi.openxml4jдля работы с OOXML. - При чтении
.xlsxфайл распаковывается, и POI парсит XML-файлы, такие как:/xl/workbook.xml/xl/worksheets/sheet1.xml/xl/styles.xml
- При записи POI создает аналогичные XML-файлы и упаковывает их обратно в ZIP с нужным контент-типом (
[Content_Types].xml,_rels/.relsи т.д.).
3. Создание объектной модели (API)
POI предоставляет унифицированный интерфейс для работы с документами через интерфейсы:
WorkbookSheetRowCellCellStyle,Font,DataFormatи др.
Например:
Workbook workbook = WorkbookFactory.create(file); // автоматически выбирает HSSF/XSSFРеализации:
HSSFWorkbook(для.xls)XSSFWorkbook(для.xlsx)
4. Обработка содержимого
POI умеет:
- Читать/писать текстовые и числовые значения
- Работать со стилями ячеек, шрифтами, цветами
- Парсить формулы (в т.ч. с вычислением)
- Поддерживать макросы, диаграммы, графики (ограниченно)
Для сложных задач может потребоваться работа с внутренними классами:
CT...(из библиотекиooxml-schemas)XSSFSheet,XSSFRow,XSSFCellи т.д.
5. Запись изменений
После изменения документа:
- Для
.xls: POI перезаписывает потоки в OLE2-файл. - Для
.xlsx: POI генерирует новые XML-файлы, упаковывает их в ZIP и сохраняет как.xlsx.
Пример:
workbook.write(outputStream);
📦 Основные этапы работы Apache POI (пошагово):
Этап Что происходит 1. Загрузка файла POI определяет формат (HSSF/XSSF и т.д.) 2. Чтение структуры Используются POIFS (для .xls) или OPC (для .xlsx) 3. Парсинг данных Содержимое файла преобразуется в Java-объекты 4. Работа с API Программист использует методы POI для чтения/изменения данных 5. Сохранение POI сериализует объектную модель обратно в файл
🚀 Особенности реализации
⚙️ HSSF (для .xls)
- Полный доступ к бинарным данным
- Меньше памяти, но ограничения по количеству строк (65536)
- Не рекомендуется для новых проектов
⚙️ XSSF (для .xlsx)
- Полная поддержка новых функций Excel
- Больше возможностей, но больше расход памяти
- Для обработки больших файлов можно использовать
SXSSF(версию XSSF с временным хранением данных)
🧪 Пример: Как POI обрабатывает лист Excel
Файл
sheet1.xmlвнутри.xlsxможет содержать:<sheetData> <row r="1"> <c r="A1" t="s"><v>0</v></c> <c r="B1"><v>25</v></c> </row> </sheetData>POI:
- Парсит этот XML.
- Находит значение
"0"в sharedStrings.xml — это строка"Hello". - Создаёт
RowиCellв Java-объекте. - Вызов
cell.getStringCellValue()вернёт"Hello".
📚 Полезные ссылки
❓Есть ли вопросы?
Хочешь узнать:
- Как POI обрабатывает формулы?
- Как работает SXSSF?
- Как POI работает с Word или PowerPoint?
- Какие есть ограничения?
👉 Напиши, и я подробно объясню!
- Для старых форматов (
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.