FineReport报表及J2EE应用的集成.pdf

FineReport报表和J2EE应用的集成 FineReport是一个纯Java软件，因此对于J2EE 的项目，可以做到无缝集成。 报表服务器并非物理概念的服务器，而是以一个标准的J2EE应用的形式或者jar 包的形式 提交给程序。应用程序通过url来调用报表，或者通过开放的API来调用报表的各种功能， 来实现更加灵活的控制。报表集成到应用程序后，即可作为一个统一完整的程序来进行发布。 同时无缝集成还能够使报表与应用程序使用同一个数据库连接池，或进行集群，负载均衡等， 提高报表的运行效率，原理图如图1所示： 图1Java项目集成原理图 报表工程目录结构 在说明配置FineReport服务器之前，我们先了解一下FineReport应用服务的目录结 构： 对上图的目录层次结构我们做一些说明： WebReport：可以看到所有的相关文件都包含在WebReport这个服务器应用工程中，也就 是说WebReport是我们默认的工程名，此项名字可以修改。 WEB-INF：WEB-INF 目录是J2EE服务器中默认规定的，全称是Web Information。 classes：classes 文件夹也是应用服务器默认规定的。主要作用是存放.class文件，例如在 FineReport中，如果要使用 自定义函数，程序数据源 和 程序网 络报表 等功能，必需先 使用我们提供的接口来编写.java文件，然后将编译后产生的.class文件存放到该目录下。 lib：lib 也是应用服务器规定的目录结构。FineReport该目录下主要包括fr-server-6.5.jar， 第三方类的jar 文件和一些常用数据库 JDBC驱动，比如ojdbc14.jar就是Oracle数据库的 驱动，应用服务器在启动的时候会自动将lib 目录下所有的.jar文件加载到系统的 classpath 中；fr-server-6.5.jar包含了FineReport服务器的所有功能，它是由FineReport源文件编译 后产生 的.class类文件。例如：Servlet类com.fr.web.ReportServlet便位于fr-server-6.5.jar 中。 reportlets：reportlets是FineReport服务器默认规定的，不能修改。可以在这个目录下面建 立子目录文件夹，FineReport设计器设计的模板一般都保存在这个目录或者它的子目录下 面，以便FineReport服务器调用。 resources：resources 是FineReport服务器默认规定的，不能修改。下面保存了一些.xml 文件，这些.xml文件里面保存着FineReport服务器的配置等信息，FineReport服务器启动 的时候，会自动加载这些.xml文件（有些xml文件不是运行必需的）。 web.xml：这个文件也是J2EE服务器所规定必须建立的，我们在此文件中定义了FineReport 的SERVLET 的解析路径方式，权限加载等一些内容，此文件初始配置内容如下： 1.?xmlversion=1.0 encoding=UTF-8? 2.web-appxmlns=/xml/ns/j2ee xmlns:xsi=/2001/ XMLSchema-instance xsi:schemaLocation=/xml/ns/j2ee http://java. /xml/ns/j2ee/web-app_2_4.xsd version=2.4 3.servlet 4.servlet-nameReportServer/servlet-name 5.servlet-classcom.fr.web.ReportServlet/servlet-class 6.load-on-startup0/load-on-startup 7./servlet 8.servlet-mapping 9.servlet-nameReportServer/servlet-name 10.url-pattern/ReportServer/url-pattern 11./servlet-mapping 12./web-app 报表集成步骤 1、 服务器部署 FineReport报表是一个Servlet应用。大 家知道，Servlet是一种服务器端的Java应用程 序，具有独立于平台和协议的特性，可以生成动态的Web页面。 它担当客户请求（Web 浏览器或其他HTTP客户程序）与服务器响应 （HTTP服务器上的数据库或应用程序）的中 间层。Servlet是位