小白·菜

上次談過了使用iText產生PDF檔，這次換成來談談使用JExcel來產生EXCEL檔的方法。

首先，先到他的SourceForge主頁面download相關的API檔案。
http://sourceforge.net/projects/jexcelapi/
或
http://www.andykhan.com/jexcelapi/download.html
當然，他也是OpenSource的元件。

下列為其Tutorial教學：
http://www.andykhan.com/jexcelapi/tutorial.html

一切就緒後，那就準備上路了。

下載下來的壓縮檔解開後，可以找到jxl.jar，先將此檔案加入你的Classpath中吧！

1. 先建立Workbook
也就是整份的Excel檔案，可指定檔名。

Workbook workbook = Workbook.getWorkbook(new File("test.xls"));

2. 建立Sheet
也就是每個Excel檔案下面可以跳tag的sheet表。

Sheet sheet = workbook.createSheet("我的Excel表", 0);

第一個參數是sheet name，第二個參數是第幾張sheet，當然index是由0開始算。

3. 建立字型

WritableFont chFont11w = new WritableFont(WritableFont.TIMES, 11);
chFont11w.setColour(Colour.WHITE);

先建立一個WritableFont的instance，其constructor的第一個參數是指定字型，第二個是字型大小。
其中字型的部份，可以使用WritableFont所提供預設的一堆static常數來指定，
也可以直接輸入string，比如打"標楷體"，到時產生的字型就會依照你所指定的來顯示。

而setColour是指定此字型的顏色，這個部份就麻煩。
(由colour這個字來看，很顯然的JExcel應是英國相關的人開發的:P 反正總之不會是美國)

顏色為什麼麻煩呢？在JExcel裡面，Colour class並不提供public constructor讓user自己指定RGB的顏色，
所以你只能從Colour中一堆的static常數顏色來指定，之前為了這個問題還研究了一下他的原始碼，
果然是不行，他的constructor是protected的，就連繼承之後雖然可以指定rgb顏色，但是仍然沒有作用。

(後來我看了一下Excel，發現原來這是因為Excel的標準調色盤就那些顏色
不像Word一樣可以讓使用者自訂顏色的關係)

查API doc就可以看到，他提供的顏色有：

static Colour AQUA            
static Colour AUTOMATIC            
static Colour BLACK            
static Colour BLUE            
static Colour BLUE_GREY            
static Colour BLUE2            
static Colour BRIGHT_GREEN            
static Colour BROWN            
static Colour CORAL            
static Colour DARK_BLUE            
static Colour DARK_BLUE2            
static Colour DARK_GREEN            
static Colour DARK_PURPLE            
static Colour DARK_RED            
static Colour DARK_RED2            
static Colour DARK_TEAL            
static Colour DARK_YELLOW            
static Colour DEFAULT_BACKGROUND            
static Colour DEFAULT_BACKGROUND1            
static Colour GOLD            
static Colour GRAY_25            
static Colour GRAY_50            
static Colour GRAY_80            
static Colour GREEN            
static Colour GREY_25_PERCENT            
static Colour GREY_40_PERCENT            
static Colour GREY_50_PERCENT            
static Colour GREY_80_PERCENT            
static Colour ICE_BLUE            
static Colour INDIGO            
static Colour IVORY            
static Colour LAVENDER            
static Colour LIGHT_BLUE            
static Colour LIGHT_GREEN            
static Colour LIGHT_ORANGE            
static Colour LIGHT_TURQUOISE            
static Colour LIGHT_TURQUOISE2            
static Colour LIME            
static Colour OCEAN_BLUE            
static Colour OLIVE_GREEN            
static Colour ORANGE            
static Colour PALE_BLUE            
static Colour PALETTE_BLACK            
static Colour PERIWINKLE            
static Colour PINK            
static Colour PINK2            
static Colour PLUM            
static Colour PLUM2            
static Colour RED            
static Colour ROSE            
static Colour SEA_GREEN            
static Colour SKY_BLUE            
static Colour TAN            
static Colour TEAL            
static Colour TEAL2            
static Colour TURQOISE2            
static Colour TURQUOISE            
static Colour UNKNOWN            
static Colour VERY_LIGHT_YELLOW            
static Colour VIOLET            
static Colour VIOLET2            
static Colour WHITE            
static Colour YELLOW            
static Colour YELLOW2

上面列了這麼多，哪知道哪一個真正的顏色是怎麼樣？
除非自己邊試邊換才知，這太麻煩了，我寫了一隻程式把所有的顏色都印出來：

好了，但問題來了，上面提供的顏色如果對比較龜毛的人而言(比如我...)，
一定是不足使用的，但如剛剛上述說的，Colour不提供自訂顏色的功能，
後來找了老半天文件，終於找到一個可以用的方式，
就是在workbook中，提供了一個setColourRGB的method，
但這個method並不是設定新的顏色，而是可以把上述提供的顏色重新覆寫其RGB設定值，
這個方法雖然不是挺好，但是終於有救了！

所以你就找個顏色來開刀，例如：
workbook.setColourRGB(Colour.DARK_GREEN, 0xDB, 0xF4, 0x8E);
我把DARK_GREEN的RGB改寫成#DBF48E (0x表示16進位)
(你要什麼顏色而有什麼16進位色碼，很多方法可以取得，比如：Photoshop、Dreamweaver等)
這樣一來，之後再使用Colour.DARK_GREEN，就會變成我們想要的顏色了。

4. 產生儲存格Cell的格式

  WritableCellFormat cellFormat1 = new WritableCellFormat ();
  cellFormat1.setFont(chFont11w);
  cellFormat1.setBackground(Colour.DARK_GREEN);
  cellFormat1.setAlignment(Alignment.CENTRE);
  cellFormat1.setBorder(Border.ALL, BorderLineStyle.THIN, Colour.GRAY_80);

這裡呢，要先產生你要的cell的格式，例如指定字型setFont，把我們剛剛產生的白色11大小的TIMES指定進去，
設定背景setBackground，把我們剛剛覆寫掉的DARK_GREEN指定進去，
指定對齊方式setAlignment為置中，
以及設定此cell的上下左右(Border.ALL)的框線以及顏色。

5. 增加一個文字儲存格Cell

Label label = new Label(2, 3, "我是rexmen", cellFormat1);
sheet.addCell(label);  

此constructor的第一個參數是產生的儲存格的x的位置，2表示第3欄(index從0開始算)
第二個參數就是y的位置，3表示第4列。
用Excel的講法來說，就是「C4」那一格。
而第三個就是輸入的文字，而第四格就把我們剛剛產生的cell的format指定進去。

最後再把此label加入sheet中。使用addCell method。

6. 寫入及結束文件
把該作的都作完後，別忘了close掉文件，

workbook.write(); 
workbook.close();

先使用write()寫入後，再用colose關閉。
這樣就大功告成囉！最基本的JExcel就完成了。
其他的功能啦，插入圖片啦、試算的公式啦、有的沒的自己有空再試了！


其他：
若是在JSP上要讓User download這個動態產生的excel檔，
要用Servlet RequestDispatcher的方式，
若沒有設定正確表頭，導過去的檔案會會在browser上看到的是亂碥，
要記得設定 response.setContentType("application/vnd.ms-excel");
再導到正確的excel檔案位置

RequestDispatcher view = request.getRequestDispatcher("test.xls");
view.forward(request, response);

如此以來，在網址列上不會show出 test.xls 的檔名 (會按照你在web.xml裡設定的servlet對應mapping檔名)，
而且可以正確的在browser裡看到Excel的內容。