【正文】 作者：ajun版本：20061110 一 Excel Report簡(jiǎn)介： 2 什么是Excel Report？ 2 它具有那些功能？ 2 Excel Report的靈活性: 2 它與普通報(bào)表工具的區(qū)別： 3二 體驗(yàn)生成一個(gè)簡(jiǎn)單報(bào)表的制作過程： 3 運(yùn)行環(huán)境配置 3 開始制作一個(gè)簡(jiǎn)單的報(bào)表 4三 4 設(shè)計(jì)一個(gè)報(bào)表需要配置那些信息？ 5 datasource 節(jié)點(diǎn) 5 report節(jié)點(diǎn) 7 配置文件配置信息規(guī)范建議 9四 報(bào)表模板文件配置 9 報(bào)表模板中的基本元素 10 Excel Report模板文件的構(gòu)成 12 報(bào)表模板配置規(guī)范建議 16 格式化輸出控制 16 通過$V{}(Excel函數(shù)模板)來使用excel的函數(shù) 17 示例： 18 常見問題： 18五 設(shè)計(jì)報(bào)表嵌入對(duì)象 18 為什么需要設(shè)計(jì)報(bào)表嵌入對(duì)象？ 18 我們可以在嵌入對(duì)象里面做些什么？ 19 一個(gè)嵌入對(duì)象實(shí)例： 19六 使用Excel Report的高級(jí)特性： 19 擴(kuò)充你自己的數(shù)據(jù)源。 19 使用變量別名。 19 設(shè)計(jì)模板是使用$V{}調(diào)用excel函數(shù)時(shí)的注意事項(xiàng)。 19 在web容器中配置Excel Report（ExcelReportServlet） 20 在非web容器環(huán)境下使用excel report. 20七 一個(gè)完整的報(bào)表示例： 20 20 配置模板文件 20 設(shè)計(jì)嵌入對(duì)象 20結(jié)束語： 20一 Excel Report簡(jiǎn)介： 什么是Excel Report？Excel Report是一款基于Excel的報(bào)表生成工具，它通過用戶定義報(bào)表模板文件，定義數(shù)據(jù)源，并配置相應(yīng)的配置文件，就可以通過頁面向指定Servlet請(qǐng)求輸出報(bào)表，其生成的報(bào)表是一個(gè)excel文件。通過模板文件的方式來生成Excel文件，可以讓程序員從生成特定格式的Excel文件的輸出格式控制以及Excel文件讀寫等紛繁復(fù)雜而又容易出錯(cuò)的細(xì)節(jié)中解放出來，使得程序員只需組裝自己的數(shù)據(jù)源，而根本不需要關(guān)心如何去生成Excel文件，如何去控制最終的文件輸出效果等細(xì)節(jié)，從而大大減輕了制作一個(gè)Excel報(bào)表的工作量，并增強(qiáng)了程序的可維護(hù)性，因?yàn)楹芏嗟膱?bào)表的修改只需通過模板文件的修改就可以實(shí)現(xiàn)，而無需改動(dòng)程序。同時(shí)該報(bào)表工具又提供一些靈活的特性來使得用戶可以自由控制報(bào)表的輸出過程。 它具有那些功能？1. 卡片式報(bào)表的支持。 2. 列表式報(bào)表的支持。3. 主從式報(bào)表的支持。4. 分組式報(bào)表的支持。（注：主從式和分組式之間可以任意嵌套，即一個(gè)主從式報(bào)表中我們可以嵌套一個(gè)分組從而實(shí)現(xiàn)對(duì)主記錄或從記錄進(jìn)行分組的功能，反之也如此。）5. 格式化的數(shù)據(jù)輸出，該報(bào)表工具支持所有Excel的格式化輸出控制。6. 支持所有Excel的函數(shù)。 Excel Report的靈活性: 數(shù)據(jù)源的自定義：用戶可以自己定義數(shù)據(jù)源以替代默認(rèn)實(shí)現(xiàn)，例如，我們可以編寫一個(gè)自己的數(shù)據(jù)庫數(shù)據(jù)源，通過定義該數(shù)據(jù)源我們可以利用現(xiàn)有系統(tǒng)的數(shù)據(jù)庫連接及數(shù)據(jù)檢索框架等。 嵌入報(bào)表數(shù)據(jù)處理類：用戶可以嵌入自己報(bào)表數(shù)據(jù)處理類（通過配置文件配置），通過嵌入用戶自己的報(bào)表數(shù)據(jù)處理類，報(bào)表工具給用戶提供了一個(gè)入口讓用戶參與報(bào)表的生成過程。比如，用戶可以在生成報(bào)表前來組合自己的數(shù)據(jù)源，在這里用戶完全可以充分利用現(xiàn)有系統(tǒng)的相關(guān)業(yè)務(wù)類來生成自己的數(shù)據(jù)源。 插入查詢監(jiān)聽器：用戶可以插入自己的查詢監(jiān)聽器，通過監(jiān)聽數(shù)據(jù)源的查詢請(qǐng)求來做相關(guān)數(shù)據(jù)的檢索及處理等工作（該功能在主從報(bào)表中尤其有用）。 插入字段監(jiān)聽器：通過插入字段監(jiān)聽器，使得用戶可以參與報(bào)表的輸出過程，控制報(bào)表的具體輸出的數(shù)據(jù)。（對(duì)于數(shù)據(jù)庫自動(dòng)檢索數(shù)據(jù)類數(shù)據(jù)源的應(yīng)用場(chǎng)合尤其有用）這些特性在后面的章節(jié)我們會(huì)做詳細(xì)的介紹。 它與普通報(bào)表工具的區(qū)別： Excel Report是一個(gè)完全基于excel的報(bào)表工具，其最大的特點(diǎn)是完全依賴于excel。這是其于其他任何報(bào)表工具的最大區(qū)別。 通過依賴于Excel它具備了以下優(yōu)點(diǎn)：A. 省略了專門的報(bào)表模板定義工具，應(yīng)為該工具就是Excel本身，相信Excel的強(qiáng)大功能可以勝過任何其他報(bào)表工具模板定義工具。B. 可以充分利用Excel的強(qiáng)大功能，如Excel函數(shù)庫及其相關(guān)的腳本技術(shù)，Excel的圖表(暫未提供支持)以及其對(duì)打印功能的強(qiáng)大控制能力。二 體驗(yàn)生成一個(gè)簡(jiǎn)單報(bào)表的制作過程： 計(jì)算機(jī)世界里面大多數(shù)語言類的教程，在起始部分都會(huì)有一個(gè)經(jīng)典的Hello World小程序，作為整個(gè)書的開篇，當(dāng)然這樣一個(gè)用例放在全文的開始，一來可以使讀者可以快速的感受下所學(xué)東西的功能，二來也可以讓讀者快速上手，通過成功運(yùn)行一個(gè)簡(jiǎn)單例子，而獲得一定的成就感，從而增強(qiáng)繼續(xù)學(xué)習(xí)下去的信心。 在這里我們也不想免俗，讓大家感受一下，制作一個(gè)Excel報(bào)表是多么的簡(jiǎn)單。當(dāng)然在開始這個(gè)簡(jiǎn)單例子之前，一些必要的環(huán)境必須得提前準(zhǔn)備好。(注：你可以在example/?？梢园阉苯涌截惖奖镜氐膖omcat應(yīng)用目錄下運(yùn)行例子程序)本手冊(cè)只針對(duì)ExcelReport的功能及其使用方法進(jìn)行介紹，并未涉及報(bào)表制作相關(guān)的知識(shí)說明，因此在閱讀此文檔前必須要求讀者具備一定報(bào)表制作相關(guān)的基礎(chǔ)知識(shí)，且具備一定報(bào)表制作的經(jīng)驗(yàn)，并了解普通報(bào)表設(shè)計(jì)的一般流程。 運(yùn)行環(huán)境配置首先你得準(zhǔn)備一個(gè)WEB服務(wù)器（），1. 拷貝example\\\ conf\Catalina\localhost目錄下2. 拷貝example\\ excelreport目錄到你的TOMCAT_HOME\webapps目錄下3．啟動(dòng)數(shù)據(jù)庫――找到TOMCAT_HOME\webapps\excelreport\dababase\,雙擊該文件啟動(dòng)HSQL數(shù)據(jù)庫服務(wù)器。（Windows環(huán)境）4. 拷貝excelreport對(duì)應(yīng)的運(yùn)行庫文件到目錄：TOMCAT_HOME\webapps\excelreport\WEBINF\lib5. 拷貝TOMCAT_HOME\webapps\excelreport\dababase\ 到TOMCAT_HOME\mon\lib目錄下截止到目前，運(yùn)行環(huán)境已經(jīng)搭建完成。 開始制作一個(gè)簡(jiǎn)單的報(bào)表1． 在我們example例子數(shù)據(jù)庫中已經(jīng)存在一個(gè)user的表。在配置文件中加入下面配置信息：datasource name=helloworld_ds type=database sql value=select * from user/ /datasource report name=helloworld templetfile= sheet name=helloworld index=0 reportstyle=list datasource name=ds source=helloworld_ds /datasource /sheet /report2． 如圖紅線圈住地方配置你的數(shù)據(jù)集字段要輸出的位置。初接觸配置文件會(huì)比較麻煩，因?yàn)榕渲玫男畔⒈容^多，在后續(xù)的章節(jié)我們會(huì)詳細(xì)介紹具體每個(gè)配置信息的具體功能。為了避免出現(xiàn)不必要的錯(cuò)誤，你最好從例子附帶的模板文件拷貝配置信息。這樣可以減少不必要的失誤帶來的麻煩。3． 啟動(dòng)tomcat服務(wù)器4． 請(qǐng)求報(bào)表：://localhost:8080/excelreport/report?report=helloworld具體信息可以根據(jù)你web服務(wù)器的具體配置做相應(yīng)調(diào)整。如果能看到文件下載對(duì)話框，那么恭喜你，第一個(gè)例子程序運(yùn)行成功了。三 在上一章節(jié)我們來快速地體驗(yàn)了一下Excel Report的具體功能，從這樣一個(gè)簡(jiǎn)單的報(bào)表當(dāng)中相信你也應(yīng)該能體驗(yàn)到Excel Report的真正功能：通過分離報(bào)表數(shù)據(jù)和報(bào)表生成邏輯，使得程序員可以不用關(guān)心報(bào)表的具體如何生成，而只要準(zhǔn)備自己的數(shù)據(jù)源和模板文件，僅此而已。這能給我們的程序帶來什么樣的好處呢？它能為我們的程序帶來更好的靈活性和可維護(hù)性。我們可以很方便地通過更改模板文件來更改報(bào)表的具體輸出效果，而這一過程可以做到盡可能小的影響到數(shù)據(jù)源的相關(guān)業(yè)務(wù)邏輯。你再也看不到業(yè)務(wù)數(shù)據(jù)相關(guān)的代碼和excel文件生成的代碼交叉在一起的痛苦場(chǎng)面了，當(dāng)然你也再也不需要去寫那些麻煩的Excel輸出格式控制的代碼了。我們?cè)谏弦徽鹿?jié)Hello World (注意：這個(gè)文件名稱本身也是可配置的)，在該配置文件里面我們配置了datasource和report兩個(gè)節(jié)點(diǎn)，接下來的這一章節(jié)我們就來詳細(xì)介紹該配置信息的具體功能和配置項(xiàng)的具體使用方法。 設(shè)計(jì)一個(gè)報(bào)表需要配置那些信息？相信每一個(gè)剛接觸到這個(gè)工具的人頭腦里面都會(huì)問的一個(gè)問題，當(dāng)然這要看，不同的報(bào)表有不同的實(shí)現(xiàn)（廢話:）），但不管什么報(bào)表有兩個(gè)配置項(xiàng)目是必不可少的，datasource和report。其中detasource是用來描述一個(gè)數(shù)據(jù)源的信息，由它來告訴報(bào)表工具如何去生成一個(gè)具體的數(shù)據(jù)源對(duì)象實(shí)例，我們?cè)谶@個(gè)配置項(xiàng)你們需要回答報(bào)表工具以下幾個(gè)問題：1．我需要一個(gè)什么類型的數(shù)據(jù)源？2．這個(gè)數(shù)據(jù)源如何取數(shù)據(jù)（取決于1）。3．?dāng)?shù)據(jù)源應(yīng)該接收那些輸入?yún)?shù)？（可選）4．?dāng)?shù)據(jù)源有那些字段？字段的類型是什么等等。（可選）5．如果是database型的數(shù)據(jù)源的話，查詢的sql是什么？Report是用來告訴報(bào)表生成工具，生成一個(gè)報(bào)表需要用到那些資源？從那去取？比如：報(bào)表模板文件名稱，報(bào)表中用到的數(shù)據(jù)源名稱等等信息。報(bào)表生成工具通過這些配置信息，去取得相應(yīng)的資源，并生成用戶想要的報(bào)表文件。 datasource 節(jié)點(diǎn)上面我們說過datasource是用來描述一個(gè)數(shù)據(jù)源，該節(jié)點(diǎn)定義一個(gè)全局的數(shù)據(jù)源信息，當(dāng)定義好一個(gè)全局的數(shù)據(jù)源之后，就可以在我們具體的報(bào)表里面應(yīng)用該數(shù)據(jù)源。在詳細(xì)介紹該節(jié)點(diǎn)配置信息之前，我們看一個(gè)比較典型的實(shí)例，