Java Excel API 使用方法

：http://sourceforge.net/projects/jexcelapi/files/

 

 

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);

　　2、產生新的Excel工作薄

　　下面的代碼主要是向大家介紹如何產生簡單的Excel工作表，在這裡儲存格的內容是不帶任何修飾的(如：字型，顏色等等)，所有的內容都作為字串寫入。(完整代碼見ExcelWriting.java)

　　與讀取Excel工作表相似，首先要使用Workbook類的Factory 方法建立一個可寫入的工作薄(Workbook)對象，這裡要注意的是，只能通過 API提供的Factory 方法來建立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基礎資料型別 (Elementary Data Type)，並將它們添加到工作表中就可以了，參考下面的程式碼片段：
//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對象，那麼只能得到一張空的工作薄了。

　　3、拷貝、更新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()方法，將更新的內容寫入到檔案中，然後關閉工作薄對象，這裡有兩個工作薄對象要關閉，一個是唯讀，另外一個是可寫入的。