J2EE环境下快逸报表的部署指南

需积分: 10 4 下载量 77 浏览量 更新于2024-09-12 收藏 63KB DOCX 举报
"这篇文档主要介绍了快逸报表在J2EE环境下的部署方法,包括关键步骤和配置细节。" 在J2EE环境下部署快逸报表,这是一个涉及到企业级Java应用程序集成开源报表系统的实践过程。快逸报表是一款强大的报表工具,能够帮助开发者生成和管理各种复杂的报表,而J2EE(Java 2 Platform, Enterprise Edition)则是一个用于构建和部署分布式企业级应用程序的平台。以下是详细的部署流程和步骤: 一、部署流程 1. 准备工作:确保你的开发环境中已经安装了适合的J2EE应用服务器,如Tomcat、JBoss或WebLogic等。 2. 集成报表引擎:将快逸报表的库文件(如.jar或.war)复制到应用服务器的相应目录下。 3. 配置web.xml:根据应用服务器的规定,正确地配置web.xml文件以启动和配置报表服务。 4. 测试与调整:启动应用服务器,验证报表服务是否能正常工作,并根据需要进行调整。 二、具体步骤 1. 复制报表引擎:不是简单地将整个报表引擎目录复制到你的项目中,而是要精细操作。特别注意的是,不要直接拷贝web.xml文件,而是将快逸报表的web.xml文件内容提取出来,插入到你的项目web.xml文件中。这是因为每个应用服务器对web.xml的解析规则可能略有不同,所以需要根据实际情况来调整。 2. 配置web.xml:这是部署的关键部分。你需要在你的web.xml中添加报表系统所依赖的servlet和taglib配置。例如,`<servlet>`标签定义了一个名为`reportServlet`的servlet,该servlet负责处理报表请求,类路径是`com.runqian.report4.view.ReportServlet`。`<init-param>`用于设置初始化参数,如`configFile`指定报表配置文件的位置,`headless`参数可能用于控制报表渲染是否无头模式。`<servlet-mapping>`则定义了servlet的URL映射,使得通过`/reportServlet`可以访问报表服务。此外,`<taglib>`元素用于声明自定义的标签库,这里指定了`runqianReport4.tld`的URI和位置。 3. 配置其他文件:除了web.xml,可能还需要配置其他的配置文件,如`reportConfig.xml`,它通常位于`/WEB-INF`目录下,用于设定报表系统的具体配置,如数据源、报表模板等。 4. 最后,记得在完成所有配置后,重启应用服务器,确保新的配置生效。 部署过程中,需要注意的是,不同的J2EE应用服务器可能有不同的部署规范和配置要求,因此在实际操作时,需要根据所使用的应用服务器文档进行相应调整。此外,如果遇到任何问题,查阅快逸报表的官方文档或者社区论坛,通常能找到解决方法。在测试阶段,应确保报表能正确加载,运行无误,同时也要关注性能和安全性,以满足生产环境的需求。
2012-05-21 上传
快逸报表使用 在网上找个很多资料,也按着资料去尝试了多次,最终都以失败告终,也发现大部分文章都是拷贝粘贴来的,真不知道那些作者怎么想的,为什么不亲身测试后再贴到自己博客里呢,好了,废话少说,经过那么多次失败,最终亲测成功,特别整理发表,为那些刚接触快逸报表的同胞们省去不必要浪费的时间. 一. 下载并安装快逸报表软件工具 下载安装不需要过多赘述,跟安装日常软件没什么区别,值得提到的是必须先安装好环境, 先安装 JDK,还有Tomcat 相关的配置步骤网上很多资料,相信不会难倒读者.笔者使用快逸报表版本为4.2.20,JDK1.5,Tomcat 6.0. 二. 报表设计 (1)关于授权 打开报表设计器,如果提示授权的话,你可以到安装目录下找到,笔者安装在了C盘, 所以目录如下C:\ProgramFiles\quieeReport\webapps\quiee\WEB-INF\classes 可以看到相关的授权. (2)配置数据源 打开设计器之后, 安装后打开报表设计器,选择配置-数据源-新建-关系数据库,开始配置数据源,笔者用的是mysql,以mysql举例: 其中关键位置如下: 数据源名称要记住,因为在部署的时候,配置数据库时名字要和这保持一致.数据库类型选择相应的类型,数据源URL默认不是本机,需要修改,当然如果在其他机器上需要填写相应的IP地址,后面填写相应的数据库名字.下面填写数据用户名和密码.完成之后回到数据源窗口,选择刚创建的数据源,点击连接,数据源变色说明连接成功。.关闭窗口. (3)配置数据集创建报表 选择文件-新建报表,打开新建报表向导,填写数据源,下一步 注意数据源的名字也要保持一致,点击 下一步,按着提示进行下一步就可以, 最后点击生成网格报表,报表就生成了. 报表的表头可以修改为中文 完成之后,启动快逸报表的服务,将报表保存发布. 四个图标左边第三个是进行发布的,点击会提示进行保存报表,按提示进行保存.之后可以点击IE图标进行预览. 三. 在J2EE中部署快逸报表 在已有的 J2EE 项目中使用刚才创建的报表,需要如下步骤: (1) 导入 jar 包和相关文件 (a)将快逸报表安装目录\quieeReport\webapps\quiee\WEB-INF\lib中的 jar 包导入项目,并且导入所需要的mysql驱动包. (b)将\quieeReport\webapps\quiee\WEB-INF 目录下的 reportConfig.xml,runqianReport4.tld,runqianReportLog.properties 复制到项目的 WEB-INF 目录 (c)将\quieeReport\webapps\quiee 目录下的 j2re-1_4_1-windows-i586-i.exe,Myerror.jsp,myInputError.jsp, runqianReport4Applet.jar 和 images 目录(用于工具按 钮的图片可自选)复制到项目的 WebRoot 目录下。 (2) 修改web.xml文件 在 web.xml 文件中增加如下内容: <servlet> <servlet-name>SetContextServlet</servlet-name> <servlet-class>com.runqian.util.webutil.SetContextServlet</servlet-class> <load-on-startup>2</load-on-startup> </servlet> <servlet> <servlet-name>reportServlet</servlet-name> <servlet-class>com.runqian.report4.view.ReportServlet</servlet-class> <init-param>     <param-name>configFile</param-name> <param-value>/WEB-INF/reportConfig.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>reportServlet</servlet-name> <url-pattern>/reportServlet</url-pattern> </servlet-mapping> (3) 创建jsp文件 可以直接使用\quieeReport\webapps\quiee\reportJsp目录下的 showReport.jsp和 toolbar.jsp 文件。其中 showReport.jsp 用于显示报表,toolbar.jsp 用于显示工具按钮。 (4) 在项目中导入报表文件 在上面发布报表的路径下找到报表文件,将生成的.raq 报表文件导入项目。 (5) 添加授权文件 复制quieeReport\webapps\quiee\WEB-INF\classes目录下的授权文件,根据使用的操作系统进行选择, 到项目的 WebRoot 目录, 可能需要修改 reportConfig.xml 文件中的部分内容. 如果你用的不是window系统,更改成与您对应的授权的文件.特别注意的是”/”反斜杠符号 ,拷贝过来的文件里原本是没有的 (6) 修改reportConfig.xml文件 在其中添加如下配置内容,主要用于数据库的连接,需要主要的地方是name参数,需要跟报表文件的数据源名称一致. <!-- 配置快逸加载数据时候的datasource --> <jdbc-ds-configs> <jdbc-ds-config> <name>mysql</name> <db-type>mysql</db-type> <connection-url> jdbc:mysql://localhost:3306/test </connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <user-name>root</user-name> <password>123</password> <db-charset>gbk</db-charset> <client-charset>gbk</client-charset> <extend-properties></extend-properties> </jdbc-ds-config> </jdbc-ds-configs> 注意的地方: 这个地方一定要和制作报表时候的数据源名字一致, (7) 访问报表 发布上述 J2EE 项目,启动 tomcat,访问报表的 url 地址 为: 项目名称/reportJsp/showReport.jsp?raq=/报表名称.raq 就可以看到我之前做的报表,这个时候很多人会发现出现找不到报表配置文件的错误,而且这个问题也困扰了我很久,网上找了资料,按其操作并没有解决,经过又查找资料,终于找到问题根源,在于jar包的问题,其中一个很重要的jar包---webutil.jar,快逸报表自身带的jar是不能用的,本人所用版本这个jar包为3.6kb,替换成一个网上找打一个新的4.05kb大小的webutil.jar后,问题解决了.