搜索
一、JavaReport介绍JavaReport主要有如下优点。（1）支持实时的、动态的Web统计报表JavaReport所展示的报表是动态的报表。所有的数据都是实时的数据；所有的统计图也是动态生成的。报表里面的数据源可从数据库中即时查询产生，适合于对实时统计要求高的应用系统。（2）接口丰富，对图表提供良好的支持JavaReport提供了丰富的应用程序接口、减少代码复用、灵活的图表形式、即时图表生成、更短的生成时间等。Java报表对图表有良好的支持，可以生成柱图、饼图和折线图等十几种图表。（3）报表可导出成各种格式的文档JavaReport在报表展现方面表现优异，能实现Word，Excel，PDF，CSV等格式精确导出等功能，并提供了全部的页面与打印控制。（4）开发简便，程序员只须编写少量程序代码有许多的问题在JavaReport组件内已经解决，如报表的导出功能、打印功能和数据的分页处理等。在很多B/S结构体系的系统开发时，分页是开发过程中要重点考虑的问题。但在JavaReport中，就不需要考虑上下翻页，跨页分页，因为这些问题报表引擎已经实现了。在设计报表的过程中，把Report类当作容器类，统计图类，表格类，标签类，图片类等，把它们当作组件类。至于跨页分页，上下翻页由报表引擎自动完成。JavaReport系统中有自动跨页分页的功能，当表格超过当前页的大小时，系统会自动把接着部分放到下一页。报表设计在开发过程中是感觉不到要跨页的存在，只有一个全部数据完整的表格对象。如果把引入图片文件加入到报表中，可使用报表系统的Report类，通过这个类的addImage()方法把Image对象加进来，如果需要自定义图像，可通过第三方画图程序（例如是JFreeChart程序）生产需要的统计图/图片，然后再把图像加到报表中去。本书中使用的JavaReport版本是V3.0，JavaReport根据客户的应用需要，按照功能和性能的等级，分成三个版本：专业版，服务器版，企业版。本书使用企业版。JavaReport三个版本产品都是免费使用的。也就是说这三个版本都不需要购买License许可，可以自由使用JavaReport的所有功能。免费提供报表在Web展示功能，表和图怎样混合功能，跨页分页功能，导出电子文档Word，PDF，Excel，CSV，HTML等诸多功能。专业版客户（Client）的IP最大连接数限制为10个，也就是JavaReport同时并行处理线程的最大数受限制。限制是为了避免系统资源占用过大，使系统反应迟钝。该版本适合中小型的应用系统，保障应用系统正常运行。服务器版在最大连接数没有受限，它能充分发挥服务器的个部分硬件设备的作用；相对要求服务器的设备配置高，保障最优性能效率。该版本适合大中型的应用系统使用。企业版提供垃圾回收机制管理，自动处理在内存中无用对象的引用；支持多服务器处理模式，提供在多个服务器的集群功能和服务器之间负载均衡功能。提高服务器群的负载能力和和快速响应能力。该版本适合负载繁重的应用系统使用。二、安装JavaReport找到JavaReport-V3-Enterprise-Released.jar这个Jar文件，把这个文件的路径加入到classpath系统变量中，或拷贝到当前Web应用的WEB-INF\lib目录下，或拷贝到Tomcat5的安装目录的common\lib目录中；第一种方法和第三种方法对所有Web应用有效，而第二种方法仅对当前Web应用有效。好了，至此，JavaReport就算安装完毕了。接下来，继续介绍JavaReport。三、相关类介绍下面给出Web报表显示时的情况，如图17-11所示。在这个图中，对报表的显示情况一目了然，再介绍常用的类理解起来就会比较清晰了。JavaReport的组件包中有许多的类，体系庞大而复杂，在这里无法一一介绍，仅列出一些常用的类来作出说明，有兴趣的可参考详细的API手册。（1）WebReportEngine类即com.javareport.http.WebReportEngine，这个类是整个JavaReport中的Web引擎的开发接口。所有的JSP或Servlet从这个类继承下来，覆盖createReport（）函数就实现基本的报表开发工作。WebReportEngine是JavaReport的Servlet或JSP的开发接口，是JSP或Servlet的父类，报表系统在应用中的程序从此处继承下来，可以根据需要调整接口内容。部分函数可以适当删除。在开发中一般是实现createReport（）函数就可以，形成实时动态报表就是在这个函数里实现的。剩下的工作（怎样在Web上显示，怎样形成Work，PDF文件，等）交给报表引擎自动实现。如果是在JSP中，在页头部分应加入如下语句：%@pageextends=com.javareport.http.WebReportEngine%如果是Servlet，相应的Servlet类声明时语句如下：publicclassServlet类名称extendsWebReportEngine{……}?createReport()方法原型如下：publicReportcreateReport(javax.servlet.http.HttpServletRequestrequest)throwsjava.lang.Exception此方法用于建立报表，并返回报表的实例。这个报表实例可以在Web上显示，同时也可以导出Word,Excel,PDF,CSV,HTML等格式的文档以供使用。参数request可用于获取所有的动态请求的数据。?validate()此方法用于对上一个页面Form提交的参数进行检查，由于实时报表需要动态的参数，在这里进行数据校验。方法原型如下：publicjava.lang.Stringvalidate(javax.servlet.http.HttpServletRequestrequest)其中，参数request可用于获取所有的动态请求的数据；方法的返回值为null时代表通过，其他内容则为参数错误的提示信息。?getStartScript()方法用于构造报表内容在Web页面上显示之前执行的JavaScript或VBScript脚本，如果要定制则要重载这个方法。方法原型如下：publicjava.lang.StringgetStartScript(javax.servlet.http.HttpServletRequestrequest)其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表没有脚本内容。?getEndScript()方法用于构造报表内容在Web页面上显示之后执行的JavaScript或VBScript脚本，如果要定制则要重载这个方法。方法原型如下：publicjava.lang.StringgetEndScript(javax.servlet.http.HttpServletRequestrequest)其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表没有脚本内容。?getToolbarScript()方法用于定制Web报表在页面首部显示的工具栏为标准的样式（上下翻页，导出文件），可以在此扩展工具栏的内容，如：添加公司主页的链接，返回上一层链接的“返回”按钮，如果要定制则要重载这个方法。方法原型如下：publicjava.lang.StringgetToolbarScript(javax.servlet.http.HttpServletRequestrequest)其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表不添加内容。?isShowToolbar()如果不想在页面上显示报表工具栏，可重载这个方法，并设定返回值为false。需要注意的是，如果是多页报表，上下翻页按钮就无法使用。方法原型如下：publicbooleanisShowToolbar()方法的返回值是是否显示工具栏的布尔值标志。?getAllEchoButton()方法用于自定义显示在Web页面中的报表导出文件的按钮，比如应用中只导出PDF文件，其他的不需要，就可以这里设定。按钮值从Word按钮开始是（1，2，4，8，...），需要显示的按钮则将它们的值相加就可以了。默认情况下工具栏上的按钮如图17-12所示：图17-12默认情况下工具栏上的按钮方法原型如下：publicintgetAllEchoButton()方法的返回值是显示按钮对应的和值。要作自定义，需要重载这个方法，并将返回值设为要显示的按钮对应的和值。（2）Report类即com.javareport.beans.Report，报表类。这个类的对象用于代表一张报表，是所有报表元素的容器，这是整个系统的核心，也是在浏览器上显示和生成电子文档（Word，Excel，PDF，Html等）的基础。?addHeaderSeparator()方法用于在报表的页眉添加一条横直线。方法原型如下：publicjava.lang.StringaddHeaderSeparator(intnum)其中，参数num表示横直线的粗细程度，以自然数表示，数字越大表示线越粗。?addHeaderSpace()此方法用于在页眉中添加若干个空格。方法原型如下：publicjava.lang.StringaddHeaderSpace(intnum)其中，参数num是要添加的空格的个数。?addHeaderTab()方法用于在页眉中添加若干个【Tab】键，【Tab】键跟空格键一样是不可见的，默认每个【Tab】为8个空格。方法原型如下：publicjava.lang.StringaddHeaderTab(intnum)其中，参数num是要添加的【Tab】键的个数。?addHeaderBreak()在页眉中添加一个换行符号，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：publicjava.lang.StringaddHeaderBreak()?addHeaderText()在页眉中添加文本信息内容，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：publicjava.lang.StringaddHeaderText(java.lang.Stringtext)其中，参数text是要添加的文本信息内容。其中，{P}代表当前页，{N}代表总页数，如：“第{P}页，共{N}页”。?addChart()在报表中添加图表信息内容。方法原型如下：publicjava.lang.StringaddChart(ChartImplchart)其中，参数chart是要添加的图表，图表类ChartImpl是JavaReport的核心模块，各种各样统计图由图表类生成。?setCurrentFont()设置报表当前的字体。原型如下：publicvoidsetCurrentFont(java.awt.Fontfont)其中，参数是要设置的字体对象，为Java中java.awt.*包中的Font对象。?setCurrentBackground()设置报表当前的背景颜色。原型如下：publicvoidsetCurrentBackground(java.awt.Colorcolor)其中，参数color是要添加的图形对象，为Java中java.awt.*包中的color对象。?setCurrentForeground()设置报表当前的前景颜色。原型如下：publicvoidsetCurrentForeground(java.awt.Colorcolor)其中，参数color是要添加的图形对象，为Java中java.awt.*包中的color对象。?addImage()在报表中添加图片信息内容。原型如下：publicjava.lang.StringaddImage(java.awt.Imageimage)其中，参数image是要添加的图