poi

Apache POI™

Uma biblioteca Java para leitura e gravação de formatos de arquivo binário e OOXML do Microsoft Office.

A missão do Projeto Apache POI é criar e manter APIs Java para manipular vários formatos de arquivo baseados nos padrões Office Open XML (OOXML) e no formato OLE 2 Compound Document (OLE2) da Microsoft. Resumindo, você pode ler e escrever arquivos MS Excel usando Java. Além disso, você pode ler e escrever arquivos MS Word e MS PowerPoint usando Java. Apache POI é a sua solução Java Excel (para Excel 97-2008). Temos uma API completa para portar outros formatos OOXML e OLE2 e convidamos outras pessoas a participar.

Os arquivos OLE2 incluem a maioria dos arquivos do Microsoft Office, como XLS, DOC e PPT, bem como formatos de arquivo baseados em API de serialização MFC. O projeto fornece APIs para o sistema de arquivos OLE2 (POIFS) e propriedades de documentos OLE2 (HPSF).

O formato Office OpenXML é o novo formato de arquivo XML baseado em padrões encontrado no Microsoft Office 2007 e 2008. Isso inclui XLSX, DOCX e PPTX. O projeto fornece uma API de baixo nível para suportar as convenções de empacotamento aberto usando openxml4j.

Para cada aplicativo MS Office existe um módulo de componente que tenta fornecer uma API Java comum de alto nível para formatos de documentos OLE2 e OOXML. Isso é mais desenvolvido para pastas de trabalho do Excel (SS=HSSF+XSSF). O trabalho está em andamento para documentos Word (WP=HWPF+XWPF) e apresentações PowerPoint (SL=HSLF+XSLF).

O projeto tem algum suporte para Outlook (HSMF). A Microsoft abriu as especificações para este formato em outubro de 2007. Agradecemos contribuições.

Existem também projetos para Visio (HDGF e XDGF), TNEF (HMEF) e Publisher (HPBF).

Esta biblioteca inclui os seguintes componentes, aproximadamente em ordem decrescente de maturidade:

• Planilhas Excel (SS comum = HSSF, XSSF e SXSSF)
• Apresentações de slides do PowerPoint (SL comum = HSLF e XSLF)
• Documentos de processamento de texto (WP comum = HWPF e XWPF)
• E-mail do Outlook (HSMF e HMEF)
• Diagramas do Visio (HDGF e XDGF)
• Editora (HPBF)

E componentes de suporte de nível inferior:

• Sistema de arquivos OLE2 (POIFS)
• Propriedades do documento OLE2 (HPSF)
• TNEF (HMEF) para arquivos winmail.dat do Outlook
• OpenXML4J (OOXML)

Os componentes denominados H??F são para leitura ou gravação de formatos binários OLE2.

Os componentes denominados X??F são para leitura ou gravação de formatos OpenOffice XML (OOXML).

Começando

Site: https://poi.apache.org/

Listas de discussão:

• Desenvolvedores
• Usuários
• Geral (anúncios de lançamento)

Rastreador de bugs:

• Bugzila
• Solicitações pull do GitHub

Código fonte:

• Repositório oficial do Apache Subversion em apache.org
• Navegador de repositório ViewVC em apache.org
• Espelho git do GitHub em github.com

Requer Java 1.8 ou posterior.

Contribuindo

• Baixe e instale svn ou git, Java JDK 1.8+ e Apache Ant 1.8+ ou Gradle
• Confira o código do svn ou git
• Importe o projeto para o Eclipse ou seu IDE favorito
• Escreva um teste de unidade:
  • Formatos binários e APIs comuns: poi/src/test/java/org/apache/poi/
  • Somente APIs OOXML: poi-ooxml/src/test/java/org/apache/poi/
  • Scratchpad (formatos binários): poi-scratchpad/src/test/java/org/apache/poi/
  • Arquivos de teste: dados de teste/
• Navegue até a fonte, faça alterações e execute testes de unidade para verificar
  • Formatos binários e APIs comuns: poi/src/main/java/org/apache/poi/
  • Somente APIs OOXML: poi-ooxml/src/main/java/org/apache/poi/
  • Scratchpad (formatos binários): poi-scratchpad/src/main/java/org/apache/poi/
  • Exemplos: poi-examples/src/main/java/org/apache/poi/
• Mais informações: página Como construir em apache.org

Construindo arquivos jar

Para construir os arquivos jar para poi, poi-ooxml, poi-ooxml-lite, poi-ooxml-full e poi-examples:

 ./gradlew jar

jarra gradlew