【正文】 一、 JavaReport介紹　　JavaReport主要有如下優(yōu)點(diǎn)?！　。?）支持實(shí)時(shí)的、動(dòng)態(tài)的Web統(tǒng)計(jì)報(bào)表　　JavaReport所展示的報(bào)表是動(dòng)態(tài)的報(bào)表。所有的數(shù)據(jù)都是實(shí)時(shí)的數(shù)據(jù)；所有的統(tǒng)計(jì)圖也是動(dòng)態(tài)生成的。報(bào)表里面的數(shù)據(jù)源可從數(shù)據(jù)庫(kù)中即時(shí)查詢產(chǎn)生，適合于對(duì)實(shí)時(shí)統(tǒng)計(jì)要求高的應(yīng)用系統(tǒng)。　?。?）接口豐富，對(duì)圖表提供良好的支持　　JavaReport提供了豐富的應(yīng)用程序接口、減少代碼復(fù)用、靈活的圖表形式、即時(shí)圖表生成、更短的生成時(shí)間等。Java報(bào)表對(duì)圖表有良好的支持，可以生成柱圖、餅圖和折線圖等十幾種圖表?！　。?）報(bào)表可導(dǎo)出成各種格式的文檔　　JavaReport在報(bào)表展現(xiàn)方面表現(xiàn)優(yōu)異，能實(shí)現(xiàn)Word，Excel，PDF，CSV等格式精確導(dǎo)出等功能，并提供了全部的頁(yè)面與打印控制?！　。?）開發(fā)簡(jiǎn)便，程序員只須編寫少量程序代碼　　有許多的問題在JavaReport組件內(nèi)已經(jīng)解決，如報(bào)表的導(dǎo)出功能、打印功能和數(shù)據(jù)的分頁(yè)處理等。在很多B/S結(jié)構(gòu)體系的系統(tǒng)開發(fā)時(shí)，分頁(yè)是開發(fā)過程中要重點(diǎn)考慮的問題。但在JavaReport中，就不需要考慮上下翻頁(yè)，跨頁(yè)分頁(yè)，因?yàn)檫@些問題報(bào)表引擎已經(jīng)實(shí)現(xiàn)了。在設(shè)計(jì)報(bào)表的過程中，把Report類當(dāng)作容器類，統(tǒng)計(jì)圖類，表格類，標(biāo)簽類，圖片類等，把它們當(dāng)作組件類。至于跨頁(yè)分頁(yè)，上下翻頁(yè)由報(bào)表引擎自動(dòng)完成。JavaReport系統(tǒng)中有自動(dòng)跨頁(yè)分頁(yè)的功能，當(dāng)表格超過當(dāng)前頁(yè)的大小時(shí)，系統(tǒng)會(huì)自動(dòng)把接著部分放到下一頁(yè)。報(bào)表設(shè)計(jì)在開發(fā)過程中是感覺不到要跨頁(yè)的存在，只有一個(gè)全部數(shù)據(jù)完整的表格對(duì)象?！　∪绻岩雸D片文件加入到報(bào)表中，可使用報(bào)表系統(tǒng)的Report類，通過這個(gè)類的addImage()方法把Image對(duì)象加進(jìn)來，如果需要自定義圖像，可通過第三方畫圖程序（例如是JFreeChart程序）生產(chǎn)需要的統(tǒng)計(jì)圖/圖片，然后再把圖像加到報(bào)表中去?！　?，JavaReport根據(jù)客戶的應(yīng)用需要，按照功能和性能的等級(jí)，分成三個(gè)版本：專業(yè)版，服務(wù)器版，企業(yè)版。本書使用企業(yè)版。　　JavaReport三個(gè)版本產(chǎn)品都是免費(fèi)使用的。也就是說這三個(gè)版本都不需要購(gòu)買License許可，可以自由使用JavaReport的所有功能。免費(fèi)提供報(bào)表在Web展示功能，表和圖怎樣混合功能，跨頁(yè)分頁(yè)功能，導(dǎo)出電子文檔Word，PDF，Excel，CSV，HTML等諸多功能。　　專業(yè)版客戶（Client）的IP最大連接數(shù)限制為10個(gè)，也就是JavaReport同時(shí)并行處理線程的最大數(shù)受限制。限制是為了避免系統(tǒng)資源占用過大，使系統(tǒng)反應(yīng)遲鈍。該版本適合中小型的應(yīng)用系統(tǒng)，保障應(yīng)用系統(tǒng)正常運(yùn)行。服務(wù)器版在最大連接數(shù)沒有受限，它能充分發(fā)揮服務(wù)器的個(gè)部分硬件設(shè)備的作用；相對(duì)要求服務(wù)器的設(shè)備配置高，保障最優(yōu)性能效率。該版本適合大中型的應(yīng)用系統(tǒng)使用?！　∑髽I(yè)版提供垃圾回收機(jī)制管理，自動(dòng)處理在內(nèi)存中無(wú)用對(duì)象的引用；支持多服務(wù)器處理模式，提供在多個(gè)服務(wù)器的集群功能和服務(wù)器之間負(fù)載均衡功能。提高服務(wù)器群的負(fù)載能力和和快速響應(yīng)能力。該版本適合負(fù)載繁重的應(yīng)用系統(tǒng)使用?！　《?、 安裝JavaReport　　，把這個(gè)文件的路徑加入到classpath系統(tǒng)變量中，或拷貝到當(dāng)前Web應(yīng)用的WEBINF\lib目錄下，或拷貝到Tomcat5的安裝目錄的mon\lib目錄中；第一種方法和第三種方法對(duì)所有Web應(yīng)用有效，而第二種方法僅對(duì)當(dāng)前Web應(yīng)用有效。好了，至此，JavaReport就算安裝完畢了。接下來，繼續(xù)介紹JavaReport?！　∪?、 相關(guān)類介紹　　下面給出Web報(bào)表顯示時(shí)的情況，如圖1711所示?！　≡谶@個(gè)圖中，對(duì)報(bào)表的顯示情況一目了然，再介紹常用的類理解起來就會(huì)比較清晰了。JavaReport的組件包中有許多的類，體系龐大而復(fù)雜，在這里無(wú)法一一介紹，僅列出一些常用的類來作出說明，有興趣的可參考詳細(xì)的API手冊(cè)?！　。?）WebReportEngine類　　，這個(gè)類是整個(gè)JavaReport中的Web引擎的開發(fā)接口。所有的JSP或Servlet從這個(gè)類繼承下來，覆蓋createReport（）函數(shù)就實(shí)現(xiàn)基本的報(bào)表開發(fā)工作?！　ebReportEngine是JavaReport的Servlet或JSP的開發(fā)接口，是JSP或Servlet的父類，報(bào)表系統(tǒng)在應(yīng)用中的程序從此處繼承下來，可以根據(jù)需要調(diào)整接口內(nèi)容。部分函數(shù)可以適當(dāng)刪除。在開發(fā)中一般是實(shí)現(xiàn)createReport（）函數(shù)就可以，形成實(shí)時(shí)動(dòng)態(tài)報(bào)表就是在這個(gè)函數(shù)里實(shí)現(xiàn)的。剩下的工作（怎樣在Web上顯示，怎樣形成Work，PDF文件，等）交給報(bào)表引擎自動(dòng)實(shí)現(xiàn)?！　∪绻窃贘SP中，在頁(yè)頭部分應(yīng)加入如下語(yǔ)句：　　%@ page extends=%　　如果是Servlet，相應(yīng)的Servlet類聲明時(shí)語(yǔ)句如下：　　public class Servlet類名稱 extends WebReportEngine{……　　}? createReport()　　方法原型如下：　　public Report createReport( request) throws 　　此方法用于建立報(bào)表，并返回報(bào)表的實(shí)例。這個(gè)報(bào)表實(shí)例可以在Web上顯示，同時(shí)也可以導(dǎo)出Word,Excel, PDF, CSV,HTML等格式的文檔以供使用?！　?shù)request可用于獲取所有的動(dòng)態(tài)請(qǐng)求的數(shù)據(jù)。? validate()　　此方法用于對(duì)上一個(gè)頁(yè)面Form提交的參數(shù)進(jìn)行檢查，由于實(shí)時(shí)報(bào)表需要?jiǎng)討B(tài)的參數(shù)，在這里進(jìn)行數(shù)據(jù)校驗(yàn)。方法原型如下：　　public validate( request)　　其中，參數(shù)request可用于獲取所有的動(dòng)態(tài)請(qǐng)求的數(shù)據(jù)；方法的返回值為null時(shí)代表通過，其他內(nèi)容則為參數(shù)錯(cuò)誤的提示信息。? getStartScript()　　方法用于構(gòu)造報(bào)表內(nèi)容在Web頁(yè)面上顯示之前執(zhí)行的JavaScript或VBScript腳本，如果要定制則要重載這個(gè)方法。方法原型如下：　　public 　　getStartScript( request)　　其中，參數(shù)request可用于獲取所有的動(dòng)態(tài)請(qǐng)求的數(shù)據(jù)；方法返回值為null時(shí)代表沒有腳本內(nèi)容。? getEndScript()　　方法用于構(gòu)造報(bào)表內(nèi)容在Web頁(yè)面上顯示之后執(zhí)行的JavaScript或VBScript腳本，如果要定制則要重載這個(gè)方法。方法原型如下：　　public 　　getEndScript( request)　　其中，參數(shù)request可用于獲取所有的動(dòng)態(tài)請(qǐng)求的數(shù)據(jù)；方法返回值為null時(shí)代表沒有腳本內(nèi)容。? getToolbarScript()　　方法用于定制Web報(bào)表在頁(yè)面首部顯示的工具欄為標(biāo)準(zhǔn)的樣式（上下翻頁(yè)，導(dǎo)出文件），可以在此擴(kuò)展工具欄的內(nèi)容，如：添加公司主頁(yè)的鏈接，返回上一層鏈接的“返回”按鈕，如果要定制則要重載這個(gè)方法。方法原型如下：　　public 　　getToolbarScript( request)　　其中，參數(shù)request可用于獲取所有的動(dòng)態(tài)請(qǐng)求的數(shù)據(jù)；方法返回值為null時(shí)代表不添加內(nèi)容。? isShowToolbar()　　如果不想在頁(yè)面上顯示報(bào)表工具欄，可重載這個(gè)方法，并設(shè)定返回值為false。需要注意的是，如果是多頁(yè)報(bào)表，上下翻頁(yè)按鈕就無(wú)法使用。方法原型如下：public boolean isShowToolbar()　　方法的返回值是是否顯示工具欄的布爾值標(biāo)志。? getAllEchoButton()　　方法用于自定義顯示在Web頁(yè)面中的報(bào)表導(dǎo)出文件的按鈕，比如應(yīng)用中只導(dǎo)出PDF文件，其他的不需要，就可以這里設(shè)定。按鈕值從Word按鈕開始是（1，2，4，8，...），需要顯示的按鈕則將它們的值相加就可以了。默認(rèn)情況下工具欄上的按鈕如圖1712所示：　　圖1712 默認(rèn)情況下工具欄上的按鈕　　方法原型如下：　　public int getAllEchoButton()　　方法的返回值是顯示按鈕對(duì)應(yīng)的和值。要作自定義，需要重載這個(gè)方法，并將返回值設(shè)為要顯示的按鈕對(duì)應(yīng)的和值。（2）Report類　　，報(bào)表類。這個(gè)類的對(duì)象用于代表一張報(bào)表，是所有報(bào)表元素的容器，這是整個(gè)系統(tǒng)的核心，也是在瀏覽器上顯示和生成電子文檔（Word，Excel，PDF，Html等）的基礎(chǔ)。? addHeaderSeparator()　　方法用于在報(bào)表的頁(yè)眉添加一條橫直線。方法原型如下：　　public addHeaderSeparator(int num)　　其中，參數(shù)num表示橫直線的粗細(xì)程度，以自然數(shù)表示，數(shù)字越大表示線越粗。? addHeaderSpace()　　此方法用于在頁(yè)眉中添加若干個(gè)空格。方法原型如下：　　public addHeaderSpace(int num)　　其中，參數(shù)num是要添加的空格的個(gè)數(shù)。? addHeaderTab()　　方法用于在頁(yè)眉中添加若干個(gè)【Tab】鍵，【Tab】鍵跟空格鍵一樣是不可見的，默認(rèn)每個(gè)【Tab】為8個(gè)空格。方法原型如下：　　public addHeaderTab(int num)　　其中，參數(shù)num是要添加的【Tab】鍵的個(gè)數(shù)。? addHeaderBreak()　　在頁(yè)眉中添加一個(gè)換行符號(hào)，緊跟后面的內(nèi)容則從下行第一個(gè)字符的位置開始。方法原型如下：　　public addHeaderBreak()? addHeaderText()　　在頁(yè)眉中添加文本信息內(nèi)容，緊跟后面的內(nèi)容則從下行第一個(gè)字符的位置開始。方法原型如下：　　public addHeaderText( text)　　其中，參數(shù)text是要添加的文本信息內(nèi)容。其中，{P}代表當(dāng)前頁(yè)，{N}代表總頁(yè)數(shù)，如：“第{P}頁(yè)，共{N}頁(yè)”。? addChart()　　在報(bào)表中添加圖表信息內(nèi)容。方法原型如下：　　public addChart(ChartImpl chart)　　其中，參數(shù)chart是要添加的圖表，圖表類ChartImpl是JavaReport的核心模塊，各種各樣統(tǒng)計(jì)圖由圖表類生成。? setCurrentFont()　　設(shè)置報(bào)表當(dāng)前的字體。原型如下：　　public void setCurrentFont( font)　　其中，參數(shù)是要設(shè)置的字體對(duì)象，.*包中的Font對(duì)象。? setCurrentBackground()　　設(shè)置報(bào)表當(dāng)前的背景顏色。原型如下：　　public void setCurrentBackground( color)　　其中，參數(shù)color是要添加的圖形對(duì)象，.*包中的color對(duì)象。? setCurrentForeground()　　設(shè)置報(bào)表當(dāng)前的前景顏色。原型如下：　　public void setCurrentForeground( color)　　其中，參數(shù)color是要添加的圖形對(duì)象，.*包中的color對(duì)象。? addImage()　　在報(bào)表中添加圖片信息內(nèi)容。原型如下：　　public addImage( image)　　其中，參數(shù)image是要添加的圖形對(duì)象，.*包中的Image對(duì)象。? addBullet()　　這個(gè)方法有兩種形式：　　public addBullet()或　　public addBullet( image)　　該方法用于添加項(xiàng)目符號(hào)的表示符號(hào)。第一種形式添加默認(rèn)的項(xiàng)目符號(hào)（圓點(diǎn)）的表示符號(hào)，第二種形式用自定義的圖片內(nèi)容代替默認(rèn)的圓點(diǎn)內(nèi)容。參數(shù)image是要添加的圖形對(duì)象，.*包中的Image對(duì)象。? addNewline()　　方法用于在報(bào)表中添加一個(gè)換行符號(hào)，緊跟后面的內(nèi)容則從下行第一個(gè)字符的位置開始。方法原型如下：　　public addNewline(int num)　　其中，參數(shù)num代表?yè)Q行的數(shù)量，即多次換行。? addPageBreak()　　方法用于在報(bào)表中添加換頁(yè)的標(biāo)識(shí)符號(hào)，當(dāng)報(bào)表系統(tǒng)做分頁(yè)顯示時(shí)，遇到這個(gè)符號(hào)時(shí)，則緊跟后面的內(nèi)容在新的一頁(yè)開始顯示。方法原型如下：　　public addPageBreak()? addSeparator()　　在報(bào)表中添加一條橫直線。方法原型如下：　　public addSeparator(int num)　　其中，參數(shù)num表示橫直線的粗細(xì)程度，以自然數(shù)表示，數(shù)字越大表示線越粗。? addSpace()　　添加若干個(gè)空格。方法原型如下：　　public addSpace(int num)　　其中，參數(shù)num代表空格的個(gè)數(shù)。? addTab()在報(bào)表中添加若干個(gè)【Tab】鍵，【Tab】鍵跟空格鍵一樣是不可見的，默認(rèn)每個(gè)【Tab】鍵為8個(gè)空格。方法原型如下：public addTab(int num)　　其中，參數(shù)num是要添加的【Tab】鍵的個(gè)數(shù)。? addText()　　在報(bào)表中添加文本信息內(nèi)容，緊跟后面的內(nèi)容則從下行第一個(gè)字符的位置開始。方法原型如下：　　public addText( text)　　其中，參數(shù)text為要添加的文本信息內(nèi)容。? addTable()　　添加報(bào)表中的表格信息內(nèi)容。方法原型如下：　　public addTable(Table table)　　其中，參數(shù)table是要添加的表格，有關(guān)Table類的內(nèi)容詳見本節(jié)中（3）中的內(nèi)容。? addFooterSeparator()　　在頁(yè)尾添加一條橫直線。方法的原