poi

Apache POI™

Eine Java-Bibliothek zum Lesen und Schreiben von Microsoft Office-Binär- und OOXML-Dateiformaten.

Die Mission des Apache POI-Projekts besteht darin, Java-APIs für die Bearbeitung verschiedener Dateiformate basierend auf den Office Open XML-Standards (OOXML) und dem OLE 2 Compound Document-Format (OLE2) von Microsoft zu erstellen und zu verwalten. Kurz gesagt, Sie können MS Excel-Dateien mit Java lesen und schreiben. Darüber hinaus können Sie MS Word- und MS PowerPoint-Dateien mit Java lesen und schreiben. Apache POI ist Ihre Java Excel-Lösung (für Excel 97-2008). Wir verfügen über eine vollständige API für die Portierung anderer OOXML- und OLE2-Formate und heißen andere zur Teilnahme willkommen.

Zu den OLE2-Dateien gehören die meisten Microsoft Office-Dateien wie XLS, DOC und PPT sowie auf der MFC-Serialisierungs-API basierende Dateiformate. Das Projekt stellt APIs für das OLE2-Dateisystem (POIFS) und die OLE2-Dokumenteigenschaften (HPSF) bereit.

Das Office OpenXML-Format ist das neue standardbasierte XML-Dateiformat in Microsoft Office 2007 und 2008. Dazu gehören XLSX, DOCX und PPTX. Das Projekt stellt eine Low-Level-API zur Unterstützung der Open Packaging Conventions mithilfe von openxml4j bereit.

Für jede MS Office-Anwendung gibt es ein Komponentenmodul, das versucht, eine gemeinsame High-Level-Java-API für die Dokumentformate OLE2 und OOXML bereitzustellen. Dies ist am meisten für Excel-Arbeitsmappen entwickelt (SS=HSSF+XSSF). Die Arbeiten an Word-Dokumenten (WP=HWPF+XWPF) und PowerPoint-Präsentationen (SL=HSLF+XSLF) schreiten voran.

Das Projekt unterstützt Outlook (HSMF). Microsoft hat die Spezifikationen für dieses Format im Oktober 2007 veröffentlicht. Wir würden uns über Beiträge freuen.

Es gibt auch Projekte für Visio (HDGF und XDGF), TNEF (HMEF) und Publisher (HPBF).

Diese Bibliothek umfasst die folgenden Komponenten, ungefähr in absteigender Reihenfolge ihrer Reife:

• Excel-Tabellen (Common SS = HSSF, XSSF und SXSSF)
• PowerPoint-Diashows (Common SL = HSLF und XSLF)
• Textverarbeitungsdokumente (Gemeinsames WP = HWPF und XWPF)
• Outlook-E-Mail (HSMF und HMEF)
• Visio-Diagramme (HDGF und XDGF)
• Herausgeber (HPBF)

Und untergeordnete, unterstützende Komponenten:

• OLE2-Dateisystem (POIFS)
• OLE2-Dokumenteigenschaften (HPSF)
• TNEF (HMEF) für Outlook winmail.dat-Dateien
• OpenXML4J (OOXML)

Komponenten mit der Bezeichnung H??F dienen zum Lesen oder Schreiben von OLE2-Binärformaten.

Komponenten mit dem Namen X??F dienen zum Lesen oder Schreiben von OpenOffice XML-Formaten (OOXML).

Erste Schritte

Website: https://poi.apache.org/

Mailinglisten:

• Entwickler
• Benutzer
• Allgemein (Release-Ankündigungen)

Bug-Tracker:

• Bugzilla
• GitHub-Pull-Anfragen

Quellcode:

• Offizielles Apache Subversion-Repo auf apache.org
• ViewVC-Repo-Browser unter apache.org
• GitHub Git Mirror auf github.com

Erfordert Java 1.8 oder höher.

Mitwirken

• Laden Sie SVN oder Git, Java JDK 1.8+ und Apache Ant 1.8+ oder Gradle herunter und installieren Sie es
• Schauen Sie sich den Code von svn oder git an
• Importieren Sie das Projekt in Eclipse oder Ihre bevorzugte IDE
• Schreiben Sie einen Unit-Test:
  • Binärformate und allgemeine APIs: poi/src/test/java/org/apache/poi/
  • Nur OOXML-APIs: poi-ooxml/src/test/java/org/apache/poi/
  • Scratchpad (Binärformate): poi-scratchpad/src/test/java/org/apache/poi/
  • Testdateien: test-data/
• Navigieren Sie durch die Quelle, nehmen Sie Änderungen vor und führen Sie zur Überprüfung Komponententests durch
  • Binärformate und allgemeine APIs: poi/src/main/java/org/apache/poi/
  • Nur OOXML-APIs: poi-ooxml/src/main/java/org/apache/poi/
  • Scratchpad (Binärformate): poi-scratchpad/src/main/java/org/apache/poi/
  • Beispiele: poi-examples/src/main/java/org/apache/poi/
• Weitere Informationen: Seite „How To Build“ auf apache.org

JAR-Dateien erstellen

So erstellen Sie die JAR-Dateien für poi, poi-ooxml, poi-ooxml-lite, poi-ooxml-full und poi-examples:

 ./gradlew jar

Gradlew-Glas