Java Excel Api - II

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類的工廠方法創建一個可寫入的工作薄(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物件，那麼只能得到一張空的工作薄了。

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

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