Java: Leggere Files Excel

Mi capita spesso di dover estrapolare dati da files excel che vengono uploadati da una action Struts. Questa li elabora, li ripresenta in forma tabellare all'interno di una pagina JSP prima di essere inviate CICS aziendale tramite componenti generalmente chiamati Resource Adapters.

Tralasciando la fase di upload, per la quale il framework Struts ed altri mettono a disposizione innumerevole documentazione ed altrettante maniere di eseguirlo, per ciò che riguarda l'elaborazione di un file excel, ad oggi nel mondo Java, che io sappia esistono solo le librerie POI create dalla Jakarta Apache.

Dunque, dopo che il file è stato caricato ed è consistente, è possibile iniziare a trattarlo. Nel mio caso, trattandosi di una Web Application ho riposto le librerie POI nella cartella WEB-INF/lib del mio progetto. Le librerie da me utilizzate sono:

• poi-2.5.1-final-20040804.jar;
• poi-contrib-2.5.1-final-20040804.jar;
• poi-scratchpad-2.5.1-final-20040804.jar
  

Per chiarezza, le POI sono le librerie utilizzate nel progetto OpenOffice.

Dunque passiamo all'esempio: la classe che qui riporto contiene il minimo necessario per comprendere i passaggi fondamentali alla base del processo di lettura di files excel, infatti ne riceve uno in input, lo legge riga dopo riga, cella dopo cella e ne scrive il contentuto sulla console Java.

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Iterator;

import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import org.apache.poi.hssf.usermodel.HSSFCell;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFRow;

public class ExcelConPOI {

public static void main( String [] args ) {
//Poichè andiamo a lavorare con il Filesystem
//dobbiamo prevenire una possibile IOException
try {
//Apriamo uno stream per recuperare il file
InputStream input = new FileInputStream("C://esempio.XLS");

//e lo rendiamo utilizzabile dalle librerie POI
POIFSFileSystem fs = new POIFSFileSystem( input );

//un file excel è un WorkBook contenente diversi fogli
HSSFWorkbook wb = new HSSFWorkbook(fs);

//di cui ne leggiamo il primo
HSSFSheet sheet = wb.getSheetAt(0);

Iterator rows = sheet.rowIterator();

//Iteriamo su tutte le righe del foglio
while( rows.hasNext() ) {    
HSSFRow row = (HSSFRow) rows.next();
System.out.println( "N. Riga = " + row.getRowNum() );

Iterator cells = row.cellIterator();
while( cells.hasNext() ) {

//Per ogni riga scorriamo tutte le celle
HSSFCell cell = (HSSFCell) cells.next();
System.out.println( "N. Cella = "
+ cell.getCellNum() );

/*Per ogni cella verifichiamo la tipologia
*del dato che contiene e lo scriviamo
*nel canale di output */
switch ( cell.getCellType() ) {
case HSSFCell.CELL_TYPE_NUMERIC:
System.out.println(
cell.getNumericCellValue() );
break;
case HSSFCell.CELL_TYPE_STRING:
System.out.println(
cell.getStringCellValue() );
break;
default:
System.out.println(
"unsuported cell type" );
break;
}
}
}     
} catch ( IOException ex ) {
ex.printStackTrace();
}
}
}

Le librerie utilizzate sono open source e molto pratiche, infatti non è stato per niente difficile capirle ed utilizzarle ed ovviamente permettono di fare molte altre cose tra le quali creare files excel ben formattati e complessi e preparare le fasi di stampa degli stessi.

Alla prossima,
MA.