web頁面jsp頁面的打印


報表在信息系統中佔據了極爲重要的位置,廣義上講,報表主要以多樣的格式呈現和打印動態數據,動態數據主要指保存在數據庫中的數據,也可以是文本中的數據、XML數據、Hibernate數據、EJB數據、自定義數據或則是其他程序產生的數據等,報表最顯著的特徵是它能夠高度靈活處理數據,幫助用戶全面的利用分散的數據。

1  報表打印技術

1.1  JavaScript+CSS打印技術

在JSP中,通過JavaScript腳本調用IE瀏覽器自身的打印功能可以將當前頁面中的內容進行打印。調用JavaScript腳本window對象的print()方法,可以實現打印功能。

語法:

window.print();

例如,在超鏈接標記<A>中的onClick事件調用Window對象的print()方法,代碼如下:

<a href="#" onClick="window.print()">JavaScript腳本打印</a>

CSS在網頁佈局中的應用得到不斷的擴展,例如,在XHTML網站設計標準中,可以採用DIV+CSS的方式實現各種定位等。其優點如下:

(1)它本身符合W3C標準,並且支持瀏覽器的向後兼容。

(2)使用CSS技術設計的網頁,能夠更容易被搜索引擎收錄。

(3)CSS設計方法能夠將頁面顯示內容和外觀樣式分離開來、能夠通過CSS樣式對DIV標記進行格式限定,從而減少程序代碼的編寫數量,並且能縮短網頁打開時間以方便用戶瀏覽。內容和樣式的分離,使頁面和樣式的調整變得更加方便。

通過JavaScript+CSS設計方法可以高效的製作出符合用戶要求的頁面或者報表格式等。

1.2  WebBrowse打印技術

在JSP頁面中可以調用IE內置的瀏覽器控件WebBrowser,通過使用WebBrowser控件的Execwb方法可實現打印預覽、打印、進行頁面設置等操作。

在頁面中調用控件WebBrowser的語句如下:

<object id=WebBrowser classid=ClSID:8856F961-340A-11D0-A96B-00C04Fd705A2 width="0" height="0"></object>

下面介紹WebBrowser控件的Execwb方法,該方法主要用於對IE瀏覽器頁面的操作。

語法:

WebBrowser.ExecWB nCmdID,nCmdExecOpt,[pvaIn],[pvaOut]

nCmdID:表示執行命令的ID號。

nCmdExecOpt:命令執行的參數,一般設定其值爲1。

下面介紹一些常用的命令(其中WebBrowser表示調用WebBrowser控件時定義的ID名稱),如:

WebBrowser.Execwb(1,1)表示打開頁面。

WebBrowser.Execwb(2,1)表示關閉現在所有的IE窗口,並打開一個新窗口。

WebBrowser.Execwb(4,1)表示保存網頁。

WebBrowser.Execwb(6,1)表示打印頁面。

WebBrowser.Execwb(6,6)表示直接打印頁面。

WebBrowser.Execwb(7,1)表示打印預覽頁面。

WebBrowser.Execwb(8,1)表示進行打印頁面設置。

WebBrowser.Execwb(10,1)表示查看頁面屬性。

WebBrowser.Execwb(22,1)表示刷新頁面。

WebBrowser.Execwb(45,1)表示關閉窗體時無提示。

讀者可根據實際情況,通過設置Execwb方法中各參數值,對頁面進行各項操作。

1.3  Word、Excel打印技術

Microsoft Word是Microsoft提供的優秀文檔處理軟件,它在處理文檔、資料過程中都顯現出其強大的處理功能。在JSP中可以調用Word的相關對象實現報表打印的功能。下面介紹Word的Application對象、Document對象和Range對象的常用屬性和方法。

l          Word的Application對象

通過Application對象,可以訪問由應用程序提供的所有其他對象。下面介紹Application對象的常用屬性和方法。

²         ActiveDocument屬性

ActiveDocument屬性返回一個表示活動文檔或具有焦點的文檔的Document對象。

²         ActivePrinter屬性

通過ActivePrinter屬性可以設置或返回活動打印機的名稱。

²         ActiveWindow屬性

ActiveWindow屬性返回具有焦點的窗口。

²         Caption屬性

通過Caption屬性設置或返回指定文檔或應用程序窗口的標題文本。

²         DisplayAlerts屬性

DisplayAlerts屬性用於指定代碼運行時處理警報的方式。WdAlertlevel的取值有3個,分別爲WdAlertsAll(默認值,顯示所有消息和警報)、wdAlertsMessageBox(只顯示消息框)和wdAlertsNone(不顯示任何警報或消息框)。如果在執行程序之前將DisplayAlerts屬性值設置爲wdAlertsNone,程序將在無任何消息和警報的情況下執行,但在完成指定代碼後,要確保將DisplayAlerts設置爲WdAlertsAll。如:

Application.DisplayAlerts=Word.WdAlertLevel.wdAlertsAll

²         DisplayStatusBar屬性

DisplayStatusBar屬性用於指示是否顯示狀態欄,返回一個Boolean類型值,爲讀/寫屬性。

²         Path屬性

Path屬性返回當前應用程序的路徑。

²         Visible屬性

Visible屬性用於打開或關閉Word應用程序自身的顯示,爲讀/寫屬性。當設置Visible屬性值爲False時,將隱藏所有打開的Word窗口,但實際Word應用程序仍在運行。

²         CheckSpelling方法

CheckSpelling方法用於檢查字符串的拼寫是否有誤。如果發現錯誤則返回True,如果未發現錯誤則返回False。

²         Move方法

通過設置Move方法中的Left和Top參數(二者均爲Integer值)移動應用程序主窗口。

²         Resize方法

通過設置Resize方法Width和Height參數(二者以磅爲單位)調整應用程序主窗口的大小。

²         Quit方法

調用Quit方法將退出Word應用程序。WdSaveOptions的取值有3個,分別爲wdSaveChanges(自動保存更改)、wdPromptToSaveChanges(提示保存更改)和wdDoNotSaveChanges(不保存更改退出)。如:

Application.Quit(Word.WdSaveOptions.wdPromptToSaveChanges)

l          Word的Document對象

Microsoft Word中的大多數編程活動都將涉及Document對象或其相關內容。在Word中處理某個特定文檔時,這個文檔就稱爲活動文檔,這時可通過Application對象的ActiveDocument屬性創建Document對象。所有的Document對象同時也是Application對象的Documents集合的成員,該集合由所有打開的文檔組成。使用Document對象時,允許使用單個文檔,而Document集合則允許使用所有打開的文檔。由於通過Application對象和Document對象都可以進行文檔操作,所以Application對象和Document對象共享許多成員。

文檔是由字符組成,字符排列成詞,詞構成句子,句子排列成段落,段落依次排列而構成節。Document對象具有一些映射到這些構造的集合,如Characters集合、Words集合、Sentences集合、Paragraphs集合、Sections集合、HeadersFooters集合。

l          Word的Range對象

Range對象表示文檔中的一個連續區域,此區域由起始字符位置和終止字符位置定義。指定的區域可以小至插入點、大至整個文檔,還可以是當前選定內容代表的區域。可以定義一個Range對象,也可以在單個文檔中定義多個Rang對象。Range對象中的字符包括非打印字符,如空格、回車符和段落標記。創建Range對象後,可以對在指定範圍內搜索字符、設置文本格式等。

Microsoft Excel是Microsoft提供的用於辦公管理的應用軟件,它具有強大的表格統計功能。在JSP應用程序中,通過在JavaScript腳本中應用Application對象、Workbook對象、Worksheet對象和Range對象的相關屬性和方法,可以實現將Web頁面中的數據寫入到Excel,然後由Excel自動打印報表內容的功能。

l          Excel的Application對象

Excel的Application對象是Excel對象模型中的頂級對象。使用Application 對象可以確定或指定應用程序級屬性或執行應用程序級方法。Application對象也是訪問Excel對象模型的其它部分的轉入點。

在JavaScript腳本中應用ActiveXObject()構造函數可以創建一個Excel.Application對象的實例,即顯式引用Application對象。下面介紹Application對象的常用屬性和方法。

²         ActiveCell屬性

ActiveCell屬性返回一個Range對象,該對象代表活動窗口的活動單元格,或指定窗口的活動單元格。如果該窗口顯示的不是工作表,則該屬性無效。此屬性爲只讀屬性。下列表達式都是返回活動單元格,並都是等價的。

ActiveCell

Application.ActiveCell

ActiveWindow.ActiveCell

Application.ActiveWindow.ActiveCell

如果不指定對象識別符,本屬性返回的是活動窗口中的活動單元格。活動單元格與選定區域是有區別的:活動單元格是當前選定區域內的單個單元格;選定區域可能包含多個單元格,但其中只有一個是活動單元格。

²         ActiveChart屬性

ActiveChart屬性返回Chart對象,該對象代表活動圖表(包括嵌入式圖表或圖表工作表)。當選定或激活嵌入式圖表時,該嵌入式圖表就成爲當前活動的圖表。如果當前沒有活動的圖表,本屬性返回值爲Nothing。此屬性爲只讀屬性。

語法:

[對象識別符.]ActiveChart

如果未指定對象識別符,此屬性返回活動工作簿上的活動圖表。

²         ActivePrinter屬性

通過ActivePrinter屬性可以設置或返回活動打印機的名稱。此屬性爲可讀寫的字符串類型。

語法:

Application.ActivePrinter

²         ActiveSheet屬性

ActiveSheet屬性返回一個Worksheet對象,該對象代表活動工作簿中的,或者指定窗口工作簿中的活動工作表。如果沒有活動的工作表,將返回值Nothing。此屬性爲只讀屬性。

語法:

[對象識別符.]ActiveSheet[.對象對應的屬性]

如果未給出對象識別符,此屬性返回活動工作簿中的活動工作表。

如果某一工作簿在若干個窗口中出現,那麼該工作簿的ActiveSheet屬性在不同窗口中的返回值可能不同。

²         ActiveWorkbook屬性

ActiveWorkbook屬性返回一個Workbook對象,該對象代表活動窗口的工作簿。此屬性爲只讀屬性。

語法:

[對象識別符.]ActiveWorkbook[.對象對應的屬性]

如果沒有打開任何窗口、活動窗口、信息窗口或剪貼板窗口,則此屬性返回值Nothing。

²         Cells屬性

Cells屬性返回Range對象,該對象代表活動工作表中所有的單元格。此屬性爲只讀屬性。

語法:

[對象識別符.]Cells

如果當前活動文檔不是工作表,則不能讀取此屬性值。

²         Charts屬性

Charts屬性返回一個Sheets集合,該集合代表活動工作簿中的所有圖表工作表。此屬性爲只讀屬性。

語法:

[對象識別符.] Charts

如果不給出對象識別符,將返回活動工作簿中所有的圖表工作表。

²         Columns屬性

Columns屬性返回一個Range對象,該對象代表活動工作表中的所有列。此屬性爲只讀屬性。

語法:

[對象識別符.]Columns

如果活動文檔不是工作表,則Columns屬性無效。

²         Parent屬性

Parent屬性返回指定對象的父對象。此屬性爲只讀屬性。

語法:

對象識別符.Parent

²         Path屬性

Path屬性是將Microsoft Excel的完整路徑返回給應用程序,但不包括末尾的分隔符和應用程序名稱。字符串類型,併爲只讀屬性。

語法:

對象識別符.Path

²         Range屬性

Range屬性返回一個Range對象,該對象代表一個單元格或單元格區域。

語法:

對象識別符.Range(Cell1,Cell2)

Cell1:表示區域名稱,爲必填項。可包括區域操作符(冒號)、相交區域操作符(空格)或合併區域操作符(逗號)。可在區域中任一部分使用局部定義名稱。

Cell2:表示區域左上角和右下角的單元格,爲可選項。可以是一個包含單個單元格、整列或整行的Range對象,或是一個用宏語言爲單個單元格命名的字符串。

如果沒有使用對象識別符,則該屬性是ActiveSheet.Range的快捷方式(它返回活動表的一個區域,如果活動表不是一張工作表,則該屬性無效)。

²         Rows屬性

Rows屬性返回代表活動工作表所有行的Range對象。如果活動文檔不是工作表,Rows屬性無效。

語法:

[對象識別符.]Range

在不用對象識別符的情況下使用此屬性等價於ActiveSheet.Rows

²         Sheets屬性

Sheets屬性返回代表活動工作簿中所有工作表的Sheets集合。

語法:

[對象識別符.]Sheets

在不用對象識別符的情況下,使用此屬性等價於使用ActiveWorkbook.Sheets

²         UserControl屬性

如果應用程序可見,或者用戶已創建或啓動應用程序,則UserControl屬性值爲True。如果以編程方式通過CreateObject函數或GetObject函數啓動應用程序,且應用程序爲隱藏狀態,則該屬性值爲False。此屬性可讀寫。

語法:

對象識別符.UserControl[=屬性值]

當對象的UserControl屬性爲False時,則最後一個以編程方式對該對象的引用釋放以後,該對象也將釋放。如果屬性值爲False,並且會話中最後一個對象已釋放,Microsoft Excel將自動退出。

²         Workbooks屬性

Workbooks屬性返回一個Workbooks集合,此集合代表所有打開的工作簿。此屬性爲只讀屬性。

語法:

[對象識別符.]Workbooks

在不使用對象識別符的情況下,使用此屬性等價於Application.Workbooks

由Workbooks屬性返回的集合並不包含打開的加載宏(一種特殊的隱藏工作簿)。但如果已知宏文件名,則可返回單個打開的加載宏。例如,Workbooks("mr.xla")將打開的名爲“mr.xla”的加載宏作爲Workbook屬性返回結果。

²         Quit方法

調用Quit方法將退出Microsoft Excel。

語法:

對象識別符.Quit

使用此方法時,如果有未保存的工作簿處於打開狀態,則Microsoft Excel將彈出一個對話框,詢問是否要保存所作的更改。爲避免這一情況,可在使用Quit方法前保存所有的工作簿或將DisplayAlerts屬性(宏運行時Microsoft Excel顯示特定的警告和消息,默認值爲True)設置爲False,這時在Microsoft Excel退出時,即使有未保存的工作簿,也不會顯示對話框,而且不保存就執行退出命令。

l          Excel的Workbook對象

Workbook對象表示一個.xls或.xla工作簿文件。使用Workbook對象可以處理單個Excel工作簿。使用Workbooks集合可以處理所有當前打開的Workbook對象。

使用Application對象的ActiveWorkbook屬性可以返回對當前活動工作簿的引用。Workbooks集合中的Count屬性可以用於確定打開了多少可見工作簿和隱藏工作簿。默認情況下,Excel通常有一個名爲Personal.xls的隱藏工作簿,它是由Excel作爲宏的存儲位置而創建的。如果隱藏的Personal.xls工作簿是唯一打開的工作簿,ActiveWorkbook屬性將返回字符串Nothing;而Workbooks集合的Count屬性將返回1,僅當沒有打開的隱藏或可見工作簿時,Workbooks集合的Count屬性才返回0。

下面介紹幾個Workbook對象的常用方法。

²         Add方法

使用Workbooks集合的Add方法可以創建新的Workbook對象。Add方法不但創建新的工作簿,同時立即打開創建的工作簿。調用Add方法還將返回一個表示創建的新工作簿的對象變量。

語法:

對象識別符.Add

²         SaveAs方法

調用Workbook對象的SaveAs方法並指定要保存的工作簿的名稱,可以保存新工作薄。如果已存在該名稱的工作簿,則調用此方法時將出現錯誤。使用SaveAs方法保存工作簿之後,可以使用Workbook對象的Save方法來保存其它更改,也可以使用SaveCopyAs方法用另一個文件名來保存現有工作簿的副本。

Workbook對象的Name屬性是一個由Excel指定的值,使用SaveAs方法保存新工作簿後,Name屬性將爲SaveAs方法的Filename參數中提供的名稱。Name屬性是隻讀的,所以要更改工作簿的名稱,必須再次使用SaveAs方法,並在Filename參數中傳遞另一個值。

語法:

對象識別符.SaveAs(Filename)

Filename:表示保存的Excel文件名稱。

*   注意:Workbook對象的FullName屬性包含對象的路徑和文件名,而Path屬性只包含當前工作簿的已保存路徑。保存新工作簿之前,FullName屬性值與Name屬性值相同,而Path屬性不包含任何值。

²         Open方法

Workbooks集合的Open 方法可用於打開現有的工作簿。使用Open方法打開工作簿後,該工作簿即成爲活動工作簿。在調用Open方法時可以指定文件名。

語法:

對象識別符.Open(Filename)

²         Close方法

Workbook對象的Close方法用於關閉打開的工作簿。

語法:

對象識別符.Close

*   注意:Workbook對象的Saved屬性返回的是一個布爾值,該值指明該工作簿是否已經保存。對於任何新建或已打開但沒有進行任何更改的工作簿,Saved屬性將爲True;對於包含未保存更改的工作簿,該屬性則爲False。可以將Saved屬性設置爲True,這樣做的用處在於,當用戶關閉工作簿時如果未對工作簿做任何更改,可以不提示用戶保存更改。

l          Excel的Worksheet對象

用戶在Microsoft Excel中進行的大多數工作是在工作表環境中進行的。工作表包含用於處理數據的單元格,以及數百個用於處理工作表中數據的屬性、方法和事件。

Worksheet對象包含在Worksheets集合中,可以使用Workbook對象的Worksheets屬性來訪問工作表中的數據。通過Workbook對象的Worksheets屬性可以返回工作簿中所有工作表的集合,通過Workbook對象的Sheets屬性可以返回工作簿中所有工作表和圖表工作表的集合。

使用Worksheets集合的Add方法,可以將一個或多個工作表添加到Worksheets集合中;調用Worksheet對象的Delete方法可以從Worksheets集合中刪除工作表。

l          Excel的Range對象

在Microsoft Excel中,Range對象是功能強大、應用靈活的對象之一。

就對象而言,Excel的Range對象是比較獨特的。一個區域在不同情況下可以是不同的事物,Range對象可以是單個單元格或單元格集合;可以是單個對象或對象的集合;可以是某個行或列;可以表示三維的跨多個工作表的單元格集合。此外,與其他對象不同,工作簿或工作表中不存在包含所有Range對象的Ranges集合。

1.4  iText組件

企業的一些信息通過網絡形成HTML報表,雖然IE可以直接打印顯示在其中的內容,但是從界面上來看,如果直接將HTML的顯示結果打印出來,顯的不夠美觀,如果將它轉換成PDF文件打印,則效果會好很多。

iText組件是開源項目,不僅可以生成PDF、RTF文件格式,而且可以將XML、HTML文件格式轉化爲PDF文件格式。下載地址是http://www.lowagie.com/iText/download.html,進入下載界面,如圖6.1所示。

圖6.1  iText類庫的下載鏈接

本書提供的iText組件版本是2.0.2,讀者可以自行下載最新版本的iText組件,“iText-2.0.2.jar”適用Windows操作系統,“iText-2.0.2.tar.gz”適用於Linux操作系統。下載iText-2.0.2.jar文件後,需要把itext-2.0.2.jar包放入項目目錄下的WEB-INF/lib路徑中,這樣在程序中就可以使用iText類庫了。如果生成的PDF文件中需要出現中文、日文、韓文字符,則需要訪問http://itext.sourceforge.net/downloads/iTextAsian.jar下載iTextAsian.jar包。當然,如果想真正瞭解iText組件,閱讀iText文檔顯得非常重要,讀者在下載類庫的同時,也可以下載類庫文檔。

用iText組件生成PDF文件需要以下5個步驟:

(1)建立com.lowagie.text.Document對象的實例。

Document document=new Document();

(2)建立一個書寫器(Writer)與document對象關聯,通過書寫器(Writer)可以將文檔寫入到磁盤中。

pdfWriter.getInstance(document, new FileOutputStream("Helloworld.PDF"));

(3)打開文檔。

document.open();

(4)向文檔添加內容。

document.add(new Paragraph("Hello World"));

(5)關閉文檔。

document.close();

下面筆者詳細介紹iText組件的屬性和用法。

(1)建立com.lowagie.text.Document對象的實例,該對象的構造方法有三個。

public Document();

public Document(Rectangle pageSize);  //定義頁面的大小

public Document(Rectangle pageSize,int marginLeft,int marginRight,int marginTop,int marginBottom);    /*定義頁面的大小,參數marginLeft、marginRight、marginTop、marginBottom分別爲左、右、上、下的頁邊距*/

通過Rectangle類對象的參數可以設定頁面大小、面背景色、以及頁面橫向/縱向等屬性。iText組件定義了A0-A10、AL、LETTER、HALFLETTER、_11x17、LEDGER、NOTE、B0-B5、ARCH_A-ARCH_E、FLSA和FLSE等紙張類型,也可以制定紙張大小來自定義,程序代碼如下:

Rectangle pageSize = new Rectangle(144,720);

在iText組件中,可以通過下面的代碼實現將PDF文檔設定成A4頁面大小, 當然,也通過Rectangle類中的rotate()方法可以將頁面設置成橫向。程序代碼如下:

Rectangle rectPageSize = new Rectangle(PageSize.A4);

//定義A4頁面大小

rectPageSize = rectPageSize.rotate();

//加上這句可以實現A4頁面的橫置

Document doc = new Document(rectPageSize,50,50,50,50);

//其餘4個參數,設置了頁面的4個邊距

(2)書寫器(Writer)對象。

一旦文檔(document)對象建立好之後,需要建立一個或多個書寫器與對象相關聯,通過書寫器可以將具體的文檔存盤成需要的格式,例如,om.lowagie.text.PDF.PDFWriter可以將文檔存成PDF格式,而com.lowagie.text.html.HTMLWriter可以將文檔存成HTML格式。

(3)設定文檔屬性。

在文檔打開之前,可以設定文檔的標題、主題、作者、關鍵字、裝訂方式、創建者、生產者、創建日期等屬性,調用的方法分別是:

public boolean addTitle(String title)

public boolean addSubject(String subject)

public boolean addKeywords(String keywords)

public boolean addAuthor(String author)

public boolean addCreator(String creator)

public boolean addProducer()

public boolean addCreationDate()

public boolean addHeader(String name, String content)

其中方法addHeader()對於PDF文檔無效,addHeader()方法僅對HTML文檔有效,用於添加文檔的頭信息。

當新的頁面產生之前,也可以設定頁面的大小、書籤、腳註(HeaderFooter)等信息,調用的方法是:

public boolean setPageSize(Rectangle pageSize)

public void setHeader(HeaderFooter header)

public void resetHeader()

public void setFooter(HeaderFooter footer)

public void resetFooter()

public void resetPageCount()

public void setPageCount(int pageN)  

如果要設定第一頁的頁面屬性,這些方法必須在文檔打開之前調用。

(4)文本處理。

iText組件中用文本塊(Chunk)、短語(Phrase)和段落(paragraph)處理文本。文本塊(Chunk)是處理文本的最小單位,有一串帶格式(包括字體、顏色、大小)的字符串組成。如以下代碼就是產生一個字體爲HELVETICA、大小爲12、帶下劃線的字符串:

Chunk chunk1 = new Chunk("This text is underlined",FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE));  

短語(Phrase)由一個或多個文本塊(Chunk)組成,短語(Phrase)也可以設定字體,但對於其中已經設定過字體的文本塊(Chunk)無效。通過短語(Phrase)成員函數add()可以將一個文本塊(Chunk)加到短語(Phrase)中,如phrase6.add(chunk)。

段落(paragraph)由一個或多個文本塊(Chunk)或短語(Phrase)組成,相當於Word文檔中的段落概念,同樣可以設定段落的字體大小、顏色等屬性。另外也可以設定段落的首行縮進、對齊方式(左對齊、右對齊、居中對齊)。

(5)中文處理。

爲了解決中文輸出的問題,需要多下載一個iTextAsian.jar組件。下載後放入項目目錄下的WEB-INF/lib路徑中。使用這個中文包無非是實例化一個字體類,把字體類應用到相應的文字中。可以正常顯示中文。

爲了輸出中文,可以通過以下代碼進行解決:

其中:“STSong-Light”定義了使用中文字體,“UniGB-UCS2-H”定義文字的編碼標準和樣式,GB代表編碼方式爲gb2312,H是代表橫排字,V代表豎排字。

BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

用這個中文的基礎字體實例化了一個字體類。

Font FontChinese = new Font(bfChinese, 12, Font.NORMAL);

將字體類用到了一個段落中。

Paragraph par = new Paragraph("世界您好",FontChinese)

將段落添加到了文檔中。

document.add(par);

(6)表格處理。

iText組件中處理表格的類爲:com.lowagie.text.Table和com.lowagie.text.PDF.PDFPTable,對於比較簡單的表格處理可以使用com.lowagie.text.Table,但是如果要處理複雜的表格,這裏就需要用到com.lowagie.text.PDF.PDFPTable進行處理。

下面簡要說明一下com.lowagie.text.Table類。類com.lowagie.text.Table的構造函數有3個:

Table(int columns)

Table(int columns, int rows)

Table(Properties attributes)

 參數columns、rows、attributes分別爲表格的列數、行數、表格屬性。創建表格時必須指定表格的列數,而對於行數可以不用指定。

 建立表格之後,可以設定表格的屬性,如邊框寬度、邊框顏色、襯距(padding space 即單元格之間的間距)大小等屬性。程序代碼如下:

Table table = new Table(3);//建立列數爲3的表格

table.setBorderWidth(1);//邊框寬度設置爲1

table.setBorderColor(new Color(0, 0, 255));//顏色爲藍色

table.setPadding(5);//表格邊距離爲5

table.setSpacing(5);

Cell cell = new Cell("header");//創建單元格作爲表頭

cell.setHeader(true);//表示該單元格作爲表頭信息顯示

cell.setColspan(3);//該單元格佔用3個列

table.addCell(cell);

table.endHeaders();//表頭添加完畢,必須調用此方法,否則跨頁時,表頭聯顯示

cell = new Cell("example cell with colspan 1 and rowspan 2");//添加一個一行兩列的單元格

cell.setRowspan(2);//向下佔用2行

cell.setBorderColor(new Color(255, 0, 0));

table.addCell(cell);

table.addCell("1.1");

table.addCell("2.1");

table.addCell("1.2");

table.addCell("2.2");

table.addCell("cell test1");

cell = new Cell("big cell");

cell.setRowspan(2);//向下佔用2行

cell.setColspan(2);//佔用2列

table.addCell(cell);

table.addCell("cell test2");

在表格中添加單元格時,按照自左向右,自上而下的順序添加,添加完如上代碼後,表格的右下方出現2行2列的空白,這是再向表格添加單元格時,先填滿這個空白,然後再另起一行,否則會出現異常。這裏需要補充說明的是iText組件的一個特點,iText組件出錯的時候,不會有任何提示,只會把出錯的部分跳過去,例如在沒有用中文字體的情況下輸出中文,中文部分的段落會是空白的。

iText組件中一個文檔(Document),可以有很多個表格,一個表格可以有很多個單元格,一個單元格里面可以放很多個段落,一個段落裏面可以放一些文字。但是,讀者必須明確以下兩點內容:

在iText組件中沒有行的概念,一個表格裏面直接放單元格,如果一個3列的表格中放進6個單元格的話,那麼就是兩行的表格。

如果一個3列的表格放入5個最基本的沒有任何跨列設置的單元格,表格會出錯,例如,面說的,表格根本添加不到文檔中,而且不會有任何提示。

下面來看如何使用com.lowagie.text.PdfPTable類來實現3行3列表格,通過PdfPTable類定義3列表格,並通過for語句循環輸出表格。程序代碼如下:

<%@ page

   import="Java.io.*,Java.awt.Color,com.lowagie.text.*,com.lowagie.text.pdf.*"%>

<%

   response.reset();

   response.setContentType("application/pdf");

   Document document = new Document();

   //設置表格的形式

   PdfPTable table = new PdfPTable(3);

   for (int i = 0; i < 9; i++) {

       PdfPCell cell = new PdfPCell();

       cell.addElement(new Paragraph(String.valueOf(i)));

       table.addCell(cell);

   }

%>

(7)圖像處理。

 iText組件中處理表格的類爲com.lowagie.text.Image,目前iText組件支持的圖像格式有:GIF, Jpeg, PNG, wmf等格式,對於不同的圖像格式,iText組件用同樣的構造函數自動識別圖像格式,通過下面的代碼分別獲得gif、jpg、png圖像的實例。

Image gif = Image.getInstance("vonnegut.gif");

Image jpeg = Image.getInstance("myKids.jpg");

Image png = Image.getInstance("hitchcock.png");

圖像的位置主要是指圖像在文檔中的對齊方式、圖像和文本的位置關係。iText組件中通過方法setAlignment(int alignment)進行處理,當參數alignment爲Image.RIGHT、Image.MIDDLE、Image.LEFT分別指右對齊、居中、左對齊;當參數alignment爲Image.TEXTWRAP、Image.UNDERLYING分別指文字繞圖形顯示、圖形作爲文字的背景顯示,也可以使這兩種參數結合使用以達到預期的效果,如setAlignment(Image.RIGHT|Image.TEXTWRAP)顯示的效果爲圖像右對齊,文字圍繞圖像顯示。

如果圖像在文檔中不按原尺寸顯示,可以通過下面的方法進行設定:

public void scaleAbsolute(int newWidth, int newHeight)

public void scalePercent(int percent)

public void scalePercent(int percentX, int percentY)

方法scaleAbsolute(int newWidth, int newHeight)直接設定顯示尺寸;方法scalePercent(int percent)設定顯示比例,如scalePercent(50)表示顯示的大小爲原尺寸的50%;而方法scalePercent(int percentX, int percentY)則圖像高寬的顯示比例。

如果圖像需要旋轉一定角度之後在文檔中顯示,可以通過方法setRotation(double r)設定,參數r爲弧度,如果旋轉角度爲30度,則參數r= Math.PI / 6。

(8)關於response.getOutputStream()拋出IllegalStateException異常。

response.reset();

response.setContentType("application/pdf");

DataOutput output = new DataOutputStream(response.getOutputStream());

拋出異常結果如下:

ERROR [Engine] StandardWrapperValve[jsp]: Servlet.service() for servlet jsp threw exceptionJava.lang.IllegalStateException: getOutputStream() has already been called for this response

造成上述異常的主要是Web容器生成的Servlet代碼中有out.write(""),這個和JSP中調用的response.getOutputStream()產生衝突,即Servlet規範說明,不能既調用response.getOutputStream(),又調用response.getWriter(),無論先調用哪一個,在調用第二個時候都會拋出IllegalStateException異常,因爲在JSP中,out變量是通過response.getWriter()方法得到的,在程序中既用了response.getOutputStream,又用了out變量,故出現以上錯誤。

解決方案,程序中添加程序代碼如下即可:

out.clear();

out=pageContext.pushBody();

1.5  POI組件

POI組件適合把Web報表或數據庫中的值直接傳入Excel中進行描述,同時可以做打印操作,POI組件的主頁是http://Jakarta.apache.org/poi/hssf/index.html,也可以通過http://www.apache.org/dyn/closer.cgi/jakarta/poi/網址進行下載,本書採用的POI組件的版本是poi-bin-3.0-FINAL-20070503.zip,讀者可以自行下載最高版本。解壓縮*.zip文件,把3個jar包放入項目目錄下的WEB-INF/lib路徑中即可使用POI組件。雖然POI組件在某些細節有些小Bug並且不支持寫入圖片,但其他方面還是不錯的。

POI項目實現的Excel文件格式稱爲HSSF,它是Horrible SpreadSheet Format的縮寫,即“討厭的電子表格格式”。通過HSSF,可以使用純Java代碼讀取、寫入、修改Excel文件。

先來看POI組件基本屬性,以下可能需要使用到如下的類:

import org.apache.poi.hssf.usermodel.HSSFCell;

import org.apache.poi.hssf.usermodel.HSSFCellStyle;

import org.apache.poi.hssf.usermodel.HSSFDataFormat;

import org.apache.poi.hssf.usermodel.HSSFFont;

import org.apache.poi.hssf.usermodel.HSSFRow;

import org.apache.poi.hssf.usermodel.HSSFSheet;

import org.apache.poi.hssf.usermodel.HSSFWorkbook;

import org.apache.poi.hssf.util.HSSFColor;

(1)創建workbook(工作簿)。

HSSFWorkbook wb = new HSSFWorkbook();//使用默認的構造方法創建workbook

FileOutputStream fileOut = new FileOutputStream("workbook.xls");//指定文件名

wb.write(fileOut);//輸出到文件

fileOut.close();

(2)創建一個sheet(工作表)。

HSSFWorkbook wb = new HSSFWorkbook();

HSSFSheet sheet1 = wb.createSheet("new sheet");//workbook創建sheet

HSSFSheet sheet2 = wb.createSheet("second sheet");//workbook創建另外的sheet

FileOutputStream fileOut = new FileOutputStream("workbook.xls");

wb.write(fileOut);

fileOut.close();

(3)創建cells(單元格)。

HSSFWorkbook wb = new HSSFWorkbook();

HSSFSheet sheet = wb.createSheet("new sheet");//注意以下的代碼很多方法的參數是short 而不是int 所以需要做一次類型轉換

HSSFRow row = sheet.createRow((short)0);//sheet 創建一行

HSSFCell cell = row.createCell((short)0);//行創建一個單元格

cell.setCellValue(1);//設定單元格的值

row.createCell((short)1).setCellValue(1.2); //值的類型參數有多種double ,String ,boolean,

row.createCell((short)2).setCellValue("This is a string");

row.createCell((short)3).setCellValue(true);// Write the output to a file

FileOutputStream fileOut = new FileOutputStream("workbook.xls");

wb.write(fileOut);

fileOut.close();

(4)建日期cells。

HSSFWorkbook wb = new HSSFWorkbook();

HSSFSheet sheet = wb.createSheet("new sheet");

HSSFRow row = sheet.createRow((short)0);

HSSFCell cell = row.createCell((short)0);//設定值爲日期
cell.setCellValue(new Date());

HSSFCellStyle cellStyle = wb.createCellStyle();//指定日期顯示格式

cellStyle.setDataFormat(HSSFDataFormat.getBuiltinFormat ("m/d/yy h:mm"));

cell = row.createCell((short)1);

cell.setCellValue(new Date());//設定單元格日期顯示格式

cell.setCellStyle(cellStyle);

FileOutputStream fileOut = new FileOutputStream("workbook.xls");

wb.write(fileOut);

fileOut.close();

特別地,值得注意的是使用HSSF處理日期數據要小心。Excel內部以數值的形式保存日期數據,區別日期數據的惟一辦法是通過單元格的格式。對於包含日期數據的單元格,cell.getCellType()將返回HSSFCell.CELL_TYPE_NUMERIC,不過利用工具方法HSSFDateUtil.isCellDateFormatted(cell)可以判斷出單元格的值是否爲日期。

也可以設置單元格樣式,首先創建一個樣式對象,然後把它指定給一個單元格,或者指定給具有相同樣式的單元格。

HSSFCellStyle style = wb.createCellStyle();

style.setDataFormat(HSSFDataFormat.getBuiltinFormat("($#,##0_);[Red]($#,##0)"));

style.setFillBackgroundColor(HSSFColor.AQUA.index);

style.setFillPattern(HSSFCellStyle.BIG_SPOTS);

cell.setCellStyle(style);

當然,也可以在POI組件較新的版本中使用公式,例如:

HSSFCell cell2=row.createCell((short)4);

cell2.setCellFormula("SUM(B1:B2)");

這樣,E1中的值爲B1和B2的加和。

設定單元格格式,單元格格式的設定有很多形式包括單元格的對齊方式,內容的字體設置,單元格的背景色等。

HSSFCellStyle style = wb.createCellStyle();//創建一個樣式

style.setFillBackgroundColor(HSSFCellStyle.AQUA);//設定此樣式的的背景顏色填充

style.setFillPattern(HSSFCellStyle.BIG_SPOTS);//樣式的填充類型。

//有多種式樣如:

//HSSFCellStyle.BIG_SPOTS

//HSSFCellStyle.FINE_DOTS

//HSSFCellStyle.SPARSE_DOTS等

style.setAlignment(HSSFCellStyle.ALIGN_CENTER );//居中對齊

style.setFillBackgroundColor(HSSFColor.GREEN.index);//設定單元個背景顏色

style.setFillForegroundColor(HSSFColor.RED.index);//設置單元格顯示顏色

style.setBorderBottom(HSSFCellStyle.BORDER_THIN);//帶邊框

HSSFCell cell = row.createCell((short) 1);

cell.setCellValue("X");

cell.setCellStyle(style);

行高、列寬設置:

HSSFWorkbook wb = new HSSFWorkbook();

HSSFSheet sheet = wb.createSheet("new sheet");

HSSFRow row = sheet.createRow((short)0);

//設置到第10行

row.setRowNum (10);

//3是列號,4是列寬值

sheet.setColumnWidth(3, 4);

HSSF爲讀取操作提供了兩類API:usermodel和eventusermodel,即“用戶模型”和“事件-用戶模型”。前者很好理解,後者比較抽象,但操作效率要高得多。usermodel主要有org.apache.poi.hssf.usermodel和org.apache.poi.hssf.eventusermodel包實現(在HSSF的早期版本中,org.apache.poi.hssf.eventusermodel屬於eventmodel包)。

usermodel包把Excel文件映射成熟悉的結構,諸如Workbook、Sheet、Row、Cell等,它把整個結構以一組對象的形式保存在內存之中。eventusermodel模式要求用戶熟悉文件格式的底層結構,另外,eventusermodel的API只提供讀取文件的功能,也就是說不能用這個API來修改文件。

(1)通過usermodel讀取文件。

用HSSF的usermodel讀取文件很簡單。首先創建一個InputStream,然後創建一個HSSFWorkbook:

InputStream myxls = new FileInputStream("workbook.xls"));

HSSFWorkbook wb   = new HSSFWorkbook(myxls);

有了HSSFWorkbook實例,接下來就可以提取工作表、工作表的行和列,例如:

HSSFSheet sheet = wb.getSheetAt(0);       // 第一個工作表

HSSFRow row     = sheet.getRow(2);        // 第三行

HSSFCell cell   = row.getCell((short)3);  // 第四個單元格

上面這段代碼提取出第一個工作表第三行第四單元格。利用單元格對象可以獲得它的值,提取單元格的值時請注意它的類型:

if (cell.getCellType() == HSSFCell.CELL_TYPE_STRING) {

 System.out.println("單元格是字符串,值是: " + cell.getStringCellValue());

} else if (cell.getCellType() == HSSFCell.CELL_TYPE_NUMERIC) {

System.out.println("單元格是數字,值是: " + cell.getNumbericCellValue());

} else  {

System.out.println("單元格的值不是字符串或數值。");

}

如果搞錯了數據類型,程序將遇到異常。

(2)通過usermodel寫入文件。

寫入Excel文件比讀取Excel文件還要簡單。創建一個HSSFWorkbook實例,然後在適當的時候創建一個把文件寫入磁盤的OutputStream:

HSSFWorkbook wb = new HSSFWorkbook();

FileOutputStream fileOut= new FileOutputStream("workbook.xls");

wb.write(fileOut);

fileOut.close();

創建工作表及其內容必須從相應的父對象出發,例如:

HSSFSheet sheet = wb.createSheet();

HSSFRow row = sheet.createRow((short)0);

HSSFCell cell  = row.createCell((short)0);

cell.setCellValue(1);

row.createCell((short)1).setCellValue(1.2);

row.createCell((short)2).setCellValue("一個字符串");

row.createCell((short)3).setCellValue(true);

(3)通過HPSF讀取文檔屬性。

讀取文檔屬性其實並不複雜,因爲Java程序可以利用POI項目的HPSF包。HPSF是 Horrible Property Set Format的縮寫,譯成中文就是“討厭的屬性集格式”。HPSF包是POI項目實現的讀取屬性工具,目前還不支持屬性寫入。

在Microsoft Word、Excel、PowerPoint等軟件中,用戶可以通過“文件”→“屬性”菜單爲文檔添加附加信息,包括文檔的標題、主題、摘要、類別、關鍵詞等,同時應用軟件本身還會加入最後訪問的用戶、最後訪問和修改/打印的日期時間等信息。

文檔的屬性和正文是分開保存的。如前所述,文件內部就像是一個容器,裏面包含許多類似目錄和文件的結構,而POIFS就是用來訪問其中的文件的工具。這些文件也稱爲流,文檔的屬性就保存在POIFS文件系統中專用的流裏面。以一個Word文檔爲例,雖然在資源管理器中只看到一個叫做MyFile.doc的文檔,其實在這個文檔的內部,又包含了一個WordDocument、一個SummaryInformation和一個DocumentSummaryInformation文檔;通常還會有其他的文檔,這裏暫且不管。

WordDocument包含了在Word裏面編輯的文本,文檔的屬性保存在SummaryInformation和DocumentSummaryInformation流裏面。也許將所有屬性保存在單個文檔裏面看起來太簡單了,所以Microsoft決心要使用兩個流,爲了使事情更復雜一點,這兩個流的名字前面還加上了八進制的/005字符——這是一個不可打印的字符,因此前面就把它省略了。

Microsoft定義的標準屬性有一個好處,它們並不在乎主文檔到底是什麼類型——不管是Word文檔、Excel工作簿還是PowerPoint幻燈。只要知道如何讀取Excel文檔的屬性,就知道了如何讀取其他文檔的屬性。

對於讀取Microsoft定義的標準屬性,通過HPSF提供的API可以很方便地辦到,本文只介紹讀取標準屬性的簡單API,因爲對大多數應用程序來說這已經完全足夠了。請看代碼:

public class ReadTitle{

   public static void main(String[] args) throws IOException{

   final String filename = args[0];

   POIFSReader r         = new POIFSReader();

   r.registerListener(new MyPOIFSReaderListener(),"/005SummaryInformation");

   r.read(new FileInputStream(filename));

   }

static class MyPOIFSReaderListener implements POIFSReaderListener{

   public void processPOIFSReaderEvent(POIFSReaderEvent event){

          SummaryInformation si = null;

          try{

                            si=(SummaryInformation)PropertySetFactory.create(event.getStream());

          }

          catch (Exception ex){

                 throw new RuntimeException

          ("屬性集流/"" + event.getPath() +event.getName() + "/": " + ex);

          }

          final String title = si.getTitle();

          if (title != null)

       System.out.println("標題: /"" + title + "/"");

       else

       System.out.println("該文檔沒有標題.");

       }

   }

}

main()方法利用POIFS的事件系統從命令行指定的OLE 2文檔讀取名爲/005SummaryInformation的流,當POIFSReader 遇到這個流時,它把控制傳遞給MyPOIFSReaderListener的processPOIFSReaderEvent()方法。

processPOIFSReaderEvent()通過參數獲得一個輸入流,該輸入流包含了文檔標題等屬性。爲了訪問文檔的屬性,從輸入流創建一個PropertySet實例。

si = (SummaryInformation) PropertySetFactory.create(event.getStream());

event.getStream()從POIFSReader傳入的POIFSReaderEvent獲得輸入流。

以剛纔獲得的輸入流爲參數,調用PropertySetFactory的靜態方法create()。正如其名字所暗示的,PropertySetFactory是一個工廠類,此類有一臺“機器”能夠把一個輸入流轉換成一個PropertySet實例,這臺機器就是create()方法。

 將create()方法返回的PropertySet定型(cast)成爲SummaryInformation。PropertySet提供了按照一般辦法讀取屬性集的各種機制,SummaryInformation類是PropertySet的子類,即SummaryInformation類在PropertySet類的基礎上增加了操作Microsoft標準屬性的便捷方法。

在這個處理過程中,可能引起錯誤的因素很多,因此把這部分內容放入了一個try塊——不過這個示例程序只按照最簡單的方式處理了異常,在實際應用中,最好能夠對可能出現的不同異常類型分別處理。除了一般的I/O異常之外,還有可能遇到HPSF特有的異常,例如,如果輸入流不包含屬性集或屬性集非法,就會拋出NoPropertySetStreamException異常。

有一種錯誤不太常見,但也不是絕無可能——/005SummaryInformation包含一個合法的屬性集,但並不是摘要信息屬性集。如果出現這種情況,則定型成SummaryInformation操作會失敗,引發ClassCastException異常。

獲得SummaryInformation實例之後,剩下的事情就很簡單了,只要調用getTitle()方法,然後輸出結果。

除了getTitle()之外,SummaryInformation還包含其他一些便捷方法,例如getApplicationName()、getAuthor()、getCharCount()、和getCreateDateTime()等。HPSF的JavaDoc文檔詳細說明了所有這些方法。

(4)讀取文檔摘要信息。

並非所有的屬性都保存在摘要信息屬性集之中。許多(但不是全部)OLE 2文件還有另一個屬性集,稱爲“文檔摘要信息”,對應的流是/005DocumentSummaryInformation。這個屬性集保存的屬性包括文檔的類別、PowerPoint幻燈的多媒體剪輯數量等。

需要訪問文檔摘要信息屬性集,程序的處理過程也與上例相似,只是註冊的目標應該改成/005DocumentSummaryInformation流,有時,可能想要同時註冊到摘要信息和文檔摘要信息這兩個流。這裏的處理方式和前面的例子差不多,應該把包含文檔摘要信息的流傳遞給PropertySetFactory.create(),但這次工廠方法將返回一個DocumentSummaryInformation對象(而不是前面例子中的SummaryInformation對象)。如果同時註冊到了兩個流,注意檢查返回值的具體類型,或者使用Java的instanceof操作符,或者使用專用的isSummaryInformation()和isDocumentSummaryInformation()方法。記住,create()方法返回的總是一個PropertySet對象,因此總是可以對create()返回對象調用isSummaryInformation()和isDocumentSummaryInformation()方法。

1.6  iReport和JasperReport組件

iReport和JasperReport組件是完全的開源項目,是當今世面上比較流行的製作報表工具,它們的優勢不僅僅因爲是開源項目,還由於高性能,友好的人性化設計界面,使得報表變得不再千篇一律,適用於多種數據源,可以導出多種文件格式,例如HTML、PDF、Excel等文件格式。

iReport和JasperReport組件最主要能在設計時使數據和設計分開,實現Web報表的分頁打印,分組合計,變量加減處理,輸出格式化,用戶須按照編寫的規則編寫一個XML,然後得到用戶所要的報表文件。

IReport組件下載地址是http://ireport.sourceforge.net,本書提供的版本是iReport-2.0.0,讀者可自行下載最新版本,下載後安裝,目錄中會有一個名爲"iReport.bat"的批處理文件,雙擊運行它,如圖6.2所示。

圖6.2  iReport for JasperReport

若在JSP中使用iReport製作的報表需要另一個組件支持,這個組件就是JasperReport組件。

 JasperReport下載地址是http://jasperreports.sourceforge.net ,JasperReport是一個靈活、功能強大的報表產生工具,可以以PDF、HTML或XML等多種形式產生報表,並支持CSV、XLS等格式報表,該引擎由Java編寫,支持多種形式應用程序產生動態報表。JasperReport是按照一個預定義的XML文檔來組織報表的數據,這些數據來源多樣,包括關係型數據庫、Java容器對象等。

首先簡要介紹一下iReport組件的用法。

(1) 單擊New Document創建一個新報表(也可以選Report Wizard報表嚮導來生成報表),也可以單擊圖標,來新建報表。

添寫報表屬性,在“報表名稱”輸入報表名字,在"預設尺寸"區內選擇所要用的紙張及尺寸,在這裏選擇默認參數,可以修改"i18n"選項卡中的“XML 編碼”,默認參數爲"UTF-8"(如果認爲有必要可以手動輸入"GB2312"),如圖6.3所示,然後單擊OK按鈕。

圖6.3  iReport創建新報表

(2)設置數據源。

首先把SQL Server 2000連接Java的驅動包放入iReport組件所在目錄的lib中,這樣iReport組件纔可以使用數據源,單擊菜單"Data",選中"連接/資料來源",單擊"New"設置數據源,彈出對話框,如圖6.4所示。

圖6.4  iReport設置數據源

設置連接屬性,其中有JavaBean、XML、JDBC等數據源,在這裏選擇JDBC數據源,輸入數據源名稱"Name",可以任意輸入名字。在"JDBC Driver "下拉列表框中選擇數據庫連接驅動,選擇Java連接SQL Server 2000驅動,連接JDBC的URL,。在"Server Address"輸入框中輸入服務器地址。在"DataBase"輸入框中填寫數據庫名字。以及填上登錄數據庫的用戶名"UserName"和密碼"Password",然後單擊密碼輸入框中邊上的"Save Password"保存密碼,如果不保存,每次執行報表時都會彈出要求輸入連接數據庫的用戶名密碼的對話框。設置數據源如圖6.5所示。

圖6.5  iReport設置數據源

 單擊"Test"按鈕,如果測試成功後會彈出如圖6.6對話框, 否則就會彈出連接錯誤對話框,這時就要檢查的設置參數是否正確。

圖6.6  測試成功對話框

(3)iReport的中文處理。

iReport中文處理與iText組件相同,需要一個亞洲語言包"iTextAsian.jar"放到iReport目錄下的lib目錄中;修改報表的"PDF Font Name"將其改爲"STSong-Light",再則是修改"PDF Embedded PDF Encoding" 改爲"UniGB-UCS2-H(Chinese Simplified)" ,這樣就可以解決iReport的中文問題。      

(4)報表編譯時產生NoClassDefFoundException異常。

在代碼處理JasperReport時出現該異常,是因爲在引用JasperReport的一些jar文件不完整,處理方式是將JasperReport目錄下的Demo/samples/Webapp/WEB-INF/lib/所有的jar文件,全引用了,以防不測,但會有一些不必要的包被引用了,讀者可以自己將不必要的jar包去掉。

(5)另存爲PDF時出現UnisupportEncodingException異常。

這是因爲沒有改變"PDF Font Name"應改爲"STSong-Light"所致。

(6)iReport把xml文件編譯成jasper文件。

單擊圖標,進行編譯,把*.jrxml編譯成*.jasper文件,同時顯示報表內容,但有一點需要說明,如果在JSP中使用*.jasper時,手動編譯出的*.jasper不能應用到JSP中,需要使用JasperReport類庫中的JasperCompileManager類中的compileReportToFile()靜態方法實現編譯,如下述代碼所示。

JasperCompileManager.compileReportToFile(*.jrxml,*.jasper)

(7)設置iReport的輸出格式。

在前面曾提到過iReport可以以多種格式進行輸出,如PDF,HTML,XML,XLS,CVS等文件格式,選擇iReport菜單欄上的“建立”,可以看到缺省格式是“JRViewer”預覽,這是iReport自身帶的PDF格式預覽,讀者可以根據自己的需要選擇報表輸出格式,選擇其他格式的預覽,系統會以這種格式保存到磁盤中。保存位置讀者也可以選擇,在iReport菜單欄中選擇Options,在其中選擇Compiler標籤,選擇編譯好的文件以及各種形式的報表保存位置,如圖6.7所示。

圖6.7  iReport設置報表保存位置

(8)使用SQL語句查詢。

大家都知道,數據查詢必須要有查詢語句,特別是綜合查詢時可能SQL語句會複雜一些, iReport組件可以使用查詢語句輸出報表,在菜單"Data"下選擇“報表查詢”項,添入查詢語句,如圖6.8所示。

圖6.8  iReport組件使用sql語句

單擊"Save query"生成SQL腳本存入磁盤。如果需要在SQL語句中使用參數,例如以“名稱”進行模糊查詢,傳遞的參數爲name,那麼期望的SQL語句可能是下面這個樣子。

Select * from users where name like ‘%name%’

其實在iReport組件中也可以很容易實現, Select * from users where name like '% $P{name}%’ ,$P{name}是接下來要說明的參數。

(9)在iReport中設置參數

添加參數,讀者可以右擊Document下的Parameters,單擊"Add",選擇"Parameter",打開“添加參數”對話框,如圖6.9所示。

圖6.9  iReport添加參數

添加參數名稱,選擇參數類型,設置好後,單擊"OK"按鈕,如果想在JSP中爲名爲"name"的參數賦值,需要引用下面的程序代碼:

Map parameters=new HashMap();

parameter.put("name","p");

(10)報表的動態對象變量、參數、字段。

在使用iReport的過程中會碰到很多與變量(Variables)、參數(Parameters)、字段(Fields)有關的內容,現在介紹這些對象的使用和意義。

字段(Fields):是數據庫抽取出來的,希望在報表中出現的數據庫內容。例如一個ID的所有值爲$F{ID}。

參數(Parameters):這是給報表的提供入口,例如希望在報表被解釋的時候提供where語句的條件值,那麼就可以使用參數(Parameters),$P{ parameterName }。

變量(Variables):這是報表中一些邏輯運算的表現,例如統計值,$V{ variablesName }。

每種對象的定義格式如每個對象的後面說明。

1.7  Java Excel組件

Java Excel組件是專門製作Excel報表的開源組件,通過Java Excel組件Java開發人員可以讀取Excel文件的內容、創建新的Excel文件、更新已經存在的Excel文件。由於Java Excel組件是使用Java編寫的,所以在Web應用中可以通過JSP、Servlet來調用API實現對Excel數據表的訪問。

獲得Java Excel開源包(jxl.jar)可以到http://www.andykhan.com/jexcelapi/download.html下載最新版本。解壓縮,將jxl.jar複製到項目的WEB-INF/lib中即可使用Java Excel組件。

Java Excel 提供以下功能:

從Excel 95、97、2000等格式的文件中讀取數據;讀取Excel公式;生成Excel數據表;支持字體、數字、日期的格式化;支持單元格的陰影操作,以及顏色操作;修改已經存在的數據表。

如果想了解Java Excel組件,首先要了解Java Excel API,下面簡單介紹Java Excel API中常用類提供的方法。

(1)Workbook類提供的方法。

getNumberOfSheet():返回值類型爲int型,用來獲得工作簿(workbook)中工作表(sheet)的個數。

getSheet(int index)和getSheet(String name):返回值類型爲int型,分別通過工作表下標和名稱。

getSheets():返回值類型爲Sheet[]型,用來獲得工作簿中所有工作表的名稱。

(2)Sheet類提供的方法。

getname():返回值類型爲String型,用來獲得當前工作表名稱。

getRows():返回值類型爲int型,用來獲得當前工作表的記錄數。

getColumns():返回值類型爲int型,用來獲得當前工作表的字段數。

getCell(int column,int row):返回值類型Cell類型,用來獲得當前工作表指定的單元格,需要注意的是第一參數爲列,第二個參數爲行。

getRow(int row):返回值類型爲Cell[]型,用來獲得當前工作表制定列的所有單元格。

getColumn(int column):返回值類型爲Cell[]型,用來獲得當前工作表指定列的所有單元格。

(3)Cell類提供方法。

getRow():返回值類型爲int型,用來獲得當前單元格所在行。

getColumn():返回值類型爲int型,用來獲得當前單元格所在列。

getType():返回值類型爲CellType型,用來獲得當前單元格值的類型。

getContents():返回值類型爲String型,用來獲得當前單元格的值。

getCellFormat():返回值類型爲CellFormat型,用來格式化單元格內容。

下面簡要介紹一下Java Excel的基本屬性:

(1)從Excel文件讀取數據表。

Java Excel既可以從本地系統文件(.xls)讀取Excel數據表,也可以從輸入流中讀取Excel數據表。

首先創建Workbook(工作簿),程序代碼如下:

import Java.io.*;

import jxl.*;

...//非關鍵代碼省略

try{

//構建只讀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(0,1);//獲取第二行,第一列的值

String strc10=c10.getContents();

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

String strc10=c10.getContents();

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

String strc01 = c01.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());

getCell(x,y)中的x代表列,y代表行。在得到Cell對象後,通過getType()方法可以獲得該單元格的類型,然後與API提供的基本類型相匹配,強制轉換成相應的類型,最後調用相應的取值方法getXXX(),就可以得到確定類型的值。

當完成對Excel電子表格數據的處理後,一定要使用close()方法來關閉先前創建的對象,以釋放讀取數據表的過程中所佔用的內存空間,在讀取大量數據時顯得尤爲重要。程序代碼如下:

rwb.close();//操作完成時,關閉對象,釋放佔用的內存空間

(2)生成新的Excel工作簿。

與讀取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();

}

Java Excel爲寫入文件提供了兩種方式,第一種是生成本地文件,如果文件名不帶絕對路徑的話,缺省文件會定位在相對目錄,如果文件名帶有絕對路徑的話,則生成的Excel文件會定位在相應目錄;另一種是將Excel對象直接寫入到輸入流中,例如,用戶通過瀏覽器來訪問Web服務器,如果HTTP頭設置正確的話,瀏覽器自動調用客戶端的Excel應用程序,來動態顯示生成的Excel表格。

接下來就是要創建工作表,創建工作表的方法與創建工作簿的方法幾乎相同,同樣是通過工廠模式方法獲得相應的對象,該方法需要兩個參數,一個是工作表的名稱,另一個是工作表在工作簿中的位置,參考下面的代碼片段:

jxl.write.WritableSheet ws = wwb.createSheet("Test Sheet 1", 0);//創建Excel工作表

現在只需要實例化API所提供的Excel基本數據類型,將它添加到工作表中就可以。程序代碼如下:

jxl.write.Label labelC = new jxl.write.Label(0, 0, "This is a Label cell");

ws.addCell(labelC);//添加label對象

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.Number labelN = new jxl.write.Number(0, 1, 3.1415926);

ws.addCell(labelN);//添加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); //添加帶有formatting的Number對象

jxl.write.Boolean labelB = new jxl.write.Boolean(0, 2, false);

ws.addCell(labelB); //添加Boolean對象

jxl.write.DateTime labelDT = new jxl.write.DateTime(0, 3, new Java.util.Date());

ws.addCell(labelDT);//添加DateTime對象

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);//添加帶有formatting的DataFormat對象

*注意:在構造單元格時,單元格在工作表中的位置已經確定了,一旦建立後,單元格位置是不可變更的,儘管單元格內容是可以改變的。

寫入Excel工作表,程序代碼如下:

wwb.write();

最後,不要忘記關閉Excel工作簿對象:

wb.close();//關閉工作簿對象

在關閉Excel對象時必須先調用write()方法,因爲之前的操作都是存儲在緩存中的,所以要通過write()方法將操作的內容寫入Excel文件中。如果先關閉了Excel對象,那麼Excel文件將什麼都沒有。

(3)拷貝、更新Excel工作簿

下面介紹如何更新一個已經存在的工作簿,主要分兩個步驟,第一:構造只讀的Excel工作簿,第二:利用已經創建的Excel工作簿創建新的可寫入的Excel工作簿,當然這兩個實例都是打開相同Excel文件,只是給予的權限不同,程序代碼如下:

jxl.Workbook rw = jxl.Workbook.getWorkbook(new File(sourcefile));//創建只讀的Excel工作簿的對象

jxl.write.WritableWorkbook wwb = Workbook.createWorkbook(new File(targetfile), rw);//創建可以寫入的Excel工作簿對象

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

}//判斷單元格的類型,做出相應的轉化

wwb.write();//寫入Excel對象

wwb.close();//關閉可寫入的Excel對象

rw.close();//關閉只讀的Excel對象

之所以使用這種方式構建Excel對象,完全是因爲效率的原因,爲了提高性能,在讀取工作表時,與數據相關的一些輸出信息,所有的格式信息,如字體、顏色等等,是不被處理的,因爲目的是獲得行數據的值,既使沒有了修飾,也不會對行數據的值產生什麼影響。唯一的不利之處就是在內存中會同時保存兩個同樣的工作表,這樣當工作表體積比較大時,會佔用相當大的內存,但現在好像內存的大小並不是什麼關鍵因素了。

一旦獲得了可寫入的工作表對象,就可以對單元格對象進行更新的操作了,在這裏不必調用API提供的add()方法,因爲單元格已經存在於工作表當中,所以只需要調用相應的setXXX()方法,就可以完成更新的操作了。

儘管單元格原有的格式化修飾是不能去掉的,還是可以將新的單元格修飾加上去,以使單元格的內容以不同的形式表現。

新生成的工作表對象是可寫入的,除了更新原有的單元格外,還可以添加新的單元格到工作表中。最後,不要忘記調用write()方法,將更新的內容寫入到文件中,然後關閉工作簿對象,這裏有兩個工作簿對象要關閉,一個是隻讀的,另外一個是可寫入的。

發佈了23 篇原創文章 · 獲贊 2 · 訪問量 6萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章