|Developer(s)||Apache Software Foundation|
|Stable release||3.12 / May 11, 2015|
|Preview release||3.13 Beta 1 / July 22, 2015|
|Type||API to access Microsoft Office formats|
|License||Apache License 2.0|
Apache POI, a project run by the Apache Software Foundation, and previously a sub-project of the Jakarta Project, provides pure Java libraries for reading and writing files in Microsoft Office formats, such as Word, PowerPoint and Excel.
History and roadmap
The name was originally an acronym for "Poor Obfuscation Implementation", referring humorously to the fact that the file formats seemed to be deliberately obfuscated, but poorly, since they were successfully reverse-engineered. This explanation – and those of the similar names for the various sub-projects – were removed from the official web pages in order to better market the tools to businesses who would not consider such humor appropriate. The original authors (Andrew C. Oliver and Marc Johnson) also noted the existence of the Hawaiian poi dish, made of mashed taro root, which had similarly derogatory connotations.
Office Open XML support
POI supports the ISO/IEC 29500:2008 Office Open XML file formats since version 3.5. A significant contribution for OOXML support came from Sourcesense, an open source company which was commissioned by Microsoft to develop this contribution. This link spurred controversy, some POI contributors questioning POI OOXML patent protection regarding Microsoft's Open Specification Promise patent license.
The Apache POI project contains the following subcomponents (meaning of acronyms is taken from old documentation):
- POIFS (Poor Obfuscation Implementation File System) – This component reads and writes Microsoft's OLE 2 Compound document format. Since all Microsoft Office files are OLE 2 files, this component is the basic building block of all the other POI elements. POIFS can therefore be used to read a wider variety of files, beyond those whose explicit decoders are already written in POI.
- HSSF (Horrible SpreadSheet Format) – reads and writes Microsoft Excel (XLS) format files. It can read files written by Excel 97 onwards; this file format is known as the BIFF 8 format. As the Excel file format is complex and contains a number of tricky characteristics, some of the more advanced features cannot be read.
- XSSF (XML SpreadSheet Format) – reads and writes Office Open XML (XLSX) format files. Similar feature set to HSSF, but for Office Open XML files.
- HPSF (Horrible Property Set Format) – reads "Document Summary" information from Microsoft Office files. This is essentially the information that one can see by using the File|Properties menu item within an Office application.
- HWPF (Horrible Word Processor Format) – aims to read and write Microsoft Word 97 (DOC) format files. This component is in initial stages of development.
- HSLF (Horrible Slide Layout Format) – a pure Java implementation for Microsoft PowerPoint files. This provides the ability to read, create and edit presentations (though some things are easier to do than others)
- HDGF (Horrible DiaGram Format) – an initial pure Java implementation for Microsoft Visio binary files. It provides an ability to read the low level contents of the files.
- HPBF (Horrible PuBlisher Format) – a pure Java implementation for Microsoft Publisher files.
- HSMF (Horrible Stupid Mail Format[better source needed]) – a pure Java implementation for Microsoft Outlook MSG files.
- DDF (Dreadful Drawing Format) – a package for decoding the Microsoft Office Drawing format.
|Legend:||Old version||Older version, still supported||Current version||Latest preview version||Future release|
|Date of release|
|Future release: 3.13|
|Current stable version: 3.12||11. May 2015|
|Older version, yet still supported: 3.11||21. December 2014|
|Older version, yet still supported: 3.10.1||18. August 2014|
|Old version, no longer supported: 3.10||8. February 2014|
|Old version, no longer supported: 3.9||3. December 2012|
|Old version, no longer supported: 3.8||26. March 2012|
|Old version, no longer supported: 3.7||29. October 2010|
|Old version, no longer supported: 3.6||14. December 2009|
|Old version, no longer supported: 3.5||28. September 2009|
|Old version, no longer supported: 3.2||19. October 2008|
|Old version, no longer supported: 3.1||29. June 2008|
|Old version, no longer supported: 3.0.2||4. February 2008|
|Old version, no longer supported: 3.0.1||5. July 2007|
|Old version, no longer supported: 3.0||18. May 2007|
|Old version, no longer supported: 2.5.1||29. February 2004|
|Old version, no longer supported: 2.5||29. February 2004|
|Old version, no longer supported: 2.0||26. January 2004|
|Old version, no longer supported: 1.5.1||16. June 2002|
|Old version, no longer supported: 1.5||6. May 2002|
|Old version, no longer supported: 1.2.0||19. January 2002|
|Old version, no longer supported: 1.1.0||4. January 2002|
|Old version, no longer supported: 1.0.2||11. January 2002|
|Old version, no longer supported: 1.0.1||4. January 2002|
|Old version, no longer supported: 1.0.0||30. December 2001|
- "Apache POI 3.12 released". 2015-05-11. Retrieved 2015-06-29.
- Sundaram, Elango (2004-03-22), Excelling in Excel with Java, Java World
- POI homepage from October 2004, Coyote Song, archived from the original on 2004-10-15, showing original explanations for naming.
- "Microsoft Eyes Open Source Components for Office 2007". Information Week. 26 March 2008. Retrieved 1 March 2009.
- POI development mailing list archives, March 2008
- Codeplex NPOI, Microsoft
- POI-HSMF, Apache
- POI-HSSF, Apache
- POI-HWPF, Apache
- POI-HSLF, Apache
- POI-Ruby, Apache