润乾报表在j2ee下的部署第2页培训安排时间：AM 9:3012:00 PM 13:30 16:30方式：讲解+练习第3页培训目标了解润乾报表WEB架构；熟悉润乾报表WEB报表展现机制；学会在J2EE WEB服务器上部署润乾报表；TomcatWeblogicWebSphere学会在J2EE WEB应用中发布报表；润乾报表缓存配置第4页培训内容一、了解润乾报表WEB架构二、熟悉部署流程和步骤三、部署润乾报表四、发布报表以及TAG标签的应用 五、润乾报表缓存配置六、常见部署发布问题第5页一、润乾报表的WEB架构润乾报表总体结构润乾报表-WEB应用结构润乾报表-计算流程第6页润乾报表总体结构W E B 应 用 服 务 器部署了润乾的WEB应用报表模块客戶端 服务器J2EE应用服务器WEB应用WEB应用权限管理模块办公管理模块报表引擎报表模板报表是应用的 一部分！第7页润乾报表-WEB应用结构Web 服务器应用系统输出报表到指定 目录或发送EMAIL数据库打印或输出 结果文档报表文件(*.raq)浏览器或文件系统润乾报表引擎报表调度器润乾报表设计器第8页润乾报表-计算流程浏览器JSP 文件报表引擎TAGAPIReportEngine报表模板数据文件Contextconfig数据源配置 授权配置 日志配置 语义层配置 缓存配置 Html Tag Param tag第9页二、部署流程和步骤配置应用 服务器的 数据库连 接池创 建 新 应 用拷贝润 乾报表 web发 布包配置润 乾相关 的配置 文件发 布 报 表 应 用打 wa r包Web应用配置不同服务器配置方 式不一样润乾报表核心配置 文件 reportConfig.xml第10页2.1、安装J2EE WEB服务器Tomcat拷贝安装目录Weblogic安装创建domainWebSphere安装第11页2.1.1准备JDBC驱动Tomcat拷贝JDBC驱动到common/libWeblogic修改cmd文件添加jdbc到classpathWebsphere拷贝文件AppServerlib第12页2.1.2创建数据库连接池Tomcat修改配置文件Weblogic控制台Webspher控制台第13页三、部署润乾报表安装服务器准备环境创建发布润乾报表应用第14页3.1创建应用手动创建新应用创建目录拷贝文件手工修改配置文件导出开发环境中的应用发布应用选择授权文件选择服务器配置数据源第15页3.1.1应用目录结构应用目录WEB-INFclasseslibweb.xml第16页练习：创建应用创建名为runqian的应用 必须含有WEB-INF目录WEB-INFclasseslib第17页3.2复制报表引擎程序包七个jar程序包配置文件四个配置文件第18页练习：复制润乾报表引擎复制报表引擎七个jar包四个配置文件 操作：七个jar包拷贝到.runqianWEB-INFlib四个配置文件拷贝到.runqianWEB-INF第19页3.3复制报表打印程序程序包runqianReport4Applet.jar第三方插件j2re-1_4_1-windows-i586-i.exej2re-1_4_2_08-linux-i586.rpm复制位置应用根目录第20页练习：复制打印程序程序包runqianReport4Applet.jar widonws ：j2re-1_4_1-windows-i586-i.exe Linux：j2re-1_4_2_08-linux-i586.rpm第21页3.4相关的配置文件1. reportConfig.xml配置2. runqianReportLog.properties日志配置3. web.xml配置第22页3.4.1 报表引擎基本配置 license Server.lic授权文件reportFileHome /reportFiles报表模板位置semanticsFile /WEB-INF/demo.xml语义层文件JNDIPrefix java:comp/envJNDI前缀dataSource hsql,sqlsvr,1,iso8859-1,GBK,1;exercise,sqlsvr,1,iso8859-1,GBK,0 数据源配置 数据源的JNDI名称, 数据库类型,取数时 是否需要转换编码, 数据库字符集编码, 显示报表时的字符集 编码,SQL是否需要 转码; 第23页3.4.2各服务器部署差异JNDI前缀不同服务器JNDI前缀说明 Tomcatjava:comp/env4.1修改server.xml Weblogic无 Webspher无 Resinjava:comp/envConf.xml Oracle IASjdbc第24页3.4.3报表引擎缓存配置cachedParamsTimeout120 参数在缓存中保存的时间cachedReportDirc:runqiancached 报表缓存的文件夹cachedIdPrefixA 报表缓存的前缀 cachedReportTimeout120 报表缓存保存的时间cachedToDiskOnlyno缓存时是否只保存在硬盘上第25页3.4.4报表引擎并发配置maxConcurrentForReport9999 同时计算的报表的个数 maxWaitForReport9999 等待计算的报表的个数 maxWaitTimeForReport9999 等待计算的最大时间 第26页3.4.5配置润乾日志/日志级别可为OFF,ERROR,WARN,INFO,DEBUG,ALL, 优先级依次降低，若为OFF则 不输出任何 /日志信息；若为INFO，则只输出ERROR,WARN,INFO等级别的信息，依次类推。log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2 日志级别/输出日志到系统控制台 log4j.appender.LOG1=org.apache.log4j.ConsoleAppender log4j.appender.LOG1.layout=org.apache.log4j.PatternLayout log4j.appender.LOG1.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %c : % -5p %x - %m%n/输出日志到指定文件 log4j.appender.LOG2=org.apache.log4j.RollingFileAppender /可以指定LOG2.File的全路径, 若未指明，则为相对WEB服务器启动文件的路径 log4j.appender.LOG2.File=runqianReport.log 日志文件第27页3.4.6Web.xml配置信息reportServletcom.runqian.report4.view.ReportServletconfigFile/WEB-INF/reportConfig.xml2reportServlet/reportServlet/WEB-INF/runqianReport4.tld/WEB-INF/runqianReport4.tld第28页3.5优化配置JVM java堆大小 -Xms128m -Xmx300m 报表并发数控制数据库连接池连接个数配置webserver的连接数限制Websphere中:服务器-应用程序服务器-server-进程定义-java虚拟机第29页创建好的应用结构Web.xml-应用配置文件reportConfig.xml-报表配置文件runqianReportLog.properties-日 志sales.xml-语义层定义文 件第30页导出方式生成应用向导式发布报表应用第31页3.7Jar命令打war包开始 运行 cmd 进入应用所在的目录jar 查看帮助jar cvf runqian.war *.*第32页练习：把应用打成war用jar命令把配置好的应用打成war包注意事项： 不同应用服务器中注意修改jndi名称应用中尽量不要有中文名称尽量删除web.xml的中文注释第33页发布应用到服务器Tomcat修改配置文件Weblogic控制台Webspher控制台只能发布war文件发布过程密切 关注服务器是 否有异常信息 抛出！第34页测试应用测试JSP确定应用正常测试报表测试报表授权配置正确确定数据源配置正确确定语义层配置正确第35页四、TAG标签应用标签的分类html报表参数传递param参数表单行式报表异常捕获第36页4.1Tag标签的使用引入Tag定义使用Tag对象第37页4.2Tag:html报表目的在网页上展现报表前提报表已经设计出来，并且存放在应用可以访问的路径 中实现机理直接解析报表模板计算报表通过报表对象展现报表提供打印、导入、导出等功能菜单的生成可设置报表网页上展现的格式如：高宽、固定表头等第38页功能菜单功能翻页打印导出提交位置顶部尾部同时开关needPageMark=“yes or no“needSaveAsWord=“yes or no“needSaveAsExcel=“yes or no“needSaveAsPdf=“yes or no“needPrint=“yes or no“标签importExcelLabel=“导入excel“wordLabel=“导出WORD“excelLabel=“导出Excel“pdfLabel=“导出PDF“printLabel=“打印“第39页练习：简单使用写一个jsp通过Tag展现报表通过报表模板直接展现报表例子第40页4.3参数传递写一个jsp通过Tag展现报表通过报表模板直接展现报表例子注：参数之间用;隔开第41页4.3.1动态参数传递如果参数值或宏值是变化的，那么应该先在JSP代码中 将参数串拼好，再传入Tag中，如下所示：“/第42页4.3.2隐藏参数传递设置hiddenParams属性：“/WEB中一般有一些全局的变 量，如登录用户名、用户角 色等，而在报表中可能会用 到这些作为参数值，那么在 用参数表单时怎么将这些值 传进去呢？第43页4.4关联查询第44页关联查询同一Jsp中实现关联查询1.定义参数表单报表、查询结果报表2.写一个Jsp嵌入param与html标签注意：可通过属性传递隐藏参数到参数报表中！第45页4.5行式填报式报表的属性属性名是否必填属性含义 insertRowLabe l否插入行按钮外观定义appendRowLa bel否添加行按钮外观定义deleteRowLab el否删除行按钮外观定义第46页4.6异常处理普通报表计算异常处理exceptionPage -当Tag标签在计算报表遇到错误的 时候可以通过该属性设置异常跳转页面填报表数据填报异常inputExceptionPage -当填报表数据填报遇到异常的 时候可以通过该属性捕获异常异常捕获Tag标签将异常以exception为关键字放在request中可 以按如下方式得到：例： Exception e = ( Exception ) request.getAttribute( “exception“ );第47页Tag小结常用Tag标签HtmlParamTag属性报表定义显示风格设置高级属性数据库连接