?
使用第三方的報(bào)表設(shè)計(jì)器 / 服務(wù)器來快速的開發(fā)報(bào)表。
潤(rùn)乾服務(wù)器是使用 Java 語言編寫的一個(gè)靈活易用的報(bào)表服務(wù)器和設(shè)計(jì)器。因此，用它來做 Java 的報(bào)表設(shè)計(jì)是很快捷的，但是經(jīng)常報(bào)錯(cuò)，而且不好查錯(cuò)。
?
下面來介紹一下潤(rùn)乾報(bào)表 4.0 在 J2EE 下的部署【非集成部署】
①?下載一個(gè)新的 Tomcat
②?新建一個(gè) Web 應(yīng)用，基本目錄結(jié)構(gòu)如下：
|-report
|----------include [ 包含 images 、 js 、 css 等資源 ]
|----------reportFiles [ 包含潤(rùn)乾設(shè)計(jì)的報(bào)表 raq 文件 ]
|----------reportJsp [ 包含用于展現(xiàn) raq 資源的 jsp 文件 ]
|----------WEB-INF
?????????? |----------classes [ 放置潤(rùn)乾的授權(quán)文件 ]
?????????? |----------lib [ 放置 jar 包 ]
?????????? |----------web.xml [ 配置應(yīng)用程序 ]
?????????? |---------- 其他配置文件 ?
?
③?拷貝潤(rùn)乾的 Web 發(fā)布包
一般來說，我們創(chuàng)建了一個(gè)新的應(yīng)用后，可以將潤(rùn)乾的 web 發(fā)布報(bào)作為一個(gè)標(biāo)準(zhǔn)的應(yīng)用去發(fā)布，因?yàn)闈?rùn)乾的發(fā)布包本身就是上述的標(biāo)準(zhǔn)結(jié)構(gòu)。
我們先來看看潤(rùn)乾的發(fā)布包的目錄結(jié)構(gòu)
根據(jù)以上的發(fā)布包，選擇性的拷貝了如下的內(nèi)容到 report 應(yīng)用之中
Report?WEB 應(yīng)用的結(jié)構(gòu) WEB-INF 的目錄結(jié)構(gòu)
?????
注意：
1）?我們一定要將數(shù)據(jù)庫(kù)驅(qū)動(dòng)和潤(rùn)乾的 jar 包都拷貝到 WEB-INF 的 lib 文件夾里，且盡量不要將 jar 包放在全局的 lib 里。不便于管理，若無驅(qū)動(dòng)則會(huì)報(bào)出如下的錯(cuò)誤：
錯(cuò)誤信息：
runqianReportLogger?:?[ERROR]??-?error:?產(chǎn)生數(shù)據(jù)工廠:?
com.runqian.report4.dataset.SQLDataSetFactory?失敗
錯(cuò)誤來源：:?Cannot?load?JDBC?driver?class?'com.ibm.db2.jcc.DB2Driver'
?
這個(gè)錯(cuò)誤是提示我們JDBC 無法連接，是驅(qū)動(dòng)問題。 因此，必須要拷貝的 jar 包的列表如下： ?
?
潤(rùn)乾的 jar 包?????????????? DB2 數(shù)據(jù)庫(kù)的驅(qū)動(dòng)
?
????
2）?記得將服務(wù)器的授權(quán)文件runqianWindowServer.lic拷貝到 WEB-INF/classes 文件夾下。否則會(huì)報(bào)錯(cuò)如下：
runqianReportLogger?:?[INFO?]??-?報(bào)表證書錯(cuò)誤!
未發(fā)現(xiàn)授權(quán)文件:runqianWindowServer.lic,?請(qǐng)檢查是否在類路徑或絕對(duì)路徑上l
?
④?配置相關(guān)的文件
1 ） web.xml 文件
直接把潤(rùn)乾的 demo 的 web.xml 文件拷貝進(jìn)來，無需改動(dòng)。
?
2）?reportConfig.xml 文件 [ 容易出錯(cuò)的配置文件，講解部分重要的配置 ] ?
<?xml?version="1.0"?encoding="UTF-8"??>
<reportConfig>
??
第一個(gè)重要的配置：license【表示潤(rùn)乾公司提供的授權(quán)文件名及其路徑，可以是絕對(duì)文件路徑；也可以是相對(duì)于 WEB 應(yīng)用根目錄的相對(duì)路徑（此時(shí)要以 “/” 開頭） 】
????<config>
??????<name>license</name>
??????<value>runqianWindowServer.lic</value>
</config>
?
第二個(gè)重要的配置：reportFileHome【表示編輯好的報(bào)表文件在應(yīng)用中存放的位置，值可相對(duì)于 WEB 應(yīng)用根目錄；也可 是絕對(duì)路徑，分隔符用 “/” 表示，如 d:/myReport/web/reportFiles 。 】
????<config>
??????<name>reportFileHome</name>
??????<value>/reportFiles</value>
</config>
?
第三個(gè)重要的配置：JNDIPrefix【表示查找數(shù)據(jù)源時(shí)的環(huán)境串前綴，在不同的 WEB 服務(wù)器中不同，如 Tomcat 中是 java:/comp/env ，而 Weblogic 和 Websphere 中均不需要，可以不填?！?
<config>
??????<name>JNDIPrefix</name>
??????<value>java:/comp/env</value>
</config>
?
第四個(gè)重要的配置：dataSource【表示用戶在 WEB 應(yīng)用中要用到的數(shù)據(jù)源配置，其格式如下：數(shù)據(jù)源的 JNDI 名稱 , 數(shù)據(jù)庫(kù)類型 [, 取數(shù)時(shí)是否需要轉(zhuǎn)換編碼 , 數(shù)據(jù)庫(kù)字符集編碼 , 顯示報(bào)表時(shí)的字符集編碼 ][,SQL 是否需要轉(zhuǎn)碼 ]; 一般我們只需要配置前兩個(gè)即可?！?
????<config>
??????<name>dataSource</name>
??????<value>NEWMOD,db2;value>
</config>
?
第五個(gè)重要的配置：數(shù)據(jù)源信息的配置【以應(yīng)用程序?yàn)閱挝唬渲锰囟ǖ臄?shù)據(jù)源?！俊緜渥ⅲ喝羰褂玫氖荍NDI直連，則這個(gè)配置可以忽略】
<jdbc-ds-configs>
??????<jdbc-ds-config>
??????????<name>report</name>
??????????<db-type>javax.sql.DataSource</db-type>
<connection-url>jdbc:db2://192.168.100.135:50000/NEWMOD?</connection-url>
??????????<driver-class>com.ibm.db2.jcc.DB2Driver</driver-class>
??????????<user-name>db2admin</user-name>
??????????<password>db2admin</password>
??????????<db-charset>GBK</db-charset>
??????????<client-charset>GBK</client-charset>
????????</jdbc-ds-config>
?</jdbc-ds-configs>
</reportConfig>
?
注意，這里的 name 屬性的值是 report ，也就是應(yīng)用程序的名字。而不是 JNDI 的名字。
如果配置成 JNDI 的名字，則會(huì)出現(xiàn)報(bào)錯(cuò) ，查看 DB2 的報(bào)錯(cuò)大全可見：
?
類代碼
2E
無效連接名稱
表
25.
類代碼
2E
：無效連接名稱
SQLSTATE
值??
含義：2E000
連接名稱無效。
?
可以看出，這就是因?yàn)? name 屬性配錯(cuò)的原因。
?
⑤?配置數(shù)據(jù)源
在 reportConfig.xml 文件中配置了數(shù)據(jù)源的連接信息，但是沒有配置數(shù)據(jù)源。
現(xiàn)在我們?cè)? conf----catalina----localhost 文件夾下建立一個(gè)和應(yīng)用程序同名的 report.xml 文件，內(nèi)容如下：
<?xml?version="1.0"?encoding="UTF-8"?>
?<Context?path="/report"?docBase="D:\?report\webapps\report"?reloadable="true"?>?
<Resource?auth="Container"?
name="newmodules/DataSource"
??type="javax.sql.DataSource"?
maxWait="10000"?maxIdle="30"?maxActive="100"??
??username="db2admin"?
password="db2admin"?
driverClassName="com.ibm.db2.jcc.DB2Driver"?
??url="jdbc:db2://192.168.100.135:50000/NEWMOD"
??/>
??</Context>??
?
如果不配置數(shù)據(jù)源會(huì)報(bào)錯(cuò)如下：
javax.servlet.ServletException:?No?report?config?file!
?
⑥?發(fā)布報(bào)表和 JSP 頁(yè)面并訪問
測(cè)試：將 financeView.raq 文件放在 reportFiles 文件夾里， financeView.jsp 頁(yè)面放在 reportJsp 文件夾下，然后訪問 jsp 頁(yè)面： http://localhost:8080/report/reportJsp/financeView.jsp
展現(xiàn)如下：
?
?
真的成功了呢 ~ 好棒啊 ~ 。
好了，繼續(xù)工作了 ~ 。
?
更多文章、技術(shù)交流、商務(wù)合作、聯(lián)系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號(hào)聯(lián)系： 360901061
您的支持是博主寫作最大的動(dòng)力，如果您喜歡我的文章，感覺我的文章對(duì)您有幫助，請(qǐng)用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點(diǎn)擊下面給點(diǎn)支持吧，站長(zhǎng)非常感激您！手機(jī)微信長(zhǎng)按不能支付解決辦法：請(qǐng)將微信支付二維碼保存到相冊(cè)，切換到微信，然后點(diǎn)擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對(duì)您有幫助就好】元
