潤乾報表在J2EE下的部署課件

潤乾報表在j2ee下的部署培訓(xùn)內(nèi)容一、部署流程和步驟二、WEB應(yīng)用配置三、應(yīng)用服務(wù)器簡介四、常見部署問題五、編程接口入門六、4.0和3.5在部署上的差異前題－－安裝WEB服務(wù)器Tomcat拷貝安裝目錄Weblogic安裝創(chuàng)建domainWebSphere安裝一、部署流程和步驟配置應(yīng)用服務(wù)器的數(shù)據(jù)庫連接池創(chuàng)建新應(yīng)用拷貝潤乾報表web發(fā)布包配置潤乾相關(guān)的配置文件發(fā)布報表應(yīng)用打war包Web應(yīng)用配置不同服務(wù)器配置方式不一樣潤乾報表核心配置文件reportConfig.xml1.1配置應(yīng)用服務(wù)器的連接池1.部署JDBC驅(qū)動2.創(chuàng)建數(shù)據(jù)庫連接池3.各服務(wù)器部署差異1.1.1部署JDBC驅(qū)動Tomcat拷貝JDBC驅(qū)動到common/libWeblogic修改cmd文件添加jdbc到classpathWebsphere拷貝文件AppServer\lib1.1.2創(chuàng)建數(shù)據(jù)庫連接池Tomcat修改配置文件Weblogic控制臺Webspher控制臺練習(xí)：創(chuàng)建連接池在您關(guān)注的應(yīng)用服務(wù)器下創(chuàng)建連接池常見問題分析1.url、dirver2.找不到數(shù)據(jù)源×××3.tomcat5.0及以上版本如何配置連接池4.設(shè)計器和服務(wù)器數(shù)據(jù)源名稱是否需要一致常見問題小節(jié)前提－了解web應(yīng)用目錄結(jié)構(gòu)2.1創(chuàng)建應(yīng)用應(yīng)用目錄WEB-INFclasseslibweb.xml練習(xí)：創(chuàng)建應(yīng)用創(chuàng)建名為runqian的應(yīng)用必須含有WEB-INF目錄WEB-INFclasseslib2.2復(fù)制報表引擎文件程序包七個jar程序包配置文件四個配置文件練習(xí)：復(fù)制潤乾報表引擎復(fù)制報表引擎七個jar包四個配置文件操作：七個jar包拷貝到….\runqian\WEB-INF\lib四個配置文件拷貝到…..\runqian\WEB-INF\練習(xí)：復(fù)制打印程序程序包runqianReport4Applet.jarwidonws：j2re-1_4_1-windows-i586-i.exeLinux：j2re-1_4_2_08-linux-i586.rpm2.4相關(guān)的配置文件1.reportConfig.xml配置2.web.xml配置3.runqianReportLperties日志配置練習(xí)：reportConfig.xml的基本配置 <config> <name>license</name> <value>Server.lic</value> </config>授權(quán)文件 <config> <name>report</name> <value>/reportFiles</value> </config>報表模板位置 <config> <name>semanticsFile</name> <value>/WEB-INF/demo.xml</value> </config>語義層文件 <config> <name>JNDIPrefix</name>

<value>java:comp/env</value> </config>JNDI前綴 <config> <name>dataSource</name> <value>jdbc/test,oracle,GBK;exercise,sqlsvr,1,iso8859-1,GBK,0

</value> </config>數(shù)據(jù)源配置數(shù)據(jù)源的JNDI名稱,數(shù)據(jù)庫類型[,取數(shù)時是否需要轉(zhuǎn)換編碼,數(shù)據(jù)庫字符集編碼,顯示報表時的字符集編碼][,SQL是否需要轉(zhuǎn)碼];

2.4.2緩存配置1.報表參數(shù)緩存時間2.報表緩存臨時目錄3.報表緩存時間4.緩存位置2.4.3并發(fā)配置大報表:當(dāng)結(jié)果報表格子數(shù)超過一萬個時，可以設(shè)為大報表，進(jìn)行并發(fā)控制1.同時計算的報表的個數(shù)

2.等待計算的報表的個數(shù)3.等待計算的最大時間

練習(xí)：reportConfig.xml的并發(fā)配置<config><name>maxConcurrentForReport</name><value>9999</value>同時計算的報表的個數(shù)

</config><config><name>maxWaitForReport</name><value>9999</value>等待計算的報表的個數(shù)</config><config><name>maxWaitTimeForReport</name><value>9999</value>等待計算的最大時間</config>2.4.4配置潤乾日志配置日志文件配置日志級別2.5發(fā)布web應(yīng)用Tomcat修改配置文件Weblogic控制臺Webspher控制臺只能發(fā)布war文件Jar命令打war包開始運行cmd進(jìn)入應(yīng)用所在的目錄jar查看幫助jarcvfrunqian.war*.*練習(xí)：把應(yīng)用打成war用jar命令把配置好的應(yīng)用打成war包注意事項：不同應(yīng)用服務(wù)器中注意修改jndi名稱應(yīng)用中盡量不要有中文名稱盡量刪除web.xml的中文注釋常見問題小節(jié)三常見應(yīng)用服務(wù)器配置簡介3.1、Tomcat4部署3.2、Tomcat5.0部署3.3、Weblogic的部署3.4、Websphere的部署3.1Tomcat4.0部署安裝tomcat4.0創(chuàng)建數(shù)據(jù)庫連接池創(chuàng)建應(yīng)用修改配置文件部署應(yīng)用3.1.1安裝Tomcat下載Tomcat安裝程序安裝Tomcat確保Tomcat正常啟動3.1.2創(chuàng)建數(shù)據(jù)庫連接池<ContextdocBase="F:/old/ROOT"path="/rp"debug="0"privileged="true"><Resource

name="pubs"auth="Container"type="javax.sql.DataSource"/><ResourceParamsname="pubs"><parameter><name>driverClassName</name><value>com.newatlanta.jturbo.driver.Driver</value></parameter><parameter><name>url</name><value>jdbc:JTurbo:///pubs/charset=GBK</value></parameter><parameter><name>username</name><value>sa</value></parameter><parameter><name>password</name><value>sa</value></parameter> </ResourceParams></Context>3.1.3創(chuàng)建應(yīng)用按照web應(yīng)用的目錄結(jié)構(gòu)創(chuàng)建應(yīng)用復(fù)制報表引擎文件復(fù)制報表打印程序3.1.4修改reportConfig.xmlDateSerlvlet授權(quán)文件license報表模板路徑reportJNDI前綴JNDIPrefix數(shù)據(jù)源dataSource緩存目錄cachedReportDir日志文件logConfig3.1.5修改日志配置文件日志級別log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2日志文件log4j.appender.LOG部署應(yīng)用直接拷貝應(yīng)用到webapps目錄下面修改應(yīng)用部署文件Tomcat4修改server.xmlTomcat5.0配置應(yīng)用<?xmlversion='1.0'encoding='gb2312'?><Context

docBase="F:/old/ROOT"path="/rp"debug="0"privileged="true"><Resource

name="pubs"auth="Container"type="javax.sql.DataSource"/><ResourceParamsname="pubs"><parameter><name>driverClassName</name><value>com.newatlanta.jturbo.driver.Driver</value></parameter><parameter><name>url</name><value>jdbc:JTurbo:///pubs/charset=GBK</value></parameter><parameter><name>username</name><value>sa</value></parameter><parameter><name>password</name><value>sa</value></parameter> </ResourceParams></Context>Tomcat中文亂碼Tomcat_HOME/conf/server.xml<Connectorport="8002“。。。。。。。。。。。。URIEncoding="GBK"/>3.3、Weblogic的部署拷貝jdbc驅(qū)動包拷貝WebLogic81\server\lib下修改WebLogic81\common\bin\commEnv.cmd配置連接池數(shù)據(jù)源部署報表應(yīng)用目錄發(fā)布War/ear發(fā)布3.4、Websphere的部署拷貝jdbc驅(qū)動包配置連接池數(shù)據(jù)源部署報表應(yīng)用war/ear發(fā)布常見問題小節(jié)四、常見部署問題1.版本升級2.應(yīng)用服務(wù)器的差異3.操作系統(tǒng)的差異4.數(shù)據(jù)庫連接5.性能優(yōu)化4.1、版本升級新舊包混用更新不全授權(quán)文件不正確4.1.1、新舊包混用舊包未刪除report4.jar緩存未刪除多個路徑下存在舊包搜索runqian*.jar，然后把可疑的jar全部刪除，再部署新版本。4.1.2、更新不全同時多個包需要更新，但是只更新其中的一部分runqianReport*.jarpoi2.jar(導(dǎo)出Excel)、itext_rq.jar

(導(dǎo)出Word)、runqianReport4Applet.jar(打印)需要同時更新配置文件，如web.xml,reportConfig.xml、tld文件等runqianReport4.tld文件版本太舊導(dǎo)致的常見錯誤信息：org.apache.jasper.JasperException:/reportJsp/showReport.jsp(140,0)AttributescaleinvalidaccordingtothespecifiedTLD、授權(quán)證書不是服務(wù)器版授權(quán)證書不是服務(wù)器版的：[2007-06-2418:14:12]runqianReportLogger:[INFO]-報表證書錯誤!報表授權(quán)證書不是服務(wù)器版的，請更換正確版本！解決：更換服務(wù)器版的授權(quán)。、只能在x操作系統(tǒng)中運行錯誤信息：[2007-06-2418:18:57]runqianReportLogger:[INFO]-報表證書錯誤!您現(xiàn)在的報表授權(quán)只能在Linux操作系統(tǒng)中運行!

解決辦法：更新授權(quán)，換用windwows版的授權(quán)。、沒有配置授權(quán)reportConfig.xml中沒有配置授權(quán)文件名錯誤信息：[2007-06-2418:16:47]runqianReportLogger:[INFO]-報表證書錯誤!未發(fā)現(xiàn)授權(quán)文件:Server.lic,請檢查是否在類路徑或絕對路徑上解決辦法：在reportConfig.xml里配置授權(quán)文件、授權(quán)文件已過期授權(quán)文件已過期錯誤信息：[2007-07-2418:24:32]runqianReportLogger:[ERROR]-error：java.lang.RuntimeException:在類路徑中未找到授權(quán)文件或授權(quán)文件已過期atcom.runqian.report4.usermodel.Engine.calc(UnknownSource:85)com.runqian.report4.tag.HtmlTag.doStartTag(UnknownSource:287)解決辦法：更新授權(quán)授權(quán)文件不正確其他原因：java.util.MissingResourceException:Can'tfindbundleforbasenamecom.runqian.base4.resources.server,localeen_USatjava.util.ResourceBundle.throwMissingResourceException(ResourceBundle.java:838)

4.2應(yīng)用服務(wù)器的差異JNDI前綴JDK版本中文的支持Servlet的版本4.2.1應(yīng)用服務(wù)器的JNDI差異Datasource的前綴(web.xml中JNDIPrefix屬性值)

服務(wù)器TomcatresinJBOSSweblogicwebsphereJNDIPrefixJava:comp/envJava:comp/envJava:4.2.2

jdk的版本比較容易導(dǎo)致jdk版本困擾的應(yīng)用服務(wù)器一般是websphere，由于websphere本身是IBM的產(chǎn)品，因此其自帶的JDK也是IBM的，雖然也符合J2EE的標(biāo)準(zhǔn)，但是在個別地方和SUN的還是有區(qū)別，例如其JIT(即時編譯器)就有問題，如果這個選項不關(guān)閉，程序有時候會出問題。

另外，和oracleERP集成時必須注意，其自帶的jdk版本是jdk1.3，而且oracleERP往往會在客戶端安裝一些程序，因此導(dǎo)致了客戶端的jdk版本為jdk1.3。但是潤乾的打印applet要求jdk1.4，兩者會造成沖突。因此如果遇到這種情況，請聯(lián)系潤乾的技術(shù)支持，要一個專門在jdk1.3下編譯的打印applet包。

4.2.3中文的支持不同的應(yīng)用服務(wù)器，對中文的支持不一樣，例如tomcat4和tomcat5就有區(qū)別，此時如果參數(shù)是程序員自己接收并傳遞給tag標(biāo)簽的，那么要記得轉(zhuǎn)碼，尤其是報表模板文件名，否則容易出現(xiàn)莫名其妙的錯誤，例如報表模板找不到等等。在websphere下，對中文的支持也比較差，打war包時不能有中文名的文件，reportConfig.xml文件中所有中文注釋要刪掉，且reportConfig.xml中的第一句關(guān)于文件字體的定義要寫成UTF-8，如下所示：<?xmlversion="1.0"encoding="UTF-8"?>4.2.4Servlet的版本一般由于servlet的版本導(dǎo)致的錯誤很少見，潤乾支持的servlet版本是servlet2.3，低于此版本servlet就不支持。一般來說比較早期的應(yīng)用服務(wù)器，其servlet版本比較低，可能會低于servlet2.3。我們目前為止僅僅遇到過websphere4.0，其servlet版本比較低，但是也有解決辦法，就是把websphere5.0里的相關(guān)jar包拷貝過去替換掉，即可解決問題，websphere4.0本身往高版本兼容。4.3操作系統(tǒng)的差異中文問題圖形問題4.3.1中文問題現(xiàn)象：如果含有帶斜線的單元格或者統(tǒng)計圖的報表在網(wǎng)頁上發(fā)布時，統(tǒng)計圖或斜線單元格里的漢字會變成小方框，此時往往是服務(wù)器端操作系統(tǒng)的中文安裝包沒有裝全，導(dǎo)致報表里用到的字體在服務(wù)器端的操作系統(tǒng)里找不到，因此成了小方塊解決方法—1.拷貝中文字體1、在啟動java的時候加入如下參數(shù)，參數(shù)值為jdk的安裝路徑-Dsun.java2d.fontpath=……/j2se/jre/lib/fonts2、操作系統(tǒng)安裝完整的中文安裝包，然后把操作系統(tǒng)的中文字體文件拷貝到……/j2se/jre/lib/fonts目錄下

3、打開……/j2se/jre/lib目錄下的perties文件，把新添加的字體文件的對照信息加進(jìn)該文件即可

4、重起webserver解決方法—2.安裝中文包1、操作系統(tǒng)安裝完整的中文安裝包2、卸載jdk，重新安裝，讓jdk讀取新的中文字體文件4.3.2圖形問題現(xiàn)象：含有帶斜線的或自動換行的單元格或者統(tǒng)計圖的報表在網(wǎng)頁上發(fā)布時，報表不能瀏覽錯誤信息：rootcausejava.lang.NoClassDefFoundErrorjava.lang.Class.forName0(NativeMethod)java.lang.Class.forName(Class.java:141)java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment(GraphicsEnvironment.java:62)解決方法—1.升級jdk把JDK升級到1.4及以上版本由于潤乾報表是被集成的，應(yīng)用中往往還有用戶自己的程序，如果服務(wù)器先裝載用戶自己的初始化程序，而該初始化程序的部分代碼可能存在干擾，導(dǎo)致潤乾報表設(shè)置的–Djava.awt.headless=true參數(shù)不管用。此時必須在用戶自己的初始化程序中或者應(yīng)用服務(wù)器的啟動java的命令中加入該參數(shù)。

解決方法—2.啟動x-window目的：創(chuàng)建一個圖形環(huán)境，在x－window環(huán)境下啟動服務(wù)器命令：startx某些用戶的服務(wù)器機(jī)房不能隨便出入，因此對服務(wù)器的操作只能通過終端來進(jìn)行，此時可以在啟動服務(wù)器的X-WINDOW后，用一個終端連接該X-WINDOW，保持連接，不要斷開，然后重起應(yīng)用服務(wù)器即可。如果系統(tǒng)運行過程中，該終端被斷開了，就需要重新連接，并重起應(yīng)用服務(wù)器。

解決方法—3.部署pja環(huán)境下載地址：部署pja：搜索web服務(wù)器名pja例如：weblogicpjawebspherepja4.4數(shù)據(jù)庫的連接問題常見現(xiàn)象原因與解決方法4.4.1數(shù)據(jù)庫連接不上－－－現(xiàn)象:產(chǎn)生數(shù)據(jù)工廠:com.runqian.report4.dataset.SQLDataSetFactory失敗錯誤來源：:CannotcreatePoolableConnectionFactory(socketcreationerror)錯誤來源：CannotcreatePoolableConnectionFactory(socketcreationerror)4.4.2數(shù)據(jù)庫連接不上－－－解決方法1、連接池配置錯誤（driver\url\user\password等寫法有誤）2、報表模板的數(shù)據(jù)集配置中的數(shù)據(jù)源名稱、web.xml中的datasource名稱、及應(yīng)用服務(wù)器的jndi名稱，三者存在不一致的現(xiàn)象3、reportConfig.xml中數(shù)據(jù)源沒有配置4、jdbc包缺失、版本不正確，或者沒有正確放在應(yīng)用服務(wù)器的java類路徑下4.4.3字符集配置錯誤錯誤信息報表中所有從數(shù)據(jù)庫中取出的中文亂碼解決方法將reportConfig.xml中dataSource對應(yīng)的值中第4個選項由GBK改為ISO-8859-1或由ISO-8859-1改為GBK即可<init-param><param-name>dataSource</param-name><param-value>ora9i,ORACLE,1,GBK,GBK,0;</param-value></init-param>

數(shù)據(jù)源的JNDI名稱,數(shù)據(jù)庫類型[,取數(shù)時是否需要轉(zhuǎn)換編碼,數(shù)據(jù)庫字符集編碼,顯示報表時的字符集編碼][,SQL是否需要轉(zhuǎn)碼];

4.4.3sql需要轉(zhuǎn)碼錯誤信息帶中文的查詢語句或更新語句出現(xiàn)亂碼解決方法將web.xml中dataSource對應(yīng)的值中第3個選項0改為1即可<init-param><param-name>dataSource</param-name><param-value>ora9i,ORACLE,1,GBK,GBK,0;</param-value></init-param>4.5性能優(yōu)化通過配置文件reportConfig.xml調(diào)整jvm及服務(wù)器性能4.5.1配置reportConfig.xml文件<config><name>maxConcurrentForReport</name><value>9999</value>同時計算的報表的個數(shù)

</config><config><name>maxWaitForReport</name><value>9999</value>等待計算的報表的個數(shù)</config><config><name>maxWaitTimeForReport</name><value>9999</value>等待計算的最大時間</config>4.5.2調(diào)整jvm及服務(wù)器性能java堆大小-Xms128m-Xmx300m報表并發(fā)數(shù)控制數(shù)據(jù)庫連接池連接個數(shù)配置webserver的連接數(shù)限制常見問題小節(jié)五編程接口入門5.1報表發(fā)布--TAG標(biāo)簽Tag標(biāo)簽html報表代碼<report:htmlname="report1"report"1.raq“/>練習(xí)：簡單使用寫一個jsp通過Tag展現(xiàn)報表通過報表模板直接展現(xiàn)報表例子<report:html name="report1" report"1.raq“/>5.2TAG控制功能funcBarLocation功能條的位置Separator各功能鈕間的分隔符funcBarFontFace功能條的字體funcBarFontSize

功能條的字體大小funcBarFontColor

功能條的字體顏色functionBarColor功能條背景色needSaveAsExcel存為Excel的功能鈕yes或noneedSaveAsPdf存為PDF的功能鈕yes或noneedSaveAsWord存為Word的功能鈕yes或noneedSaveAsText存為Text的功能鈕yes或noneedPrint打印報表的功能鈕yes或no練習(xí)：功能控制寫Jsp通過Tag標(biāo)簽在網(wǎng)頁對報表進(jìn)行展現(xiàn)，要求正確分頁、能導(dǎo)出excel\pdf\word\text等，能彈出打印的applet并打印5.2.1捕獲異常信息標(biāo)簽中加入：exceptionPage="/errorpage.jsp“<%@pagecontentType="text/html;charset=GBK"%> <% Throwablee=(Throwable)request.getAttribute("exception"); out.println("<divstyle='color:red'>"+e.getMessage()+"</div>"); %>

5.2.2raq版本混亂常見問題.現(xiàn)象:java.io.StreamCorruptedException:invalidstreamheaderatjava.io.ObjectInputStream.readStreamHeader(ObjectInputStream.java:737)atjava.io.ObjectInputStream.<init>(ObjectInputStream.java:253)atcom.runqian.report4.util.ReportUtils.read(UnknownSource:40)atcom.runqian.report4.view.ReportCalculator.calc(UnknownSource:72)atcom.runqian.report4.tag.HtmlTag.doStartTag(UnknownSource:287)原因:3.5的設(shè)計器做的raq文件,在4.0的服務(wù)器上發(fā)布.解決方法:1.用4.0的設(shè)計器,重新設(shè)計報表.

2.使用4.0設(shè)計器的報表遷移功能.將3.5版的raq轉(zhuǎn)為4.0版5.2.3設(shè)計器與服務(wù)器jar包不一致現(xiàn)象:[2007-06-1715:17:22]runqianReportLogger:[ERROR]-error：java.io.OptionalDataExceptionatjava.io.ObjectInputStream.readObject0(ObjectInputStream.java:1231)atjava.io.ObjectInputStream.readObject(ObjectInputStream.java:324)atcom.runqian.report4.usermodel.PrintSetup.readExternal(UnknownSource:1134)atjava.io.ObjectInputStream.readExternalData(ObjectInputStream.java:1686)atjava.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:1644)atjava.io.ObjectInputStream.readObject0(ObjectInputStream.java:1274)原因:設(shè)計器與服務(wù)器report4.jar不一致.解決方法:將設(shè)計器report4.jar與服務(wù)器report4.jar包保持一致.資料下載地址1、報表設(shè)計文檔下載潤乾報表用戶手冊、FAQ、例子，及練習(xí)2、部署文檔下載客戶端打印設(shè)置保存說明、潤乾報表V3.5在非J2EE架構(gòu)的W