全面挖掘Java Excel API 使用方法

使用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 9五、9七、2000等格式的文件中讀取數據； 
　　　讀取Excel公式（能夠讀取Excel 97之後的公式）； 
　　　生成Excel數據表（格式爲Excel 97）； 
　　　支持字體、數字、日期的格式化； 
　　　支持單元格的陰影操做，以及顏色操做； 
　　　修改已經存在的數據表； 

　　如今還不支持如下功能，但不久就會提供了：

　　　不可以讀取圖表信息； 
　　　能夠讀，可是不能生成公式，任何類型公式最後的計算值均可以讀出； 
　
　　 應用示例

　　一、從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．

 

Workbook類提供的方法

　　1. int getNumberOfSheets()

　　得到工做薄（Workbook）中工做表（Sheet）的個數，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); int sheets = rwb.getNumberOfSheets();

　　2. Sheet[] getSheets()

　　返回工做薄（Workbook）中工做表（Sheet）對象數組，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); Sheet[] sheets = rwb.getSheets();

　　3. String getVersion()

　　返回正在使用的API的版本號，好像是沒什麼太大的做用。

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); String apiVersion = rwb.getVersion();

　　Sheet接口提供的方法

　　1) String getName()

　　獲取Sheet的名稱，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); String sheetName = rs.getName();

　　2) int getColumns()

　　獲取Sheet表中所包含的總列數，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); int rsColumns = rs.getColumns();

　　3) Cell[] getColumn(int column)

　　獲取某一列的全部單元格，返回的是單元格對象數組，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); Cell[] cell = rs.getColumn(0);

　　4) int getRows()

　　獲取Sheet表中所包含的總行數，示例：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); int rsRows = rs.getRows();

　　5) Cell[] getRow(int row)

　　獲取某一行的全部單元格，返回的是單元格對象數組，示例子：

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); Cell[] cell = rs.getRow(0);

　　6) Cell getCell(int column, int row)

　　獲取指定單元格的對象引用，須要注意的是它的兩個參數，第一個是列數，第二個是行數，這與一般的行、列組合有些不一樣。

jxl.Workbook rwb = jxl.Workbook.getWorkbook(new File(sourcefile)); jxl.Sheet rs = rwb.getSheet(0); Cell cell = rs.getCell(0, 0);

　　二、生成新的Excel工做薄

　　下面的代碼主要是向你們介紹如何生成簡單的Excel工做表，在這裏單元格的內容是不帶任何修飾的(如：字體，顏色等等)，全部的內容都做爲字符串寫入。(完整代碼見ExcelWriting.java)

　　與讀取Excel工做表類似，首先要使用Workbook類的工廠方法建立一個可寫入的工做薄(Workbook)對象，這裏要注意的是，只能經過API提供的工廠方法來建立Workbook，而不能使用WritableWorkbook的構造函數，由於類WritableWorkbook的構造函數爲protected類型。示例代碼片斷以下：

import java.io.*; import jxl.*; import jxl.write.*; … … … … try { //構建Workbook對象, 只讀Workbook對象 //Method 1：建立可寫入的Excel工做薄 jxl.write.WritableWorkbook wwb = Workbook.createWorkbook(new File(targetfile)); //Method 2：將WritableWorkbook直接寫入到輸出流 /* OutputStream os = new FileOutputStream(targetfile); jxl.write.WritableWorkbook wwb = Workbook.createWorkbook(os); */ } catch (Exception e) { e.printStackTrace(); }

　　API提供了兩種方式來處理可寫入的輸出流，一種是直接生成本地文件，若是文件名不帶全路徑的話，缺省的文件會定位在當前目錄，若是文件名帶有全路徑的話，則生成的Excel文件則會定位在相應的目錄；另一種是將Excel對象直接寫入到輸出流，例如：用戶經過瀏覽器來訪問Web服務器，若是HTTP頭設置正確的話，瀏覽器自動調用客戶端的Excel應用程序，來顯示動態生成的Excel電子表格。

　　接下來就是要建立工做表，建立工做表的方法與建立工做薄的方法幾乎同樣，一樣是經過工廠模式方法得到相應的對象，該方法須要兩個參數，一個是工做表的名稱，另外一個是工做表在工做薄中的位置，參考下面的代碼片斷：

//建立Excel工做表 jxl.write.WritableSheet ws = wwb.createSheet("Test Sheet 1", 0); "這鍋也支好了，材料也準備齊全了，能夠開始下鍋了！"，如今要作的只是實例化API所提供的Excel基本數據類型，並將它們添加到工做表中就能夠了，參考下面的代碼片斷： //1.添加Label對象 jxl.write.Label labelC = new jxl.write.Label(0, 0, "This is a Label cell"); ws.addCell(labelC); //添加帶有字型Formatting的對象 jxl.write.WritableFont wf = new jxl.write.WritableFont(WritableFont.TIMES, 18, WritableFont.BOLD, true); jxl.write.WritableCellFormat wcfF = new jxl.write.WritableCellFormat(wf); jxl.write.Label labelCF = new jxl.write.Label(1, 0, "This is a Label Cell", wcfF); ws.addCell(labelCF); //添加帶有字體顏色Formatting的對象 jxl.write.WritableFont wfc = new jxl.write.WritableFont(WritableFont.ARIAL, 10, WritableFont.NO_BOLD, false, Underlinestyle.NO_UNDERLINE, jxl.format.Colour.RED); jxl.write.WritableCellFormat wcfFC = new jxl.write.WritableCellFormat(wfc); jxl.write.Label labelCFC = new jxl.write.Label(1, 0, "This is a Label Cell", wcfFC); ws.addCell(labelCF); //2.添加Number對象 jxl.write.Number labelN = new jxl.write.Number(0, 1, 3.1415926); ws.addCell(labelN); //添加帶有formatting的Number對象 jxl.write.NumberFormat nf = new jxl.write.NumberFormat("#.##"); jxl.write.WritableCellFormat wcfN = new jxl.write.WritableCellFormat(nf); jxl.write.Number labelNF = new jxl.write.Number(1, 1, 3.1415926, wcfN); ws.addCell(labelNF); //3.添加Boolean對象 jxl.write.Boolean labelB = new jxl.write.Boolean(0, 2, false); ws.addCell(labelB); //4.添加DateTime對象 jxl.write.DateTime labelDT = new jxl.write.DateTime(0, 3, new java.util.Date()); ws.addCell(labelDT); //添加帶有formatting的DateFormat對象 jxl.write.DateFormat df = new jxl.write.DateFormat("dd MM yyyy hh:mm:ss"); jxl.write.WritableCellFormat wcfDF = new jxl.write.WritableCellFormat(df); jxl.write.DateTime labelDTF = new jxl.write.DateTime(1, 3, new java.util.Date(), wcfDF); ws.addCell(labelDTF);

　　這裏有兩點你們要引發你們的注意。第一點，在構造單元格時，單元格在工做表中的位置就已經肯定了。一旦建立後，單元格的位置是不可以變動的，儘管單元格的內容是能夠改變的。第二點，單元格的定位是按照下面這樣的規律(column, row)，並且下標都是從0開始，例如，A1被存儲在(0, 0)，B1被存儲在(1, 0)。

　　最後，不要忘記關閉打開的Excel工做薄對象，以釋放佔用的內存，參見下面的代碼片斷：

//寫入Exel工做表 wwb.write(); //關閉Excel工做薄對象 wwb.close();

　　這可能與讀取Excel文件的操做有少少不一樣，在關閉Excel對象以前，你必需要先調用write()方法，由於先前的操做都是存儲在緩存中的，因此要經過該方法將操做的內容保存在文件中。若是你先關閉了Excel對象，那麼只能獲得一張空的工做薄了。

　　三、拷貝、更新Excel工做薄

　　接下來簡要介紹一下如何更新一個已經存在的工做薄，主要是下面二步操做，第一步是構造只讀的Excel工做薄，第二步是利用已經建立的Excel工做薄建立新的可寫入的Excel工做薄，參考下面的代碼片斷：(完整代碼見ExcelModifying.java)

//建立只讀的Excel工做薄的對象 jxl.Workbook rw = jxl.Workbook.getWorkbook(new File(sourcefile)); //建立可寫入的Excel工做薄對象 jxl.write.WritableWorkbook wwb = Workbook.createWorkbook(new File(targetfile), rw); //讀取第一張工做表 jxl.write.WritableSheet ws = wwb.getSheet(0); //得到第一個單元格對象 jxl.write.WritableCell wc = ws.getWritableCell(0, 0); //判斷單元格的類型, 作出相應的轉化 if(wc.getType() == CellType.LABEL) { Label l = (Label)wc; l.setString("The value has been modified."); } //寫入Excel對象 wwb.write(); //關閉可寫入的Excel對象 wwb.close(); //關閉只讀的Excel對象 rw.close();

　　之因此使用這種方式構建Excel對象，徹底是由於效率的緣由，由於上面的示例纔是API的主要應用。爲了提升性能，在讀取工做表時，與數據相關的一些輸出信息，全部的格式信息，如：字體、顏色等等，是不被處理的，由於咱們的目的是得到行數據的值，既使沒有了修飾，也不會對行數據的值產生什麼影響。惟一的不利之處就是，在內存中會同時保存兩個一樣的工做表，這樣當工做表體積比較大時，會佔用至關大的內存，但如今好像內存的大小並非什麼關鍵因素了。　　一旦得到了可寫入的工做表對象，咱們就能夠對單元格對象進行更新的操做了，在這裏咱們沒必要調用API提供的add()方法，由於單元格已經於工做表當中，因此咱們只須要調用相應的setXXX()方法，就能夠完成更新的操做了。　　盡單元格原有的格式化修飾是不能去掉的，咱們仍是能夠將新的單元格修飾加上去，以使單元格的內容以不一樣的形式表現。　　新生成的工做表對象是可寫入的，咱們除了更新原有的單元格外，還能夠添加新的單元格到工做表中，這與示例2的操做是徹底同樣的。　　最後，不要忘記調用write()方法，將更新的內容寫入到文件中，而後關閉工做薄對象，這裏有兩個工做薄對象要關閉，一個是隻讀的，另一個是可寫入的。