poi

阿帕奇 POI™

用于读写 Microsoft Office 二进制和 OOXML 文件格式的 Java 库。

Apache POI 项目的使命是创建和维护 Java API，用于基于 Office Open XML 标准 (OOXML) 和 Microsoft 的 OLE 2 复合文档格式 (OLE2) 操作各种文件格式。简而言之，您可以使用 Java 读取和写入 MS Excel 文件。此外，您还可以使用 Java 读写 MS Word 和 MS PowerPoint 文件。 Apache POI 是您的 Java Excel 解决方案（适用于 Excel 97-2008）。我们有完整的 API 用于移植其他 OOXML 和 OLE2 格式，并欢迎其他人参与。

OLE2 文件包括大多数 Microsoft Office 文件，例如 XLS、DOC 和 PPT 以及基于 MFC 序列化 API 的文件格式。该项目为 OLE2 文件系统 (POIFS) 和 OLE2 文档属性 (HPSF) 提供 API。

Office OpenXML 格式是 Microsoft Office 2007 和 2008 中基于新标准的 XML 文件格式。其中包括 XLSX、DOCX 和 PPTX。该项目提供了一个低级 API 来支持使用 openxml4j 的开放打包约定。

对于每个 MS Office 应用程序，都存在一个组件模块，该模块尝试为 OLE2 和 OOXML 文档格式提供通用的高级 Java API。这是为 Excel 工作簿开发的最多 (SS=HSSF+XSSF)。 Word 文档 (WP=HWPF+XWPF) 和 PowerPoint 演示文稿 (SL=HSLF+XSLF) 的工作正在进行中。

该项目对 Outlook (HSMF) 有一些支持。 Microsoft 于 2007 年 10 月开放了此格式的规范。我们欢迎您做出贡献。

还有针对 Visio（HDGF 和 XDGF）、TNEF（HMEF）和 Publisher（HPBF）的项目。

该库包括以下组件，大致按成熟度降序排列：

• Excel 电子表格（常见 SS = HSSF、XSSF 和 SXSSF）
• PowerPoint 幻灯片（常见 SL = HSLF 和 XSLF）
• 文字处理文档（常见 WP = HWPF 和 XWPF）
• Outlook 电子邮件（HSMF 和 HMEF）
• Visio 图表（HDGF 和 XDGF）
• 出版商 (HPBF)

以及较低级别的支持组件：

• OLE2 文件系统 (POIFS)
• OLE2 文档属性 (HPSF)
• Outlook winmail.dat 文件的 TNEF (HMEF)
• OpenXML4J (OOXML)

名为 H??F 的组件用于读取或写入 OLE2 二进制格式。

名为 X??F 的组件用于读取或写入 OpenOffice XML (OOXML) 格式。

入门

网站：https://poi.apache.org/

邮件列表：

• 开发商
• 用户
• 一般（发布公告）

错误跟踪器：

• 布吉拉
• GitHub 拉取请求

源代码：

• apache.org 上的官方 Apache Subversion 存储库
• apache.org 上的 ViewVC 存储库浏览器
• GitHub git 镜像位于 github.com

需要 Java 1.8 或更高版本。

贡献

• 下载并安装 svn 或 git、Java JDK 1.8+ 和 Apache Ant 1.8+ 或 Gradle
• 从 svn 或 git 查看代码
• 将项目导入 Eclipse 或您喜欢的 IDE
• 编写单元测试：
  • 二进制格式和通用 API：poi/src/test/java/org/apache/poi/
  • 仅限 OOXML API：poi-ooxml/src/test/java/org/apache/poi/
  • Scratchpad（二进制格式）：poi-scratchpad/src/test/java/org/apache/poi/
  • 测试文件：测试数据/
• 导航源、进行更改并运行单元测试来验证
  • 二进制格式和通用 API：poi/src/main/java/org/apache/poi/
  • 仅限 OOXML API：poi-ooxml/src/main/java/org/apache/poi/
  • Scratchpad（二进制格式）：poi-scratchpad/src/main/java/org/apache/poi/
  • 示例：poi-examples/src/main/java/org/apache/poi/
• 更多信息：apache.org 上的“如何构建”页面

构建 jar 文件

构建 poi、poi-ooxml、poi-ooxml-lite、poi-ooxml-full 和 poi-examples 的 jar 文件：

 ./gradlew 罐子

格拉德卢罐子