2007/06/07

Java Excel Api - I

使用Windows作業系統的朋友對Excel(試算表)一定不會陌生,但是要使用Java語言來操縱Excel檔並不是一件容易的事。在Web應用日益盛行的今天,通過Web來操作Excel檔的需求越來越強烈,目前較為流行的操作是在JSP或Servlet 中創建一個CSV (comma separated values)檔,並將這個檔以MIME,text/csv類型返回給流覽器,接著流覽器調用Excel並且顯示CSV檔。這樣只是說可以訪問到Excel檔,但是還不能真正的操縱Excel檔,本文將給大家一個驚喜,向大家介紹一個開放源碼項目,Java Excel API,使用它大家就可以方便地操縱Excel檔了。

  Java Excel API簡介

  Java Excel是一開放源碼專案,通過它Java開發人員可以讀取Excel檔的內容、創建新的Excel檔、更新已經存在的Excel檔。使用該API非Windows作業系統也可以通過純Java應用來處理Excel資料表。因為是使用Java編寫的,所以我們在Web應用中可以通過JSP、Servlet來調用API實現對Excel資料表的訪問。

  現在發佈的穩定版本是V2.0,提供以下功能:

   從Excel 95、97、2000等格式的檔中讀取資料;
   讀取Excel公式(可以讀取Excel 97以後的公式);
   生成Excel資料表(格式為Excel 97);
   支援字體、數位、日期的格式化;
   支援單格的陰影操作,以及顏色操作;
   修改已經存在的資料表;

  現在還不支援以下功能,但不久就會提供了:

   不能夠讀取圖表資訊;
   可以讀,但是不能生成公式,任何類型公式最後的計算值都可以讀出;
 
   應用示例

  1、從Excel檔讀取資料表

  Java Excel API既可以從本地檔系統的一個檔(.xls),也可以從輸入流中讀取Excel資料表。讀取Excel資料表的第一步是創建Workbook(術語:工作薄),下面的代碼片段舉例說明了應該如何操作:(完整代碼見ExcelReading.java)
import java.io.*;
import jxl.*;
… … … …
try
{
//構建Workbook物件, 唯讀Workbook物件
//直接從本地檔創建Workbook
//從輸入流創建Workbook
InputStream is = new FileInputStream(sourcefile);
jxl.Workbook rwb = Workbook.getWorkbook(is);
}
catch (Exception e)
{
e.printStackTrace();
}

  一旦創建了Workbook,我們就可以通過它來訪問Excel Sheet(術語:工作表)。參考下面的代碼片段:
//獲取第一張Sheet表
Sheet rs = rwb.getSheet(0);

  我們既可能通過Sheet的名稱來訪問它,也可以通過下標來訪問它。如果通過下標來訪問的話,要注意的一點是下標從0開始,就像陣列一樣。

  一旦得到了Sheet,我們就可以通過它來訪問Excel Cell(術語:單格)。參考下面的代碼片段:
//獲取第一行,第一列的值
Cell c00 = rs.getCell(0, 0);
String strc00 = c00.getContents();

//獲取第一行,第二列的值
Cell c10 = rs.getCell(1, 0);
String strc10 = c10.getContents();

//獲取第二行,第二列的值
Cell c11 = rs.getCell(1, 1);
String strc11 = c11.getContents();

System.out.println("Cell(0, 0)" + " value : " + strc00 + "; type : " + c00.getType());
System.out.println("Cell(1, 0)" + " value : " + strc10 + "; type : " + c10.getType());
System.out.println("Cell(1, 1)" + " value : " + strc11 + "; type : " + c11.getType());

  如果僅僅是取得Cell的值,我們可以方便地通過getContents()方法,它可以將任何類型的Cell值都作為一個字串返回。示例代碼中Cell(0, 0)是文本型,Cell(1, 0)是數字型,Cell(1,1)是日期型,通過getContents(),三種類型的返回值都是字元型。

  如果有需要知道Cell內容的確切類型,API也提供了一系列的方法。參考下面的代碼片段:
String strc00 = null;
double strc10 = 0.00;
Date strc11 = null;

Cell c00 = rs.getCell(0, 0);
Cell c10 = rs.getCell(1, 0);
Cell c11 = rs.getCell(1, 1);

if(c00.getType() == CellType.LABEL)
{
LabelCell labelc00 = (LabelCell)c00;
strc00 = labelc00.getString();
}
if(c10.getType() == CellType.NUMBER)
{
NmberCell numc10 = (NumberCell)c10;
strc10 = numc10.getvalue();
}
if(c11.getType() == CellType.DATE)
{
DateCell datec11 = (DateCell)c11;
strc11 = datec11.getDate();
}

System.out.println("Cell(0, 0)" + " value : " + strc00 + "; type : " + c00.getType());
System.out.println("Cell(1, 0)" + " value : " + strc10 + "; type : " + c10.getType());
System.out.println("Cell(1, 1)" + " value : " + strc11 + "; type : " + c11.getType());

  在得到Cell物件後,通過getType()方法可以獲得該單格的類型,然後與API提供的基本類型相匹配,強制轉換成相應的類型,最後調用相應的取值方法getXXX(),就可以得到確定類型的值。API提供了以下基本類型,與Excel的資料格式相對應,如下圖所示:

  每種類型的具體意義,請參見Java Excel API document.

  當你完成對Excel試算表資料的處理後,一定要使用close()方法來關閉先前創建的物件,以釋放讀取資料表的過程中所佔用的記憶體空間,在讀取大量資料時顯得尤為重要。參考如下代碼片段:
//操作完成時,關閉物件,釋放佔用的記憶體空間
rwb.close();

  Java Excel API提供了許多訪問Excel資料表的方法,在這裏我只簡要地介紹幾個常用的方法,其他的方法請參考附錄中的Java Excel API document。

[以上文章均為轉貼自香港IT網]

沒有留言:

NGINX SSL/設定檔案

#user nobody; worker_processes 1; #error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info; #...