Search jakarta

Jakarta POI - API Java Para Acceder Ficheros con Formato Microsoft

Prop�sito

El proyecto POI consiste en APIs para manipular varios formatos de ficheros basados en el formato de Documento Compuesto OLE 2 de Microsoft, utilizando Java puro. En concreto, se pueden leer y escribir ficheros MS Excel utilizando Java. Pronto se podr� leer y escribir ficheros Word utilizando Java. POI es su soluci�n Java Excel as� como su soluci�n Java Word. En cualquier caso, tenemos un API completo para portar otros formatos de Documento Compuesto OLE 2 y todo aquel que quiera participar ser� bienvenido.

Entre los ficheros basados en el formato de Documento Compuesto OLE 2 de Microsoft se incluyen la mayor parte de los ficheros de Microsoft Office tales como XLS y DOC as� como formatos de fichero basados en el API de serializaci�n MFC.

Como regla general intentamos colaborar lo m�s posible con otros proyectos para proporcionar esta funcionalidad. Algunos ejemplos: Cocoon para el que hay serializadores para HSSF; Open Office.org con quienes colaboramos en la documentaci�n del formato XLS; y Lucene para el que pronto tendremos int�rpretes del formato de fichero. Cuando es pr�ctico, donamos componentes directamente a los proyectos para dotarles de capacidad-POI.

�Por qu�/cu�ndo utilizar POI?

Abordaremos esto a nivel de componente. POI se refiere al proyecto completo.

As� que, �por qu� deber�a utilizar POIFS o HSSF?

Utilizar�as POIFS si tuvieras un documento escrito en el Formato de Documento Compuesto OLE 2, probablemente escrito utilizando MFC, que necesitaras leer en Java. Alternativamente, utilizar�as POI para escribir en el Formato de Documento Compuesto OLE 2 si necesitaras inter-operar con programas ejecut�ndose en la plataforma Windows. No nos estamos jactando cuando decimos que �POIFS es la adaptaci�n m�s completa y correcta de este formato de fichero hasta la fecha!

Utilizar�as HSSF si necesitaras leer o escribir un fichero Excel utilizando Java (XLS). Tambi�n se pueden leer y modificar hojas de c�lculo utilizando este API, aunque ahora mismo la escritura est� m�s madura.

Componentes a D�a de Hoy

Visi�n General

Un pensamiento err�neo generalizado es que POI escribe ficheros Excel. POI es el nombre del proyecto. POI contiene varios componentes, uno de los cuales, HSSF, escribe ficheros Excel. Siguen a continuaci�n los componentes del proyecto POI completo y un peque�o sumario de su prop�sito.

POIFS

POIFS es la parte m�s vieja y m�s estable del proyecto. Es nuestra adaptaci�n del Formato de Documento Compuesto OLE 2 a Java puro. Soporta funcionalidad de lectura y escritura. Todos nuestros componentes se sirven de �l por definici�n. Por favor, vea la p�gina del proyecto POIFS [EN] para m�s informaci�n.

HSSF

HSSF es nuestra adaptaci�n del formato de fichero de Microsoft Excel 97(-2002) (BIFF8) a Java puro. Soporta lectura y escritura. Por favor, vea la p�gina del proyecto HSSF [EN] para m�s informaci�n.

HWPF

HWPF es nuestra adaptaci�n del formato de fichero de Microsoft Word 97 a Java puro. Soporta lectura y escritura. Por favor, vea la p�gina del proyecto HWPF [EN] para m�s informaci�n. Este componente est� en la fase inicial de dise�o. Ya puede leer y escribir ficheros sencillos. �Entra!

HPSF

HPSF es nuestra adaptaci�n del formato de conjunto de propiedades OLE 2 a java puro. Los conjuntos de propiedades se utilizan mayoritariamente para almacenar las propiedades de un documento (t�tulo, autor, fecha de la �ltima modificaci�n etc.), pero tambi�n pueden ser utilizados para prop�sitos espec�ficos de una aplicaci�n. Actualmente HPSF soporta s�lo funcionalidad de lectura. Por favor, vea la p�gina del proyecto HPSF [EN] para m�s informaci�n.

Contribuyendo

As� que �te gustar�a contribuir al proyecto? �Genial! Necesitamos gente entusiasta, que trabaje duro, que tenga talento para ayudarnos con el proyecto en varias �reas. �La primera es petici�n de nuevas funciones y aviso de errores! La segunda es documentaci�n - estaremos a tu entera disposici�n si tienes alguna cr�tica o te gustar�a contribuir o mejorar de alguna forma la documentaci�n. �Especialmente no nos vendr�a mal algo de ayuda en documentar el formato de fichero HSSF! �Por �ltimo, aunque no por ello menos importante, nos vendr�a bien algunos programadores Java que mastiquen binario, para que le echen el diente a la convoluci�n que caracteriza los formatos de fichero de Microsoft y para que nos ayude a adaptar nuevos formatos a una plataforma Java superior!

�As� que si est�s motivado, listo, y tienes tiempo, �nete a las listas de correo y estaremos encantados de ayudarte a empezar en el proyecto!

by Andrew C. Oliver, Glen Stampoultzis, Avik Sengupta, Agust�n Mart�n Barbero