BlogJava-翠湖月色-随笔分类-报表设计与开发

use japerreports step by step－转贴

matthew — Mon, 29 Jan 2007 06:25:00 GMT

1.下载japerreports：
网址：https://sourceforge.net/projects/jasperreports/
最好下载完整的zip包：jasperreports-1.3.0-project.zip
这样可以得到所有的文件，包括src，samples。

2.下载到jasperreports-1.3.0-project.zip包后，解压一看，本身是一个project，有.project,.classpath文件等，于是想到可以把它做为一个project导入eclipse中，于是把它拷贝到eclipse的workspace中，然后“import”，即可整个jasperreport工程导入到ecplise了！

注意：我刚开始导入时总出错，提示"Invalid project description",无法导入；后来鬼使神差的把解压后的工程名称"jasperreports-1.3.0"改为"jasperreports"就顺利导入了！
再后来，想把工程改为别的名称，但是import时指定工程根目录后，压根就无反应，"finish"按钮始终是灰色的，无法导入；
最后问了一下wwm，才是知道如果要import a project，则project名称要与.project文件的中的名称一致，否则无法导入！
例如，工程名称（根目录）为jasperreports，那么.project中应为：jasperreports；
前面是凑巧改对了。

3.但是导入到eclipse后，它是做为一个java project的，也就方便看源代码而已，到底要怎么才能运行生成报表呢？这就需要ant来执行build.xml。

4.如果没有接触过ant，没关系，很简单的，放心吧。推荐看《java 学习笔记》良葛格附录A Ant简介(网上搜电子版的即可），15分钟即可搞定ant，不要被它挡路了哦:)

5.并且，eclipse中就自带ant，如果要运行"demo\samples\barbecue"示例，进入"jasperreports\demo\samples\barbecue",右键"build.xml",选"run as->ant build.."，把"javac","compile","fill","view"都打上勾,点"run",ant开始运行该build.xml，不一会，哇，看到报表了！好激动！不过这个报表只有表，没有图，即：看不到自己想要的折线图，柱状图，饼图等。

6.看了一些"demo\samples"下的所有示例，觉得折线图，柱状图，饼图等应该都是在"charts"示例中，意识运行"charts"示例的build.xml文件，但是不能编译通过，提示错误：
javac:
    [javac] Compiling 2 source files to E:\jiangcm\workspace-forict-myeclipse\jasperreports\demo\samples\charts
    [javac] 注意： E:\jiangcm\workspace-forict-myeclipse\jasperreports\demo\samples\charts\ChartsApp.java 使用了未经检查或不安全的操作。
    [javac] 注意：要了解详细信息，请使用 -Xlint:unchecked 重新编译。
compile:通过,略.
fill:
      java.sql.SQLException: Connection is broken: Connection refused: connect
      at org.hsqldb.Trace.getError(Unknown Source)
     ……
view:
      net.sf.jasperreports.engine.JRException: java.io.FileNotFoundException: MultipleAxisChartReport.jrprint

7.怎么办呢？上网查jasper的资料，折腾了大半天，还是没有任何进展，网上的资料都只简单的提到“需要ant”执行，唉，真是没办法。只好转向运行"webapp"示例，运行成功了！（详细看运行jasperreport的webapp示例一文）

8.实在不知道为什么最重要的charts示例无法运行，还是先踏踏实实看一下jasperreports的原理吧，于是认真看了"jasperreports 教程"，了解到jasperreports的基本原理：
调用jasperreports的相应的库函数，把.jrxml编译为.jasper；->由.jasper生成.jrprint；->由.jrprint得到各种输出方式的报表。

理解到这一点后，自己就没再往下看，因为能够确定charts示例无法运行绝对与jasperreports的原理无关了。

9.于是，认真分析了一下编译提示的错误，发现主要就是因为编译无法通过造成的，以至于后面缺少对应的.jrprint文件。而编译不通过的原因是“[javac]要了解详细信息，请使用-xlint:unchecked重新编译”，在build.xml中相应位置加上编译参数：

终于编译通过了！！（详细参见“Eclipse中报错"要了解详细信息，请使用-xlint unchecked重新编译"的解决方案”一文）

10.这时javac通过了，即ChartsApp.java编译通过了，但是fill和view这两步还是提示原来的错误,如下所示：
javac:
    [javac] Compiling 2 source files to E:\jiangcm\workspace-forict-myeclipse\jasperreports-1.3.0-project\demo\samples\charts
    [javac] E:\jiangcm\workspace-forict-myeclipse\jasperreports-1.3.0-project\demo\samples\charts\ChartsApp.java:115: 警告： [unchecked] 对作为普通类型 java.util.Map 的成员的 put(K,V) 的调用未经检查
    [javac] parameters.put("MaxOrderID", new Integer(12500));
    [javac] ^
    [javac] 1 警告
compile:
fill:
      java.sql.SQLException: Connection is broken: Connection refused: connect
      at org.hsqldb.Trace.getError(Unknown Source)
view:
      net.sf.jasperreports.engine.JRException: java.io.FileNotFoundException: MultipleAxisChartReport.jrprint
      at net.sf.jasperreports.engine.util.JRLoader.loadObject(JRLoader.java:75)
其中fill这一步提示的是SQLException的错误，难道是要配置数据源或者是要运行什么东西？
再看fill的出错提示：" at org.hsqldb.Trace.getError(Unknown Source)",对了，好像"demo"文件夹里有"hsqldb"文件夹，是不是要先运行"hsqldb"文件夹的内容？？试试。

10.于是ant编译"demo\hsqldb"的build.xml；提示:server is running...
应该是数据库启动了；

11.接着ant编译"demo\samples\charts"的build.xml；顺利fill，耶！看到曲线图、柱状图等报表了！

12.备注：关掉报表再直接运行一次charts的build.xml，还能正确看到报表；关掉eclipse再运行，也也还能正确看到报表；看来hsqldb只要运行过一次，以后就都有效了！至于原理就不太明白了，难道是hsqldb运行过之后就永久的把数据导入到工程的报表中了？有待以后学习验证了。

13.小结：
运行jasperreports示例，关键是要注意和解决三个问题：
1）import project时，工程名称要与.project文件中""中的名称一致，否则无法导入；

2）jdk版本兼容的问题：
加入编译参数：

3）要先运行一下"demo\hsqldb"下的build.xml，启动数据库导入数据，才能fill报表，运行显示报表；
ok！

以上步骤重复验证过两三次均无问题，按上述步骤保证就能运行jasperreports提供的charts关键示例了！

matthew 2007-01-29 14:25 发表评论

myeclipse+tomcat 环境下jasperreports sample之webapp例子－转贴

matthew — Mon, 29 Jan 2007 06:14:00 GMT

一、引子：前期试验工作
1.直接在jasperreports-1.3.0-project工程中运行，ant编译"demo\samples\webapp"的build.xml，可以直接看到由webapp中的.jrxml文件定义的报表格式，但是无法显示数据源的数据；

2.上述ant编译"demo\samples\webapp"的build.xml时，也出现了"-Xlint:unchecked" 和"- Xlint:deprecation"的版本兼容问题的错误，在build.xml中加入编译参数后，没什么变化，依然只是能看到.jrxml文件定义的报表格式，无法显示数据；

3.运行时出错，提示：
viewDesign:
net.sf.jasperreports.engine.JRException: java.io.FileNotFoundException: reports\WebappReport.jasper
at net.sf.jasperreports.engine.util.JRLoader.loadObject(JRLoader.java:75)

查看了一下"webapp\reports"目录，果然没有编译好的WebappReport.jasper文件，那么是操作问题导致编译出错无法把.jrxml编译成.jasper，还是程序本身就没有调用编译设计文件的代码？

4.查看build.xml文件中运行的net.sf.jasperreports.view.JasperDesignViewer类的源代码，以及看build.xml中提供的参数，发现JasperDesignViewer类只是根据传入的.jrxml或者.jasper文件的路径显示报表，并不负责编译和填充xml设计文件；

5.ok，webapp示例应该就是只提供了在web服务器中跑的支持，并不同时提供直接applet方式显示，简单让它能够根据.jrxml或者.jasper源设计文件看一下报表格式而已。因为applet方式显示报表的示例charts中都有了，也没必要提供支持了。

6.所以，如有要显示webapp示例，只能在web服务器中部署运行了。这个示例也正是用来展示web环境下如何使用jasperreports开发报表的！

7.部署webapp示例详见下文；

二、myeclipse+tomcat部署运行jasperreports的webapp示例step by step
1.在eclipse中新建web 工程:"jasperwebappproject"；

2.把"jasperreports-1.3.0-project\demo\samples\webapp"下的所有文件拷贝到新建的web工程("jasperwebappproject")的webroot下；

注意：
* 此时新工程的webroot目录就与原webapp目录结构对应上了(不要把该webapp文件夹也拷贝过去了，因为新建web工程就默认有webroot根目录了)，拷贝时要覆盖掉新建工程时webroot下的原WEB-INF目录；

*一定要确保webapp\WEB-INF\classes目录的下的三个源代码文件夹(datasource、scriptlets、servlets)和web.xml文件都拷贝过去了！！
因为本人操作的时候发现，有时候原WEB-INF文件能够全部拷贝过去，有时候skip掉没有拷贝过去。

*如果没有把该web.xml拷贝过去，将无法运行示例中的servlet samples，并且jsp samples中也无法显示图片！因为web.xml中没有配置ImageServlet：

ImageServlet

net.sf.jasperreports.j2ee.servlets.ImageServlet

ImageServlet

/servlets/image

3.把"jasperreports-1.3.0-project\lib"与"jasperreports-1.3.0-project\dist"下的所有jar包拷贝到新建工程的lib下；
注释：其实只需要拷贝webapp中build.xml文件中要include的jar包，不过本人懒得一一去对了，把所有的jar包都加上，图省事；

4.右键新建工程"jasperwebappproject"->"Properties"->"Java build path"->"source"-"add folder...",把"jasperwebappproject\webroot\WEB-INF\classes"文件夹打上勾，即：把classes文件夹也设置为source folder；因为classes文件夹下有.java源文件，如果不设置为source folder，就需要手工编译了，并且eclipse还可能因为自动编译把该classes的源文件全部清空，因为src是空的。
所以，一定要把classes文件夹设置为source folder；

注：
"Java build path"->"source"中有一选项"allow output folders for source folders",按字面理解应该是把该项选上就是把默认的输出路径WEB-INF\classes设置为source folder了，但是我把它选上了，好像没有效果，只是当时把classes加入source树了，但是下次再查看工程properties还是原样，工程中也没有把classes当作source folder，而且还把classes目录清空了。
选项"allow output folders for source folders"到底是干什么用的呢？不知道了，期待知道的回答一下，万分感谢！

5.此时，我们把webapp下的所有文件和需要的所有jar包都拷贝到新工程了，并且把WEB-INF\classes设置为source folder了；但是如果此时转换到J2EE development视图的话，会发现工程中报了很多错误，主要是.jsp文件和.html文件大量报错。.html文件的错误无关紧要，只是多了一些没有开始标签的结束标签，改不改都不影响运行。但是.jsp文件怎么会报错，提示很多类文件找不到呢？所需要的jar包(包括jasperreports-1.3.0.jar)和数据源等文件(WEB-INF\classes\datasource)都在工程中了呀！
解决：
根据以往经验，eclipse中如果直接把别人的代码复制粘贴上去，即使所有的类文件和jar包都存在，也会报错，需要把该.java源文件重新"剪切"粘贴一下，这样就不报错了。
试了一下，把jsp文件夹下的compile.jsp,fill.jsp,viewer.jsp,html.jsp文件前面部分导入包和类的那些语句(eg.<%@ page import="datasource.*" %>)重新剪切粘贴一下，保存，耶，不提示红×错误了！

注：
不理会eclipse中这些.jsp文件的报错也没关系，因为部署到tomcat后，运行时肯定是能够找到所需要的类的，因为那些jar包都在工程中了。不过在eclipse中看着那么多的红×错误，还是剪切粘贴一下消除它，心里比较爽。

6.把工程部署(deploy)到tomcat中；

7.启动tomcat；

8.在IE中输入"http://192.168.3.161:9005/jasperSampleWebapp/index.html",正确显示！
9.点左边的菜单"compile JRXML",点右边的"jsp examples",->"execute",提示编译成功！
10.点左边的菜单"fill report",点右边的"jsp examples",->"execute",提示填充数据成功！
11.点左边的菜单"export report",分别可以以pdf,html等格式输出报表！耶，革命终于胜利！

ok！

三、小结：
    总结运行jasperreports的webapp示例的关键几个步骤：
1.要确保webapp\WEB-INF\classes目录的下的三个源代码文件夹(datasource、scriptlets、servlets)和web.xml文件都拷贝过去了！！
2.要把WEB-INF\classes设置为source folder,否则提示找不到数据源,因为该webapp示例的数据源是WEB-INF\classes\datasource\WebappDataSource.java里的二维数组；
3.要确保把原web.xml复制到工程中了,否则无法显示图片，也无法运行servlet samples；
4.*.jsp文件的报错可通过重新剪切粘贴一下来消除；
5.ie中浏览图表时要按照“compile、fill、export”的顺序点击，这样才能顺利看到报表。

四、其他相关内容：
1.把.jrxml编译成.jasper文件的类是：net.sf.jasperreports.engine.JasperCompileManager
方法compileReportToFile：这个方法能够创建一个在整个程序中使用的编译的报告文件(.jasper)。

这个类有两个重载函数，一个只有一个参数，指定.jrxml的路径；另一个有两个参数，分别指定.jrxml的路径和.jasper的输出路径；
compileReportToFile(String srcdir):   编译.jrxml得到.jasper,但是不输出该.jasper文件；
compileReportToFile(String srcdir,String destdir):  编译.jrxml得到.jasper,并且输出该.jasper文件到指定路径；

验证：
法一：
把compile.jsp中的关键的一行代码：
JasperCompileManager.compileReportToFile(application.getRealPath("/reports/WebappReport.jrxml"));
改为：
JasperCompileManager.compileReportToFile(application.getRealPath("/reports/WebappReport.jrxml"),application.getRealPath("/reports/WebappReport.jasper"));

重启tomcat，运行该compile.jsp文件，这时可以在tomcat的目录"tomcat5.5.17\webapps\jasperSampleWebapp\reports"下看到新生成的WebappReport.jasper文件！

法二：
写一个包含main函数的测试类，执行JasperCompileManager.compileReportToFile方法：

package test;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperCompileManager;
import net.sf.jasperreports.engine.design.*;

public class testCompileManager{
    public static void main(String[] args) {
        String sourceFileName="E:\\jiangcm\\workspace-forict-myeclipse\\jasperreports\\demo\\samples\\webapp\\reports\\WebappReport.jrxml";
        String destFileName="E:\\jiangcm\\workspace-forict-myeclipse\\jasperreports\\demo\\samples\\webapp\\reports\\WebappReport.jasper";
        try {
            JasperCompileManager.compileReportToFile(sourceFileName, destFileName);
        } catch (JRException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}

matthew 2007-01-29 14:14 发表评论

JFree Chart API简介－转贴

matthew — Mon, 14 Aug 2006 06:39:00 GMT

JFreeChart类：
void setAntiAlias(boolean flag) 字体模糊边界
void setBackgroundImage(Image image) 背景图片
void setBackgroundImageAlignment(int alignment) 背景图片对齐方式（参数常量在org.jfree.ui.Align类中定义）
void setBackgroundImageAlpha(float alpha) 背景图片透明度（0.0～1.0）
void setBackgroundPaint(Paint paint) 背景色
void setBorderPaint(Paint paint) 边界线条颜色
void setBorderStroke(Stroke stroke) 边界线条笔触
void setBorderVisible(boolean visible) 边界线条是否可见

———————————————————————————————————–

TextTitle类：
void setFont(Font font) 标题字体
void setPaint(Paint paint) 标题字体颜色
void setText(String text) 标题内容

———————————————————————————————————–

StandardLegend(Legend)类：
void setBackgroundPaint(Paint paint) 图示背景色
void setTitle(String title) 图示标题内容
void setTitleFont(Font font) 图示标题字体
void setBoundingBoxArcWidth(int arcWidth) 图示边界圆角宽
void setBoundingBoxArcHeight(int arcHeight) 图示边界圆角高
void setOutlinePaint(Paint paint) 图示边界线条颜色
void setOutlineStroke(Stroke stroke) 图示边界线条笔触
void setDisplaySeriesLines(boolean flag) 图示项是否显示横线（折线图有效）
void setDisplaySeriesShapes(boolean flag) 图示项是否显示形状（折线图有效）
void setItemFont(Font font) 图示项字体
void setItemPaint(Paint paint) 图示项字体颜色
void setAnchor(int anchor) 图示在图表中的显示位置（参数常量在Legend类中定义）

———————————————————————————————————–

Axis类：
void setVisible(boolean flag) 坐标轴是否可见
void setAxisLinePaint(Paint paint) 坐标轴线条颜色（3D轴无效）
void setAxisLineStroke(Stroke stroke) 坐标轴线条笔触（3D轴无效）
void setAxisLineVisible(boolean visible) 坐标轴线条是否可见（3D轴无效）
void setFixedDimension(double dimension) （用于复合表中对多坐标轴的设置）
void setLabel(String label) 坐标轴标题
void setLabelFont(Font font) 坐标轴标题字体
void setLabelPaint(Paint paint) 坐标轴标题颜色
void setLabelAngle(double angle)` 坐标轴标题旋转角度（纵坐标可以旋转）
void setTickLabelFont(Font font) 坐标轴标尺值字体
void setTickLabelPaint(Paint paint) 坐标轴标尺值颜色
void setTickLabelsVisible(boolean flag) 坐标轴标尺值是否显示
void setTickMarkPaint(Paint paint) 坐标轴标尺颜色
void setTickMarkStroke(Stroke stroke) 坐标轴标尺笔触
void setTickMarksVisible(boolean flag) 坐标轴标尺是否显示

ValueAxis(Axis)类：
void setAutoRange(boolean auto) 自动设置数据轴数据范围
void setAutoRangeMinimumSize(double size) 自动设置数据轴数据范围时数据范围的最小跨度
void setAutoTickUnitSelection(boolean flag) 数据轴的数据标签是否自动确定（默认为true）
void setFixedAutoRange(double length) 数据轴固定数据范围（设置100的话就是显示MAXVALUE到MAXVALUE-100那段数据范围）
void setInverted(boolean flag) 数据轴是否反向（默认为false）
void setLowerMargin(double margin) 数据轴下（左）边距
void setUpperMargin(double margin) 数据轴上（右）边距
void setLowerBound(double min) 数据轴上的显示最小值
void setUpperBound(double max) 数据轴上的显示最大值
void setPositiveArrowVisible(boolean visible) 是否显示正向箭头（3D轴无效）
void setNegativeArrowVisible(boolean visible) 是否显示反向箭头（3D轴无效）
void setVerticalTickLabels(boolean flag) 数据轴数据标签是否旋转到垂直
void setStandardTickUnits(TickUnitSource source) 数据轴的数据标签（可以只显示整数标签，需要将AutoTickUnitSelection设false）

NumberAxis(ValueAxis)类：
void setAutoRangeIncludesZero(boolean flag) 是否强制在自动选择的数据范围中包含0
void setAutoRangeStickyZero(boolean flag) 是否强制在整个数据轴中包含0，即使0不在数据范围中
void setNumberFormatOverride(NumberFormat formatter) 数据轴数据标签的显示格式
void setTickUnit(NumberTickUnit unit) 数据轴的数据标签（需要将AutoTickUnitSelection设false）

DateAxis(ValueAxis)类：
void setMaximumDate(Date maximumDate) 日期轴上的最小日期
void setMinimumDate(Date minimumDate) 日期轴上的最大日期
void setRange(Date lower,Date upper) 日期轴范围
void setDateFormatOverride(DateFormat formatter) 日期轴日期标签的显示格式
void setTickUnit(DateTickUnit unit) 日期轴的日期标签（需要将AutoTickUnitSelection设false）
void setTickMarkPosition(DateTickMarkPosition position) 日期标签位置（参数常量在org.jfree.chart.axis.DateTickMarkPosition类中定义）

CategoryAxis(Axis)类：
void setCategoryMargin(double margin) 分类轴边距
void setLowerMargin(double margin) 分类轴下（左）边距
void setUpperMargin(double margin) 分类轴上（右）边距
void setVerticalCategoryLabels(boolean flag) 分类轴标题是否旋转到垂直
void setMaxCategoryLabelWidthRatio(float ratio) 分类轴分类标签的最大宽度

———————————————————————————————————–

Plot类：
void setBackgroundImage(Image image) 数据区的背景图片
void setBackgroundImageAlignment(int alignment) 数据区的背景图片对齐方式（参数常量在org.jfree.ui.Align类中定义）
void setBackgroundPaint(Paint paint) 数据区的背景图片背景色
void setBackgroundAlpha(float alpha) 数据区的背景透明度（0.0～1.0）
void setForegroundAlpha(float alpha) 数据区的前景透明度（0.0～1.0）
void setDataAreaRatio(double ratio) 数据区占整个图表区的百分比
void setOutLinePaint(Paint paint) 数据区的边界线条颜色
void setOutLineStroke(Stroke stroke) 数据区的边界线条笔触
void setNoDataMessage(String message) 没有数据时显示的消息
void setNoDataMessageFont(Font font) 没有数据时显示的消息字体
void setNoDataMessagePaint(Paint paint) 没有数据时显示的消息颜色

CategoryPlot(Plot)类：
void setDataset(CategoryDataset dataset) 数据区的2维数据表
void setColumnRenderingOrder(SortOrder order) 数据分类的排序方式
void setAxisOffset(Spacer offset) 坐标轴到数据区的间距
void setOrientation(PlotOrientation orientation) 数据区的方向（PlotOrientation.HORIZONTAL或PlotOrientation.VERTICAL）
void setDomainAxis(CategoryAxis axis) 数据区的分类轴
void setDomainAxisLocation(AxisLocation location) 分类轴的位置（参数常量在org.jfree.chart.axis.AxisLocation类中定义）
void setDomainGridlinesVisible(boolean visible) 分类轴网格是否可见
void setDomainGridlinePaint(Paint paint) 分类轴网格线条颜色
void setDomainGridlineStroke(Stroke stroke) 分类轴网格线条笔触
void setRangeAxis(ValueAxis axis) 数据区的数据轴
void setRangeAxisLocation(AxisLocation location) 数据轴的位置（参数常量在org.jfree.chart.axis.AxisLocation类中定义）
void setRangeGridlinesVisible(boolean visible) 数据轴网格是否可见
void setRangeGridlinePaint(Paint paint) 数据轴网格线条颜色
void setRangeGridlineStroke(Stroke stroke) 数据轴网格线条笔触
void setRenderer(CategoryItemRenderer renderer) 数据区的表示者（详见Renderer组）
void addAnnotation(CategoryAnnotation annotation) 给数据区加一个注释
void addRangeMarker(Marker marker,Layer layer) 给数据区加一个数值范围区域

PiePlot(Plot)类：
void setDataset(PieDataset dataset) 数据区的1维数据表
void setIgnoreNullValues(boolean flag) 忽略无值的分类
void setCircular(boolean flag) 饼图是否一定是正圆
void setStartAngle(double angle) 饼图的初始角度
void setDirection(Rotation direction) 饼图的旋转方向
void setExplodePercent(int section,double percent) 抽取的那块（1维数据表的分类下标）以及抽取出来的距离（0.0～1.0），3D饼图无效
void setLabelBackgroundPaint(Paint paint) 分类标签的底色
void setLabelFont(Font font) 分类标签的字体
void setLabelPaint(Paint paint) 分类标签的字体颜色
void setLabelLinkMargin(double margin) 分类标签与图的连接线边距
void setLabelLinkPaint(Paint paint) 分类标签与图的连接线颜色
void setLabelLinkStroke(Stroke stroke) 分类标签与图的连接线笔触
void setLabelOutlinePaint(Paint paint) 分类标签边框颜色
void setLabelOutlineStroke(Paint paint) 分类标签边框笔触
void setLabelShadowPaint(Paint paint) 分类标签阴影颜色
void setMaximumLabelWidth(double width) 分类标签的最大长度（0.0～1.0）
void setPieIndex(int index) 饼图的索引（复合饼图中用到）
void setSectionOutlinePaint(int section,Paint paint) 指定分类饼的边框颜色
void setSectionOutlineStroke(int section,Stroke stroke) 指定分类饼的边框笔触
void setSectionPaint(int section,Paint paint) 指定分类饼的颜色
void setShadowPaint(Paint paint) 饼图的阴影颜色
void setShadowXOffset(double offset) 饼图的阴影相对图的水平偏移
void setShadowYOffset(double offset) 饼图的阴影相对图的垂直偏移
void setLabelGenerator(PieSectionLabelGenerator generator) 分类标签的格式，设置成null则整个标签包括连接线都不显示
void setToolTipGenerator(PieToolTipGenerator generator) MAP中鼠标移上的显示格式
void setURLGenerator(PieURLGenerator generator) MAP中钻取链接格式

PiePlot3D(PiePlot)类：
void setDepthFactor(double factor) 3D饼图的Z轴高度（0.0～1.0）

MultiplePiePlot(Plot)类：
void setLimit(double limit) 每个饼图之间的数据关联（详细比较复杂）
void setPieChart(JFreeChart pieChart) 每个饼图的显示方式（见JFreeChart类个PiePlot类）

———————————————————————————————————–

AbstractRenderer类：
void setItemLabelAnchorOffset(double offset) 数据标签的与数据点的偏移
void setItemLabelsVisible(boolean visible) 数据标签是否可见
void setItemLabelFont(Font font) 数据标签的字体
void setItemLabelPaint(Paint paint) 数据标签的字体颜色
void setItemLabelPosition(ItemLabelPosition position) 数据标签位置
void setPositiveItemLabelPosition(ItemLabelPosition position) 正数标签位置
void setNegativeItemLabelPosition(ItemLabelPosition position) 负数标签位置
void setOutLinePaint(Paint paint) 图形边框的线条颜色
void setOutLineStroke(Stroke stroke) 图形边框的线条笔触
void setPaint(Paint paint) 所有分类图形的颜色
void setShape(Shape shape) 所有分类图形的形状（如折线图的点）
void setStroke(Stroke stroke) 所有分类图形的笔触（如折线图的线）
void setSeriesItemLabelsVisible(int series,boolean visible) 指定分类的数据标签是否可见
void setSeriesItemLabelFont(int series,Font font) 指定分类的数据标签的字体
void setSeriesItemLabelPaint(int series,Paint paint) 指定分类的数据标签的字体颜色
void setSeriesItemLabelPosition(int series,ItemLabelPosition position) 数据标签位置
void setSeriesPositiveItemLabelPosition(int series,ItemLabelPosition position) 正数标签位置
void setSeriesNegativeItemLabelPosition(int series,ItemLabelPosition position) 负数标签位置
void setSeriesOutLinePaint(int series,Paint paint) 指定分类的图形边框的线条颜色
void setSeriesOutLineStroke(int series,Stroke stroke) 指定分类的图形边框的线条笔触
void setSeriesPaint(int series,Paint paint) 指定分类图形的颜色
void setSeriesShape(int series,Shape shape) 指定分类图形的形状（如折线图的点）
void setSeriesStroke(int series,Stroke stroke) 指定分类图形的笔触（如折线图的线）

AbstractCategoryItemRenderer(AbstractRenderer)类：
void setLabelGenerator(CategoryLabelGenerator generator) 数据标签的格式
void setToolTipGenerator(CategoryToolTipGenerator generator) MAP中鼠标移上的显示格式
void setItemURLGenerator(CategoryURLGenerator generator) MAP中钻取链接格式
void setSeriesLabelGenerator(int series,CategoryLabelGenerator generator) 指定分类的数据标签的格式
void setSeriesToolTipGenerator(int series,CategoryToolTipGenerator generator) 指定分类的MAP中鼠标移上的显示格式
void setSeriesItemURLGenerator(int series,CategoryURLGenerator generator) 指定分类的MAP中钻取链接格式

BarRenderer(AbstractCategoryItemRenderer)类：
void setDrawBarOutline(boolean draw) 是否画图形边框
void setItemMargin(double percent) 每个BAR之间的间隔
void setMaxBarWidth(double percent) 每个BAR的最大宽度
void setMinimumBarLength(double min) 最短的BAR长度，避免数值太小而显示不出
void setPositiveItemLabelPositionFallback(ItemLabelPosition position) 无法在BAR中显示的正数标签位置
void setNegativeItemLabelPositionFallback(ItemLabelPosition position) 无法在BAR中显示的负数标签位置

BarRenderer3D(BarRenderer)类：
void setWallPaint(Paint paint) 3D坐标轴的墙体颜色

StackedBarRenderer(BarRenderer)类：
没有特殊的设置

StackedBarRenderer3D(BarRenderer3D)类：
没有特殊的设置

GroupedStackedBarRenderer(StackedBarRenderer)类：
void setSeriesToGroupMap(KeyToGroupMap map) 将分类自由的映射成若干个组（KeyToGroupMap.mapKeyToGroup(series,group)）

LayeredBarRenderer(BarRenderer)类：
void setSeriesBarWidth(int series,double width) 设定每个分类的宽度（注意设置不要使某分类被覆盖）

WaterfallBarRenderer(BarRenderer)类：
void setFirstBarPaint(Paint paint) 第一个柱图的颜色
void setLastBarPaint(Paint paint) 最后一个柱图的颜色
void setPositiveBarPaint(Paint paint) 正值柱图的颜色
void setNegativeBarPaint(Paint paint) 负值柱图的颜色

IntervalBarRenderer(BarRenderer)类：
需要传IntervalCategoryDataset作为数据源

GanttBarRenderer(IntervalBarRenderer)类：
void setCompletePaint(Paint paint) 完成进度颜色
void setIncompletePaint(Paint paint) 未完成进度颜色
void setStartPercent(double percent) 设置进度条在整条中的起始位置（0.0～1.0）
void setEndPercent(double percent) 设置进度条在整条中的结束位置（0.0～1.0）

StatisticBarRenderer(BarRenderer)类：
需要传StatisticCategoryDataset作为数据源

LineAndShapeRenderer(AbstractCategoryItemRenderer)类：
void setDrawLines(boolean draw) 是否折线的数据点之间用线连
void setDrawShapes(boolean draw) 是否折线的数据点根据分类使用不同的形状
void setShapesFilled(boolean filled) 所有分类是否填充数据点图形
void setSeriesShapesFilled(int series,boolean filled) 指定分类是否填充数据点图形
void setUseFillPaintForShapeOutline(boolean use) 指定是否填充数据点的Paint也被用于画数据点形状的边框

LevelRenderer(AbstractCategoryItemRenderer)类：
void setItemMargin(double percent) 每个分类之间的间隔
void setMaxItemWidth(double percent) 每个分类的最大宽度

CategoryStepRenderer(AbstractCategoryItemRenderer)类：
void setStagger(boolean shouldStagger) 不同分类的图是否交错

MinMaxCategoryRenderer(AbstractCategoryItemRenderer)类：
void setDrawLines(boolean drawLines) 是否在每个分类线间画连接线
void setGroupPaint(Paint groupPaint) 一组图形连接线的颜色
void setGroupStroke(Stroke groupStroke) 一组图形连接线的笔触
void setMaxIcon(Icon maxIcon) 最大值的ICON
void setMinIcon(Icon minIcon) 最小值的ICON
void setObjectIcon(Icon objectIcon) 所有值的ICON

AreaRender(AbstractCategoryItemRenderer)类：
没有特殊的设置

StackedAreaRender(AreaRender)类：
没有特殊的设置

matthew 2006-08-14 14:39 发表评论

基于J2EE的面向对象型数据的报表系统的设计与实现－转贴

matthew — Mon, 14 Aug 2006 06:35:00 GMT

一、jFreeChart产生图形的流程
创建一个数据源（dataset）来包含将要在图形中显示的数据?????>>创建一个 JFreeChart 对象来代表要显示的图形
??????>>把图形输出
重要的类和接口：
org.jfree.data.general.Dataset 所有数据源类都要实现的接口
org.jfree.chart.ChartFactory 由它来产生 JFreeChart 对象
org.jfree.chart.JFreeChart 所有对图形的调整都是通过它噢！！
org.jfree.chart.plot.Plot 通过JFreeChart 对象获得它，然后再通过它对图形外部部分（例：坐标轴）调整
注意：它有很多子类，一般都下嗍造型到它的子类！
org.jfree.chart.renderer.AbstractRenderer 通过JFreeChart 对象获得它，然后再通过它对图形内部部分
（例：折线的类型）调整。同样，针对不同类型的报表图，它有
着不同的子类实现！在下面我们简称它为 Renderer
下面我们结合不同类型的图形来具体分析这个流程。

二、饼图
饼图的dataset 一般是用PieDataset 接口，具体实现类是 DefaultPieDataset
1、创建一个数据源（dataset）：
private static PieDataset createDataset()
{
DefaultPieDataset defaultpiedataset = new DefaultPieDataset(); //注意是DefaultPieDataset！！
defaultpiedataset.setValue(”One”, new Double(43.200000000000003D));
defaultpiedataset.setValue(”Two”, new Double(10D));
defaultpiedataset.setValue(”Three”, new Double(27.5D));
defaultpiedataset.setValue(”Four”, new Double(17.5D));
return defaultpiedataset;
}
2、由ChartFactory 产生 JFreeChart 对象
private static JFreeChart createChart(PieDataset piedataset)
{
JFreeChart jfreechart = ChartFactory.createPieChart(”Pie Chart Demo 1″, //图形标题名称
piedataset, // dataset
true, // legend?
true, // tooltips?
false); //URLs?
PiePlot pieplot = (PiePlot)jfreechart.getPlot(); //通过JFreeChart 对象获得 plot：PiePlot！！
pieplot.setNoDataMessage(”No data available”); // 没有数据的时候显示的内容
return jfreechart;
}
一些重要的方法：
pieplot.setExplodePercent(0,0.3D) //把Lable 为”One” 的那一块”挖”出来30%
3、输出略

三、柱状图
柱状图的dataset 一般是用CatagoryDataset接口(具体实现类是DefaultCategoryDataset),也会用 IntervalXYDataset
接口
1、创建一个数据源（dataset）：
private static CategoryDataset createDataset()
{
String series1 = “First”;
String series2 = “Second”;
String series3 = “Third”;
String category1 = “Category 1″;
String category2 = “Category 2″;
String category3 = “Category 3″;
String category4 = “Category 4″;
String category5 = “Category 5″;
DefaultCategoryDataset defaultcategorydataset = new DefaultCategoryDataset();
defaultcategorydataset.addValue(1.0D, series1, category1);
defaultcategorydataset.addValue(4D, series1, category2);
defaultcategorydataset.addValue(3D, series1, category3);
defaultcategorydataset.addValue(5D, series1, category4);
defaultcategorydataset.addValue(5D, series1, category5);

defaultcategorydataset.addValue(5D, series2, category1);
defaultcategorydataset.addValue(7D, series2, category2);
defaultcategorydataset.addValue(6D, series2, category3);
defaultcategorydataset.addValue(8D, series2, category4);
defaultcategorydataset.addValue(4D, series2, category5);

defaultcategorydataset.addValue(4D, series3, category1);
defaultcategorydataset.addValue(3D, series3, category2);
defaultcategorydataset.addValue(2D, series3, category3);
defaultcategorydataset.addValue(3D, series3, category4);
defaultcategorydataset.addValue(6D, series3, category5);
return defaultcategorydataset;
}
2、由ChartFactory 产生 JFreeChart 对象
private static JFreeChart createChart(CategoryDataset categorydataset)
{
JFreeChart jfreechart = ChartFactory.createBarChart(”Bar Chart Demo”, //图形标题名称
“Category”,//domain 轴 Lable
这里先简单理解为横坐标Lable好了
“Value”, //range 轴 Lable
这里也先简单理解为纵坐标Lable好了
categorydataset, // dataset
PlotOrientation.VERTICAL, //垂直显示
true, // legend?
true, // tooltips?
false); //URLs?
jfreechart.setBackgroundPaint(Color.white); //设定背景色为白色
CategoryPlot categoryplot = jfreechart.getCategoryPlot(); //获得 plot：CategoryPlot！！
categoryplot.setBackgroundPaint(Color.lightGray); //设定图表数据显示部分背景色
categoryplot.setDomainGridlinePaint(Color.white); //横坐标网格线白色
categoryplot.setDomainGridlinesVisible(true); //可见
categoryplot.setRangeGridlinePaint(Color.white); //纵坐标网格线白色
//下面两行使纵坐标的最小单位格为整数
NumberAxis numberaxis = (NumberAxis)categoryplot.getRangeAxis();
numberaxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits());
BarRenderer barrenderer = (BarRenderer)categoryplot.getRenderer(); //获得renderer 注意这里是下嗍造型
到BarRenderer！！
barrenderer.setDrawBarOutline(false); // Bar的外轮廓线不画
GradientPaint gradientpaint = new GradientPaint(0.0F, 0.0F, Color.blue,
0.0F, 0.0F, new Color(0, 0, 64)); //设定特定颜色
GradientPaint gradientpaint1 = new GradientPaint(0.0F, 0.0F, Color.green,
0.0F, 0.0F, new Color(0, 64, 0));
GradientPaint gradientpaint2 = new GradientPaint(0.0F, 0.0F, Color.red,
0.0F, 0.0F, new Color(64, 0, 0));
barrenderer.setSeriesPaint(0, gradientpaint); //给series1 Bar设定上面定义的颜色
barrenderer.setSeriesPaint(1, gradientpaint1); //给series2 Bar 设定上面定义的颜色
barrenderer.setSeriesPaint(2, gradientpaint2); //给series3 Bar 设定上面定义的颜色
CategoryAxis categoryaxis = categoryplot.getDomainAxis(); //横轴上的 Lable 45度倾斜
categoryaxis.setCategoryLabelPositions(CategoryLabelPositions.UP_45);
return jfreechart;
}
一些重要的方法：（增加一块标记）
IntervalMarker intervalmarker = new IntervalMarker(4.5D, 7.5D);
intervalmarker.setLabel(”Target Range”);
intervalmarker.setLabelFont(new Font(”SansSerif”, 2, 11));
intervalmarker.setLabelAnchor(RectangleAnchor.LEFT);
intervalmarker.setLabelTextAnchor(TextAnchor.CENTER_LEFT);
intervalmarker.setPaint(new Color(222, 222, 255, 128));
categoryplot.addRangeMarker(intervalmarker, Layer.BACKGROUND);

四、折线图
折线图的dataset 两种CatagoryDataset接口(具体实现类是DefaultCategoryDataset),XYDataset 接口
1、CatagoryDataset接口：
A、创建一个数据源（dataset）：
private static CategoryDataset createDataset()
{
String series1 = “First”;
String series2 = “Second”;
String series3 = “Third”;
String type1 = “Type 1″;
String type2 = “Type 2″;
String type3 = “Type 3″;
String type4 = “Type 4″;
String type5 = “Type 5″;
String type6 = “Type 6″;
String type7 = “Type 7″;
String type8 = “Type 8″;
DefaultCategoryDataset defaultcategorydataset = new DefaultCategoryDataset();
defaultcategorydataset.addValue(1.0D, series1, type1);
defaultcategorydataset.addValue(4D, series1, type2);
defaultcategorydataset.addValue(3D, series1, type3);
defaultcategorydataset.addValue(5D, series1, type4);
defaultcategorydataset.addValue(5D, series1, type5);
defaultcategorydataset.addValue(7D, series1, type6);
defaultcategorydataset.addValue(7D, series1, type7);
defaultcategorydataset.addValue(8D, series1, type8);

defaultcategorydataset.addValue(5D, series2, type1);
defaultcategorydataset.addValue(7D, series2, type2);
defaultcategorydataset.addValue(6D, series2, type3);
defaultcategorydataset.addValue(8D, series2, type4);
defaultcategorydataset.addValue(4D, series2, type5);
defaultcategorydataset.addValue(4D, series2, type6);
defaultcategorydataset.addValue(2D, series2, type7);
defaultcategorydataset.addValue(1.0D, series2, type8);

defaultcategorydataset.addValue(4D, series3, type1);
defaultcategorydataset.addValue(3D, series3, type2);
defaultcategorydataset.addValue(2D, series3, type3);
defaultcategorydataset.addValue(3D, series3, type4);
defaultcategorydataset.addValue(6D, series3, type5);
defaultcategorydataset.addValue(3D, series3, type6);
defaultcategorydataset.addValue(4D, series3, type7);
defaultcategorydataset.addValue(3D, series3, type8);
return defaultcategorydataset;
}
B、由ChartFactory 产生 JFreeChart 对象 (与上面重复的部分就不再注释）
private static JFreeChart createChart(CategoryDataset categorydataset)
{
JFreeChart jfreechart = ChartFactory.createLineChart(”Line Chart Demo 1″,
“Type”,
“Value”,
categorydataset,
PlotOrientation.VERTICAL,
true,
true,
false);
jfreechart.setBackgroundPaint(Color.white);
CategoryPlot categoryplot = (CategoryPlot)jfreechart.getPlot();
categoryplot.setBackgroundPaint(Color.lightGray);
categoryplot.setRangeGridlinePaint(Color.white);
NumberAxis numberaxis = (NumberAxis)categoryplot.getRangeAxis();
numberaxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits());
numberaxis.setAutoRangeIncludesZero(true);
//获得renderer 注意这里是下嗍造型到lineandshaperenderer！！
LineAndShapeRenderer lineandshaperenderer = (LineAndShapeRenderer)categoryplot.getRenderer();
lineandshaperenderer.setShapesVisible(true); //series 点（即数据点）可见
lineandshaperenderer.setSeriesStroke(0, new BasicStroke(2.0F, 1, 1, 1.0F, new float[] {
10F, 6F
}, 0.0F)); //定义series为”First”的（即series1）点之间的连线，这里是虚线，默认是直线
lineandshaperenderer.setSeriesStroke(1, new BasicStroke(2.0F, 1, 1, 1.0F, new float[] {
6F, 6F
}, 0.0F)); //定义series为”Second”的（即series2）点之间的连线
lineandshaperenderer.setSeriesStroke(2, new BasicStroke(2.0F, 1, 1, 1.0F, new float[] {
2.0F, 6F
}, 0.0F)); //定义series为”Third”的（即series3）点之间的连线
return jfreechart;
}
一些重要的方法：
lineandshaperenderer.setLineVisible(true) //series 点（即数据点）间有连线可见
2、XYDataset 接口：
A、创建一个数据源（dataset）：
private static XYDataset createDataset()
{
XYSeries xyseries = new XYSeries(”First”); //先产生XYSeries 对象
xyseries.add(1.0D, 1.0D);
xyseries.add(2D, 4D);
xyseries.add(3D, 3D);
xyseries.add(4D, 5D);
xyseries.add(5D, 5D);
xyseries.add(6D, 7D);
xyseries.add(7D, 7D);
xyseries.add(8D, 8D);

XYSeries xyseries1 = new XYSeries(”Second”);
xyseries1.add(1.0D, 5D);
xyseries1.add(2D, 7D);
xyseries1.add(3D, 6D);
xyseries1.add(4D, 8D);
xyseries1.add(5D, 4D);
xyseries1.add(6D, 4D);
xyseries1.add(7D, 2D);
xyseries1.add(8D, 1.0D);

XYSeries xyseries2 = new XYSeries(”Third”);
xyseries2.add(3D, 4D);
xyseries2.add(4D, 3D);
xyseries2.add(5D, 2D);
xyseries2.add(6D, 3D);
xyseries2.add(7D, 6D);
xyseries2.add(8D, 3D);
xyseries2.add(9D, 4D);
xyseries2.add(10D, 3D);

XYSeriesCollection xyseriescollection = new XYSeriesCollection(); //再用XYSeriesCollection添加入XYSeries 对象
xyseriescollection.addSeries(xyseries);
xyseriescollection.addSeries(xyseries1);
xyseriescollection.addSeries(xyseries2);
return xyseriescollection;
}
B、由ChartFactory 产生 JFreeChart 对象
private static JFreeChart createChart(XYDataset xydataset)
{
JFreeChart jfreechart = ChartFactory.createXYLineChart(”Line Chart Demo 2″,
“X”,
“Y”,
xydataset,
PlotOrientation.VERTICAL,
true,
true,
false);
jfreechart.setBackgroundPaint(Color.white);
XYPlot xyplot = (XYPlot)jfreechart.getPlot(); //获得 plot：XYPlot！！
xyplot.setBackgroundPaint(Color.lightGray); //设定图表数据显示部分背景色
xyplot.setAxisOffset(new RectangleInsets(5D, 5D, 5D, 5D)); //设定坐标轴与图表数据显示部分距离
xyplot.setDomainGridlinePaint(Color.white); //网格线颜色
xyplot.setRangeGridlinePaint(Color.white);
//获得 renderer 注意这里是XYLineAndShapeRenderer ！！
XYLineAndShapeRenderer xylineandshaperenderer = (XYLineAndShapeRenderer)xyplot.getRenderer();
xylineandshaperenderer.setShapesVisible(true); //数据点可见
xylineandshaperenderer.setShapesFilled(true); //数据点被填充即不是空心点
NumberAxis numberaxis = (NumberAxis)xyplot.getRangeAxis();
numberaxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits());
return jfreechart;
}
一些重要的方法：
XYLineAndShapeRenderer xylineandshaperenderer = new XYLineAndShapeRenderer();
xylineandshaperenderer.setSeriesLinesVisible(0, false); //第一个XYSeries数据点间连线不可见
xylineandshaperenderer.setSeriesShapesVisible(1, false); //第二个XYSeries数据点不可见
xyplot.setRenderer(xylineandshaperenderer);

五、时间序列图
时间序列图和折线图很相似，不同的是它在 domain轴的数据是时间而不是数字。时间序列图的dataset 是
XYDataset 接口，具体实现类是TimeSeriesCollection ，和上面类似，有TimeSeries 对象，它被添加入
TimeSeriesCollection 。
1、创建一个数据源（dataset）：
private static XYDataset createDataset()
{
TimeSeries timeseries = new TimeSeries(”L&G European Index Trust”,Month.class);
timeseries.add(new Month(2, 2001), 181.8D);//这里用的是Month.class，同样还有Day.class Year.class 等等
timeseries.add(new Month(3, 2001), 167.3D);
timeseries.add(new Month(4, 2001), 153.8D);
timeseries.add(new Month(5, 2001), 167.6D);
timeseries.add(new Month(6, 2001), 158.8D);
timeseries.add(new Month(7, 2001), 148.3D);
timeseries.add(new Month(8, 2001), 153.9D);
timeseries.add(new Month(9, 2001), 142.7D);
timeseries.add(new Month(10, 2001), 123.2D);
timeseries.add(new Month(11, 2001), 131.8D);
timeseries.add(new Month(12, 2001), 139.6D);
timeseries.add(new Month(1, 2002), 142.9D);
timeseries.add(new Month(2, 2002), 138.7D);
timeseries.add(new Month(3, 2002), 137.3D);
timeseries.add(new Month(4, 2002), 143.9D);
timeseries.add(new Month(5, 2002), 139.8D);
timeseries.add(new Month(6, 2002), 137D);
timeseries.add(new Month(7, 2002), 132.8D);

TimeSeries timeseries1 = new TimeSeries(”L&G UK Index Trust”,Month.class);
timeseries1.add(new Month(2, 2001), 129.6D);
timeseries1.add(new Month(3, 2001), 123.2D);
timeseries1.add(new Month(4, 2001), 117.2D);
timeseries1.add(new Month(5, 2001), 124.1D);
timeseries1.add(new Month(6, 2001), 122.6D);
timeseries1.add(new Month(7, 2001), 119.2D);
timeseries1.add(new Month(8, 2001), 116.5D);
timeseries1.add(new Month(9, 2001), 112.7D);
timeseries1.add(new Month(10, 2001), 101.5D);
timeseries1.add(new Month(11, 2001), 106.1D);
timeseries1.add(new Month(12, 2001), 110.3D);
timeseries1.add(new Month(1, 2002), 111.7D);
timeseries1.add(new Month(2, 2002), 111D);
timeseries1.add(new Month(3, 2002), 109.6D);
timeseries1.add(new Month(4, 2002), 113.2D);
timeseries1.add(new Month(5, 2002), 111.6D);
timeseries1.add(new Month(6, 2002), 108.8D);
timeseries1.add(new Month(7, 2002), 101.6D);
TimeSeriesCollection timeseriescollection = new TimeSeriesCollection();
timeseriescollection.addSeries(timeseries);
timeseriescollection.addSeries(timeseries1);
timeseriescollection.setDomainIsPointsInTime(true); //domain轴上的刻度点代表的是时间点而不是时间段
return timeseriescollection;
}
2、由ChartFactory 产生 JFreeChart 对象
private static JFreeChart createChart(XYDataset xydataset)
{
JFreeChart jfreechart = ChartFactory.createTimeSeriesChart(”Legal & General Unit Trust Prices”,
“Date”,
“Price Per Unit”,
xydataset,
true,
true,
false);
jfreechart.setBackgroundPaint(Color.white);
XYPlot xyplot = (XYPlot)jfreechart.getPlot(); //获得 plot : XYPlot!!
xyplot.setBackgroundPaint(Color.lightGray);
xyplot.setDomainGridlinePaint(Color.white);
xyplot.setRangeGridlinePaint(Color.white);
xyplot.setAxisOffset(new RectangleInsets(5D, 5D, 5D, 5D));
xyplot.setDomainCrosshairVisible(true);
xyplot.setRangeCrosshairVisible(true);
org.jfree.chart.renderer.xy.XYItemRenderer xyitemrenderer = xyplot.getRenderer();
if(xyitemrenderer instanceof XYLineAndShapeRenderer)
{
XYLineAndShapeRenderer xylineandshaperenderer = (XYLineAndShapeRenderer)xyitemrenderer;
xylineandshaperenderer.setDefaultShapesVisible(true); //数据点可见
xylineandshaperenderer.setDefaultShapesFilled(true); //数据点是实心点
}
DateAxis dateaxis = (DateAxis)xyplot.getDomainAxis(); //对domain 轴上日期显示格式定义
dateaxis.setDateFormatOverride(new SimpleDateFormat(”MMM-yyyy”));
return jfreechart;
}
一些重要的方法：
A、增加标记线：
xyplot.addRangeMarker(new ValueMarker(550D)); //数值轴
Quarter quarter = new Quarter(2, 2002);
xyplot.addDomainMarker(new ValueMarker(quarter.getMiddleMillisecond())); //时间轴
B、数据点的调整
XYLineAndShapeRenderer xylineandshaperenderer = (XYLineAndShapeRenderer)xyplot.getRenderer();
xylineandshaperenderer.setDefaultShapesVisible(true); //数据点可见
xylineandshaperenderer.setSeriesFillPaint(0, Color.red); //数据点填充为红色
xylineandshaperenderer.setSeriesFillPaint(1, Color.white); //数据点填充为白色
xylineandshaperenderer.setUseFillPaint(true); //应用
C、平均值曲线
这个曲线有什么用呢？很简单的例子，这里有一个以半年每天为单位的数据绘制的曲线，我们想看看以月为单位数据
的变化，这时就可以用到它了。
TimeSeries timeseries = createEURTimeSeries(); //就是以半年每天为单位的数据
TimeSeries timeseries1 = MovingAverage.createMovingAverage(timeseries,
“30 day moving average”,
30, //30天为一个周期
30); //最开始的30天跳过
TimeSeriesCollection timeseriescollection = new TimeSeriesCollection();
timeseriescollection.addSeries(timeseries);
timeseriescollection.addSeries(timeseries1);
return timeseriescollection;

六、总结一下
dataset plot renderer
饼图 PieDataset（DefaultPieDataset） PiePlot ——
柱状图 CatagoryDataset（DefaultCategoryDataset） CategoryPlot BarRenderer
折线图 CatagoryDataset（DefaultCategoryDataset） CategoryPlot LineAndShapeRenderer
XYDataset（XYSeriesCollection） XYPlot XYLineAndShapeRenderer
时间序列图 XYDataset （TimeSeriesCollection） XYPlot XYLineAndShapeRenderer
这里只是一些常用的方法，具体还是看API
七、Item Lable
这里以柱状图为例说明，具体来说就是在每个柱状上显示它的数据，具体有下面内容：
A、使 Item Lable 可见
B、调整 Item Lable 的颜色、字体等
C、调整 Item Lable 的位置
D、定制 Item Lable 的内容
1、分配一个 Lable Generator 给 renderer
BarRenderer barrenderer = (BarRenderer)categoryplot.getRenderer();
GategoryLableGenerator generator =new StandardGategoryLableGenerator(
“{2}”, new DecimalFormat(”0.00″) //调整显示的数字和字符格式
);
barrenderer.setLableGenerator(generator);
2、使 Item Lable 可见
barrenderer.setItemLableVisible(true);
3、调整 Item Lable 的颜色、字体等
barrenderer.setItemLablePaint(Color.red);
barrenderer.setItemLableFont(new Font(”SansSerif”,Font.PLAIN,10));
4、调整 Item Lable 的位置
这里涉及到一个新的对象 ItemLablePosition , ItemLablePosition的构造函数有两个或四个参数
public ItemLabelPosition(ItemLabelAnchor itemLabelAnchor,
org.jfree.ui.TextAnchor textAnchor,
org.jfree.ui.TextAnchor rotationAnchor,
double angle)
itemLabelAnchor - Item Lable 的位置（最重要的！！）
textAnchor - Item Lable里包含的正文相对于Item Lable 的位置
rotationAnchor - Item Lable里包含的正文旋转的位置
angle - 旋转的角度
ItemLabelPosition itemlabelposition = new ItemLabelPosition(ItemLabelAnchor.INSIDE12,
TextAnchor.CENTER_RIGHT,
TextAnchor.CENTER_RIGHT,
-1.57D);
barrenderer.setPositiveItemLabelPosition(itemlabelposition);
这样就可以每个柱状上显示它的数据了，当然可以定制 Item Lable 的内容，比如 Item Lable text 超过100的才
显示，这样就需要定制自己的类，它要实现GategoryLableGenerator 接口，实现generateItemLable()方法

matthew 2006-08-14 14:35 发表评论

JFreeChart 初学

matthew — Fri, 07 Jul 2006 07:26:00 GMT

由于项目需求原因，上网看了些JfreeChart的例子。自己就试着用了下：
BarCharDemo.jsp
<%@page contentType="text/html; charset=GB2312"%>

<%@page import="java.io.FileNotFoundException"%>
<%@page import="java.io.FileOutputStream"%>
<%@page import="org.apache.commons.logging.Log"%>
<%@page import="java.io.IOException"%>

   JFreeChart chart      = ChartFactory.createPieChart3D(
    "水果产量图",       //图标标题
    dataset,       //数据集
    true,        //是否显示图例（简单的柱装图必须是fasle）
    false,        //是否生成工具
    false        //是否生成URL链接
    );

ChartUtilities.writeChartAsJPEG(response.getOutputStream(),chart,640,370);
%>

PieChartDemo.jsp
<%@page contentType="text/html; charset=GB2312"%>

<%@page import="java.io.FileNotFoundException"%>
<%@page import="java.io.FileOutputStream"%>
<%@page import="org.apache.commons.logging.Log"%>
<%@page import="java.io.IOException"%>

<%@page import="org.apache.commons.logging.LogFactory"%>
<%@page import="org.jfree.chart.ChartFactory"%>
<%@page import="org.jfree.chart.ChartUtilities"%>
<%@page import="org.jfree.chart.JFreeChart"%>
<%@page import="org.jfree.chart.plot.PlotOrientation"%>
<%@page import="org.jfree.data.category.CategoryDataset"%>
<%@page import="org.jfree.data.category.DefaultCategoryDataset"%>
<%
DefaultCategoryDataset dataset    = new DefaultCategoryDataset();
dataset.addValue(100, "北京", "苹果");
dataset.addValue(130, "上海", "苹果");
dataset.addValue(160, "广州", "苹果");
dataset.addValue(200, "北京", "梨子");
dataset.addValue(230, "上海", "梨子");
dataset.addValue(260, "广州", "梨子");
dataset.addValue(300, "北京", "葡萄");
dataset.addValue(330, "上海", "葡萄");
dataset.addValue(360, "广州", "葡萄");
dataset.addValue(400, "北京", "香蕉");
dataset.addValue(430, "上海", "香蕉");
dataset.addValue(460, "广州", "香蕉");
dataset.addValue(500, "北京", "荔枝");
dataset.addValue(530, "上海", "荔枝");
dataset.addValue(560, "广州", "荔枝");

    JFreeChart chart      = ChartFactory.createBarChart3D(
    "水果产量图",       //图标标题
    "水果",        //目录轴显示标签（x轴）
    "产量",        //数据轴显示标签（y轴）
    dataset,       //数据集
    PlotOrientation.VERTICAL,   //图标方向：水平，垂直
    true,        //是否显示图例（简单的柱装图必须是fasle）
    false,        //是否生成工具
    false        //是否生成URL链接
    );

    ChartUtilities.writeChartAsJPEG(response.getOutputStream(),chart,640,370);
%>

TimeSeriesDemo（在页面上显示）
首先配置web.xml

  DisplayChart
  org.jfree.chart.servlet.DisplayChart

  DisplayChart
  /servlet/DisplayChart

TimeSeriesDemo.java

package net.neitbe.home.jfreechart.business;

import java.awt.Color;
import java.awt.Font;
import java.awt.GradientPaint;
import java.io.IOException;

import javax.servlet.http.HttpSession;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartRenderingInfo;
import org.jfree.chart.JFreeChart;
import org.jfree.chart.entity.StandardEntityCollection;
import org.jfree.chart.servlet.ServletUtilities;
import org.jfree.chart.title.TextTitle;
import org.jfree.data.time.Day;
import org.jfree.data.time.TimeSeries;
import org.jfree.data.time.TimeSeriesCollection;
import org.jfree.data.time.TimeSeriesDataItem;

/**
* @author neitbe
*/
public class TimeSeriesDemo {

private static Log log    = LogFactory.getLog(TimeSeriesDemo.class);

//曲线图标题
private String title    = "趋势分析";
//曲线图X轴提示
private String domain    = "月份走势";
//曲线图Y轴提示
private String range    = "应收余额";
//曲线图自标题
private String subtitleStr   = "2005财年分析";

//创建时间数据源
//每一个TimeSeries在图上是一条曲线
private TimeSeries yongyou    = new TimeSeries("用友");
private TimeSeries jindie    = new TimeSeries("金碟");
private TimeSeries dongruan    = new TimeSeries("东软");

//时间曲线数据集合
private static TimeSeriesCollection dataset = new TimeSeriesCollection();

private void setDataset() {
  dataset.removeAllSeries();        //在javaBean中使用此类这个很重要，不然会不停的加入新的TimeSeries;
  dataset.addSeries(this.yongyou);
  dataset.addSeries(this.jindie);
  dataset.addSeries(this.dongruan);

}

private void setDongruan() {
  this.dongruan.clear();     //很重要，不然会报错
  /**
   * 报错
   * org.apache.jasper.JasperException: You are attempting to add an observation for the time period
   * 这里是在类属性里声明TimeSeries才用到的
   */
  for(int i = 1999; i < 2005; i++) {
   for(int mon = 0; mon < 12; mon++) {

    this.dongruan.add(new TimeSeriesDataItem(new Day(1,mon+1,i),new Double(300 - Math.random()*100)));
   }
  }
}

private void setJindie() {

  this.jindie.clear();    //很重要，不然会报错
  for(int i = 1999; i < 2005; i++) {
   for(int mon = 0; mon < 12; mon++) {
    this.jindie.add(new TimeSeriesDataItem(new Day(1,mon+1,i),new Double(400 - Math.random()*100)));
   }
  }
}

private void setYongyou() {
  this.yongyou.clear();   //很重要，不然会报错
  for(int i = 1999; i < 2005; i++) {
   for(int mon = 0; mon < 12; mon++) {
    this.yongyou.add(new TimeSeriesDataItem(new Day(1,mon+1,i),new Double(500 - Math.random()*100)));
   }
  }

}

private TimeSeriesCollection getDataset() {
  this.setDongruan();
  this.setJindie();
  this.setYongyou();
  this.setDataset();
  return dataset;
}

public String drawPic(HttpSession session) {
  String fileName       = null;
  JFreeChart chart      = ChartFactory.createTimeSeriesChart(title,domain,range,getDataset(),true,true,false);
  TextTitle subTitle      = new TextTitle(subtitleStr,new Font("黑体",Font.BOLD,12));
  chart.addSubtitle(subTitle);
  chart.setTitle(new TextTitle(title,new Font("隶书",Font.ITALIC,15)));
  chart.setBorderPaint(new GradientPaint(0,0,Color.white,0,1000,Color.blue));
  //String fileName       = "D:\\fuit2.jpeg";
  try {
   ChartRenderingInfo info = new ChartRenderingInfo(new StandardEntityCollection());

   log.debug("准备创建图片……");
   fileName       = ServletUtilities.saveChartAsJPEG(chart,600,600,info,session);
   log.debug("图片创建成功！");
  } catch (IOException e) {
   log.error("IO异常：",e);
  }
  log.debug("返回的文件名为：" + fileName);
  return fileName;
}

/*public static void main(String[] args) {
  TimeSeriesDemo timeSeriesDemo   = new TimeSeriesDemo();
  timeSeriesDemo.drawPic();
}*/

}

index.jsp页面：
<%@ page language="java" contentType="text/html; charset=GBK"
    pageEncoding="GBK"%>

Insert title here

<%
String fileName   = timeSeries.drawPic(request.getSession());
String graphURL   = request.getContextPath()+"/servlet/DisplayChart?filename=" + fileName;
%>
<%=graphURL%>

" width="400" height="400" border="1"/>

matthew 2006-07-07 15:26 发表评论

Jasperreport连续打印多个报表模板－原创

matthew — Sat, 01 Jul 2006 08:52:00 GMT

Jasperreport连续打印多个报表模板，这个问题一直困扰我很久。网上查了很多资料都没有具体的解决办法，通过查询jasperreport的API发现提供了解决这个问题的方法。以下是我的过程记录：

问题描述：一般报表设计和打印中，主要是对单个报表模板进行数据填充、打印、导出。但是，也有个别情况需要连续打印多个报表模板。比如，政府机关的上报材料，属于一个完整的文档。如果一个一个模板打印会显得非常麻烦。

问题解决过程：一般我们导出报表文件是使用这个语句：
exporter.setParamete(JRExporterParameter.JASPER_PRINT, jasperprint);但是它是对单个模板进行操作，通过查找jasperreport的API发现还提供了这样一个语句：
exporter.setParameter(JRExporterParameter.JASPER_PRINT_LIST, jasperprint);可以连续对多个报表模板操作。它的方法是通过一个list来存储多个JasperPrint对象，从而实现多个报表模板的打印。在我解决问题的过程中发现导出PDF文件格式比较简单，但是导出WORD文档时发现编码格式出现问题，老是出现乱码。即使这样: exporter.setParameter(JRExporterParameter.CHARACTER_ENCODING, "GB2312");也没有用。后来浏览一篇贴子：“导出excel时出现乱码问题”，和我的问题差不多。终于大功告成！

matthew 2006-07-01 16:52 发表评论

jasper report 使用 hibernate 数据源性能优化

matthew — Thu, 29 Jun 2006 12:00:00 GMT

（转贴：Autohr John Ferguson Smart ）
注: 使用了 hibernate 的分页功能，对大数据量查询采用分段读入方法，避免了一次读入带来的性能下降，一般在Tomcat 环境下，当List中的 Object > 10000 一般会导致 OutOfMemory。

Introduction
In the article, we examine a performance-optimised approach for using Hibernate queries to generate reports with JasperReports.

JasperReports is a powerful and flexible Open Source reporting tool. Combined with the graphical design tool iReport, for example, you get a complete Java Open Source reporting solution. In this article, we will investigate how you can integrate JasperReports reporting with Hibernate data sources in an optimal manner, without sacrificing ease-of-use or performance.

Basic Hibernate/JasperReports integration
To integrate Hibernate and JasperReports, you have to define a JasperReports data source. One simple and intuitive approach is to use the JRBeanCollectionDataSource data source (This approach is presented here) :

-------------------------------------------------------------------------------------------------------
List results = session.find("from com.acme.Sale");

Map parameters = new HashMap();
parameters.put("Title", "Sales Report");

InputStream reportStream
= this.class.getResourceAsStream("/sales-report.xml");
JasperDesign jasperDesign = JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport = JasperManager.compileReport(jasperDesign);

JRBeanCollectionDataSource ds = new JRBeanCollectionDataSource(results);
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport,
parameters,
ds);

JasperExportManager.exportReportToPdfFile(jasperPrint, "sales-report.pdf");

------------------------------------------------------------------------------------------------------------

This approach will work well for small lists. However, for reports involving tens or hundreds of thousands of lines, it is inefficiant, memory-consuming, and slow. Indeed, experience shows that, when running on a standard Tomcat configuration, a list returning as few as 10000 business objects can cause OutOfMemory exceptions. It also wastes time building a bulky list of objects before processing them, and pollutes the Hibernate session (and possibly second-level caches with temporary objects.

Optimised Hibernate/JasperReports integration
We need a way to efficiently read and process Hibernate queries, without creating too many unnecessary temporary objects in memory. One possible way to do this is the following :

Define an optimised layer for executing Hibernate queries efficiently
Define an abstraction layer for these classes which is compatible with JasperReports
Wrap this data access layer in a JasperReports class that can be directly plugged into JasperReports
The Hibernate Data Access Layer : The QueryProvider interface and its implementations
We start with the optimised Hibernate data access. (you may note that this layer is not actually Hibernate-specific, so other implementations could implement other types of data access without impacting the design).

This layer contains two principal classes :

The CriteriaSet class
The QueryProvider interface

A CriteriaSet is simply a JavaBean which contains parameters which may be passed to the Hibernate query. It is simply a generic way of encapsulating a set of parameters. A QueryProvider provides a generic way of returning an arbitrary subset of the query results set. The essential point is that query results are read in small chunks, not all at once. This allows more efficient memory handling and better performance.

------------------------------------------------------------------------------------------------------------
/**
* A QueryProvidor provides a generic way of fetching a set of objects.
*/
public interface QueryProvider {

/**
* Return a set of objects based on a given criteria set.
* @param firstResult the first result to be returned
* @param maxResults the maximum number of results to be returned
* @return a list of objects
*/
List getObjects(CriteriaSet criteria,
int firstResult,
int maxResults) throws HibernateException;
}
----------------------------------------------------------------------------------------------------------

A typical implementation of this class simply builds a Hibernate query using the specified criteria set and returns the requested subset of results. For example :

-----------------------------------------------------------------------------------------------------------

public class ProductQueryProvider implements QueryProvider {

public List getObjects(CriteriaSet criteria,
int firstResult,
int maxResults)
throws HibernateException {
//
// Build query criteria
//
Session sess = SessionManager.currentSession();
ProductCriteriaSet productCriteria
= (ProductCriteriaSet) criteria;
Query query = session.find("from com.acme.Product p "
+ "where p.categoryCode = :categoryCode ");

query.setParameter("categoryCode",
productCriteria.getCategoryCode();
return query.setCacheable(true)
.setFirstResult(firstResult)
.setMaxResults(maxResults)
.setFetchSize(100)
.list();
}
}
-------------------------------------------------------------------------------------------------

A more sophisticated implementation is helpful for dynamic queries. We define an abstract BaseQueryProvider class which can be used for dynamic query generation. This is typically useful when the report has to be generated using several parameters, some of which are optionnal.. Each derived class overrides the buildCriteria() method. This method builds a Hibernate Criteria object using the specified Criteria set as appropriate :

---------------------------------------------------------------------------------------------------

public abstract class BaseQueryProvider implements QueryProvider {

public List getObjects(CriteriaSet criteria, int firstResult, int maxResults)
throws HibernateException {

Session sess = SessionManager.currentSession();
Criteria queryCriteria = buildCriteria(criteria, sess);
return queryCriteria.setCacheable(true)
.setFirstResult(firstResult)
.setMaxResults(maxResults)
.setFetchSize(100)
.list();

}

protected abstract Criteria buildCriteria(CriteriaSet criteria, Session sess);
}
-------------------------------------------------------------------------------------------------

A typical implementation is shown here :

--------------------------------------------------------------------------------------------------

public class SalesQueryProvider extends BaseQueryProvider {

protected Criteria buildCriteria(CriteriaSet criteria,
Session sess) {
//
// Build query criteria
//
SalesCriteriaSet salesCriteria
= (SalesCriteriaSet) criteria;

Criteria queryCriteria
= sess.createCriteria(Sale.class);

if (salesCriteria.getStartDate() != null) {
queryCriteria.add(
Expression.eq("getStartDate",
salesCriteria.getStartDate()));
}
// etc...

return queryCriteria;
}
}
------------------------------------------------------------------------------------------------

Note that a QueryProvider does not need to return Hibernate-persisted objects. Large-volume queries can sometimes be more efficiently implemented by returning custom-made JavaBeans containing just the required columns. HQL allows you to to this quite easily :

---------------------------------------------------------------------------------------------------
public class CityQueryProvider implements QueryProvider {

public List getObjects(CriteriaSet criteria,
int firstResult,
int maxResults)
throws HibernateException {
//
// Build query criteria
//
Session sess = SessionManager.currentSession();
Query query
= session.find(
"select new CityItem(city.id, "
+ " city.name, "
+ " city.electrityCompany.name) "
+ " from City city "
+ " left join city.electrityCompany");

return query.setCacheable(true)
.setFirstResult(firstResult)
.setMaxResults(maxResults)
.setFetchSize(100)
.list();
}
}
-------------------------------------------------------------------------------------------------

Hibernate data access abstraction : the ReportDataSource interface
Next, we define a level of abstraction between the Hibernate querying and the JasperReport classes. The ReportDataSource does this :

--------------------------------------------------------------------------------------------------
public interface ReportDataSource extends Serializable {
Object getObject(int index);
}

--------------------------------------------------------------------------------------------------

The standard implementation of this interface reads Hibernate objects using a given QueryProvider and returns them to JasperReports one by one. Here is the source code of this class (getters, setters, logging code and error-handling code have been removed for clarty) :

---------------------------------------------------------------------------------------------------
public class ReportDataSourceImpl implements ReportDataSource {

private CriteriaSet criteriaSet;
private QueryProvider queryProvider;
private List resultPage;
private int pageStart = Integer.MAX_VALUE;
private int pageEnd = Integer.MIN_VALUE;
private static final int PAGE_SIZE = 50;

//
// Getters and setters for criteriaSet and queryProvider
//
...

public List getObjects(int firstResult,
int maxResults) {

List queryResults = getQueryProvider()
.getObjects(getCriteriaSet(),
firstResult,
maxResults);
if (resultPage == null) {
resultPage = new ArrayList(queryResults.size());
}
resultPage.clear();
for(int i = 0; i < queryResults.size(); i++) {
resultPage.add(queryResults.get(i));
}
pageStart = firstResult;
pageEnd = firstResult + queryResults.size() - 1;
return resultPage;
}
public final Object getObject(int index) {
if ((resultPage == null)
|| (index < pageStart)
|| (index > pageEnd)) {
resultPage = getObjects(index, PAGE_SIZE);
}
Object result = null;
int pos = index - pageStart;
if ((resultPage != null)
&& (resultPage.size() > pos)) {
result = resultPage.get(pos);
}
return result;
}
}

---------------------------------------------------------------------------------------------------

Finally, we have to be able to call the Hibernate data source from JasperReports. To do so, we start by looking at the JasperManager fillReport() method, which takes a JRDataSource object as its third parameter and uses it to generate the report :

---------------------------------------------------------------------------------------------------
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport, parameters, ds);

---------------------------------------------------------------------------------------------------

To implement our own optimised JRDataSource, we extended the JRAbstractBeanDataSource class. This class is presented here (logging and error-handling code has been removed for clarty).

---------------------------------------------------------------------------------------------------
public class ReportSource extends JRAbstractBeanDataSource {

private ReportDataSource dataSource;
protected int index = 0;
protected Object bean;
private static Map fieldNameMap = new HashMap();

public ReportSource(ReportDataSource dataSource) {
super(true);
this.dataSource = dataSource;
index = 0;
}

public boolean next() throws JRException {
bean = dataSource.getObject(index++);
return (bean != null);
}

public void moveFirst() throws JRException {
index = 0;
bean = dataSource.getObject(index);
}

public Object getFieldValue(JRField field) throws JRException {
String nameField = getFieldName(field.getName());
return PropertyUtils.getProperty(bean, nameField);
}
/**
* Replace the character "_" by a ".".
*
* @param fieldName the name of the field
* @return the value in the cache or make
* the replacement and return this value
*/
private String getFieldName(String fieldName) {
String filteredFieldName
= (String) fieldNameMap.get(fieldName);
if (filteredFieldName == null) {
filteredFieldName = fieldName.replace('_','.');
fieldNameMap.put(fieldName,filteredFieldName);
}
return filteredFieldName;
}
}

---------------------------------------------------------------------------------------------------

This class is basically just a proxy between JasperReports and the Hibernate data source object. The only tricky bit is field name handling. For some reason, JasperReports does not accept field names containing dots (ex. "product.code"). However, when you retrieve a set of Hibernate-persisted business objects, you often need to access object attributes. To get around this, we replace the "." by a "_" in the JasperReport template (ex. "product_code" instead of "product.code"), and convert back to a conventional JavaBean format in the getFieldName() method.

Putting it all together
So, when you put it all together, you get something like this :

---------------------------------------------------------------------------------------------------
List results = session.find("from com.acme.Sale");

Map parameters = new HashMap();
parameters.put("Title", "Sales Report");

InputStream reportStream
= this.class.getResourceAsStream("/sales-report.xml");
JasperDesign jasperDesign
= JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport
= JasperManager.compileReport(jasperDesign);

ReportDataSource hibernateDataSource
= new ReportDataSourceImpl();
hibernateDataSource.setQueryProvider(new SalesQueryProvider());
hibernateDataSource.setCriteriaSet(salesCriteria);
ReportSource rs = new ReportSource(hibernateDataSource);

JasperPrint jasperPrint
= JasperManager.fillReport(jasperReport,
parameters,
rs);
JasperExportManager.exportReportTsoPdfFile(jasperPrint,
"sales-report.pdf");

---------------------------------------------------------------------------------------------------

Further JasperReports optimisations

Compiled Report caching
In the previous code, the JasperReport is loaded and compiled before it is run. In a serverside application, for optimal performance, the reports should be loaded and compiled once and then cached. This will save several seconds on each query generation.

Optimising Hibernate Queries
The first cause of slow report generation is sub-optimal querying. Hibernate is a high-performance persistence library which gives excellent results when correctly used. So you should treate any report which takes an excessive time to generate as suspicious. Common Hibernate optimisation strategies include :

Correct use of joins
Correct use of lazy associations
Reading a subset of columns rather than whole Hibernate-persisted objects
Some Hibernate query optimisation techniques are discussed here.

Conclusion

JasperReports is a powerful and flexible reporting tool. To achieve high-performance Hibernate intergration however, some extra work is needed. One way is by writing optimised data access classes which can be plugged into the JasperReports architecture. Using this approach, you can take advantage of the full power of Hibernate in your JasperReports reporting solutions.

matthew 2006-06-29 20:00 发表评论

jasper report 使用 hibernate 数据源(转 hibernate 官方网站提供)

matthew — Thu, 29 Jun 2006 11:58:00 GMT

注: 此方法使用简单，但是没有分页读取数据，适合数据量不大情况下的报表

原文： http://www.hibernate.org/79.html

Using JasperReports with Hibernate
This section will demonstrate a couple of ways to use the results of a Hibernate query as the datasource of a report in JasperReports.

When the Hibernate query returns a simple collection of objects, The JRBeanCollectionDataSource class in the JasperReports library will work fine.

--------------------------------------------------------------------------------------------------------
List cats = session.find("from eg.Cat");

Map parameters = new HashMap();
parameters.put("Title", "The Cat Report");

InputStream reportStream = this.class.getResourceAsStream("/the-cat-report.xml");
JasperDesign jasperDesign = JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport = JasperManager.compileReport(jasperDesign);

JRBeanCollectionDataSource ds = new JRBeanCollectionDataSource(cats);
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport, parameters, ds);

JasperManager.printReportToPdfFile(jasperPrint, "the-cat-report.pdf");

--------------------------------------------------------------------------------------------------------

However, when the Hibernate query returns tuples of objects (each tuple as an array, each array as an element in the returned List), things get a little tricky. Jasper needs a way to reference each object in the array by a field name. This class is a good solution, but at this time you are required to pass an array of field names matching the results of the query.

--------------------------------------------------------------------------------------------------------
public class HibernateQueryResultDataSource implements JRDataSource {

private String[] fields;
private Iterator iterator;
private Object currentValue;

public HibernateQueryResultDataSource(List list, String[] fields) {
this.fields = fields;
this.iterator = list.iterator();
}

public Object getFieldValue(JRField field) throws JRException {
Object value = null;
int index = getFieldIndex(field.getName());
if (index > -1) {
Object[] values = (Object[])currentValue;
value = values[index];
}
return value;
}

public boolean next() throws JRException {
currentValue = iterator.hasNext() ? iterator.next() : null;
return (currentValue != null);
}

private int getFieldIndex(String field) {
int index = -1;
for (int i = 0; i < fields.length; i++) {
if (fields .equals(field)) {
index = i;
break;
}
}
return index;
}

}

--------------------------------------------------------------------------------------------------------

Now running your report would look something like this:

--------------------------------------------------------------------------------------------------------
List cats = session.find("select cat.type, cat.birthdate, cat.name from eg.DomesticCat cat");

Map parameters = new HashMap();
parameters.put("Title", "The Cat Report");

InputStream reportStream = this.class.getResourceAsStream("/the-cat-report.xml");
JasperDesign jasperDesign = JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport = JasperManager.compileReport(jasperDesign);

String[] fields = new String[] { "type", "birthdate", "name"};
HibernateQueryResultDataSource ds = new HibernateQueryResultDataSource(cats, fields);
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport, parameters, ds);

JasperManager.printReportToPdfFile(jasperPrint, "the-cat-report.pdf");

--------------------------------------------------------------------------------------------------------

Another, alternate implementation, from Erik Romson:

--------------------------------------------------------------------------------------------------------
public class HibernateQueryResultDataSource implements JRDataSource
{
private static final transient Logger logger =
Logger.Factory.getInstance(HibernateQueryResultDataSource.class);
protected HashMap fieldsToIdxMap=new HashMap();
protected Iterator iterator;
protected Object currentValue;
List values;

public HibernateQueryResultDataSource(List list, String query)
{
int start =query.indexOf("select ");
int stop =query.indexOf(" from ");
Assertion.assertTrue(
(start!=-1) &&
(stop!=-1),
"The query "+
query+
" must be of the form select x,x from ..."
);
start+="select".length();
String parameters=query.substring(start,stop);
parameters=parameters.trim();
Assertion.assertTrue(
parameters.length()>0,
"The query "+
query+
" seems to be weird"
);
StringTokenizer tokenizer=new StringTokenizer(parameters,",");
int idx=0;
while( tokenizer.hasMoreTokens() )
{
String parameter=tokenizer.nextToken();
fieldsToIdxMap.put( parameter.trim(), new Integer(idx) );
idx++;
}
values=list;
this.iterator = list.iterator();
}
public Object getFieldValue(JRField field) throws JRException
{
String fieldName=field.getName().replace('_','.');
//JasperReports does not allow '.' in field names, so we
//use '_' for nested properties instead and must convert here
//(comment added by kbrown)
Integer idxInt=(Integer) fieldsToIdxMap.get(fieldName);
if (idxInt==null)
{
Assertion.fail(
"The field \""+
fieldName+
"\" did not have an index mapping. Should be one off "+
fieldsToIdxMap.keySet()
);
}
Object[] values = (Object[]) currentValue;
Assertion.assertTrue(
idxInt.intValue()
"The index from field "+
fieldName+
" was illegal"
);
Object value= values[ idxInt.intValue() ];
if ( logger.isDebugEnabled() )
{
logger.debug("fetched value "+value+" from field "+fieldName);
}
return value;
}

public boolean next() throws JRException
{
currentValue = iterator.hasNext() ? iterator.next() : null;
return currentValue != null;
}

public List getValues()
{
return values;
}
}

--------------------------------------------------------------------------------------------------------

Using JasperReports with Hibernate
This section will demonstrate a couple of ways to use the results of a Hibernate query as the datasource of a report in JasperReports.

When the Hibernate query returns a simple collection of objects, The JRBeanCollectionDataSource class in the JasperReports library will work fine.

List cats = session.find("from eg.Cat");

Map parameters = new HashMap();
parameters.put("Title", "The Cat Report");

InputStream reportStream = this.class.getResourceAsStream("/the-cat-report.xml");
JasperDesign jasperDesign = JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport = JasperManager.compileReport(jasperDesign);

JRBeanCollectionDataSource ds = new JRBeanCollectionDataSource(cats);
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport, parameters, ds);

JasperManager.printReportToPdfFile(jasperPrint, "the-cat-report.pdf");
However, when the Hibernate query returns tuples of objects (each tuple as an array, each array as an element in the returned List), things get a little tricky. Jasper needs a way to reference each object in the array by a field name. This class is a good solution, but at this time you are required to pass an array of field names matching the results of the query.

public class HibernateQueryResultDataSource implements JRDataSource {

private String[] fields;
private Iterator iterator;
private Object currentValue;

public HibernateQueryResultDataSource(List list, String[] fields) {
this.fields = fields;
this.iterator = list.iterator();
}

public Object getFieldValue(JRField field) throws JRException {
Object value = null;
int index = getFieldIndex(field.getName());
if (index > -1) {
Object[] values = (Object[])currentValue;
value = values[index];
}
return value;
}

public boolean next() throws JRException {
currentValue = iterator.hasNext() ? iterator.next() : null;
return (currentValue != null);
}

private int getFieldIndex(String field) {
int index = -1;
for (int i = 0; i < fields.length; i++) {
if (fields .equals(field)) {
index = i;
break;
}
}
return index;
}

}
Now running your report would look something like this:

List cats = session.find("select cat.type, cat.birthdate, cat.name from eg.DomesticCat cat");

Map parameters = new HashMap();
parameters.put("Title", "The Cat Report");

InputStream reportStream = this.class.getResourceAsStream("/the-cat-report.xml");
JasperDesign jasperDesign = JasperManager.loadXmlDesign(reportStream);
JasperReport jasperReport = JasperManager.compileReport(jasperDesign);

String[] fields = new String[] { "type", "birthdate", "name"};
HibernateQueryResultDataSource ds = new HibernateQueryResultDataSource(cats, fields);
JasperPrint jasperPrint = JasperManager.fillReport(jasperReport, parameters, ds);

JasperManager.printReportToPdfFile(jasperPrint, "the-cat-report.pdf");

--------------------------------------------------------------------------------

Another, alternate implementation, from Erik Romson:

public class HibernateQueryResultDataSource implements JRDataSource
{
private static final transient Logger logger =
Logger.Factory.getInstance(HibernateQueryResultDataSource.class);
protected HashMap fieldsToIdxMap=new HashMap();
protected Iterator iterator;
protected Object currentValue;
List values;

public HibernateQueryResultDataSource(List list, String query)
{
int start =query.indexOf("select ");
int stop =query.indexOf(" from ");
Assertion.assertTrue(
(start!=-1) &&
(stop!=-1),
"The query "+
query+
" must be of the form select x,x from ..."
);
start+="select".length();
String parameters=query.substring(start,stop);
parameters=parameters.trim();
Assertion.assertTrue(
parameters.length()>0,
"The query "+
query+
" seems to be weird"
);
StringTokenizer tokenizer=new StringTokenizer(parameters,",");
int idx=0;
while( tokenizer.hasMoreTokens() )
{
String parameter=tokenizer.nextToken();
fieldsToIdxMap.put( parameter.trim(), new Integer(idx) );
idx++;
}
values=list;
this.iterator = list.iterator();
}

public Object getFieldValue(JRField field) throws JRException
{
String fieldName=field.getName().replace('_','.');
//JasperReports does not allow '.' in field names, so we
//use '_' for nested properties instead and must convert here
//(comment added by kbrown)
Integer idxInt=(Integer) fieldsToIdxMap.get(fieldName);
if (idxInt==null)
{
Assertion.fail(
"The field \""+
fieldName+
"\" did not have an index mapping. Should be one off "+
fieldsToIdxMap.keySet()
);
}
Object[] values = (Object[]) currentValue;
Assertion.assertTrue(
idxInt.intValue()
"The index from field "+
fieldName+
" was illegal"
);
Object value= values[ idxInt.intValue() ];
if ( logger.isDebugEnabled() )
{
logger.debug("fetched value "+value+" from field "+fieldName);
}
return value;
}

public boolean next() throws JRException
{
currentValue = iterator.hasNext() ? iterator.next() : null;
return currentValue != null;
}

public List getValues()
{
return values;
}
}

--------------------------------------------------------------------------------

Using the information from this page I've made a patch to JasperReports 0.6.5. You can find the patch at: http://www.waltermourao.com.br/JasperReports/jr65_hql.zip or you can download the full version from: http://www.waltermourao.com.br/JasperReports/jasperreports-hql-0.6.5.zip

matthew 2006-06-29 19:58 发表评论

JasperReport 用户手册－转贴

matthew — Wed, 07 Jun 2006 01:30:00 GMT

摘要: JasperReport 用户手册的翻译 1 简介 JasperReport 是一个强大、灵活的报表生成工具，能够展示丰富的页面内容... 阅读全文

matthew 2006-06-07 09:30 发表评论

jasperreport+ireport报表设计中遇到的问题

matthew — Tue, 06 Jun 2006 11:43:00 GMT

今天是个好日子，200666。把自己这段时间遇到的几个问题记录下来吧。
问题1:最常见的问题就是中文问题，不能显示中文或者是乱码。
解决办法：在需要显示中文的field里面(包括静态的)设置PDF font name:STSong-Light,PDF encoding:UniGB-UCS2-H (Chinese Simplified)。即可！

问题2:设计静态报表模板时，word输出格式问题，预览时总是空白页。
解决办法：可以通过设置报表属性中的“当没有数据时的显示方式”为：除detail外的所有地方。

问题3:当输出HTML格式报表时总是出现空白页问题。
解决办法:原因是我用的jasperreport版本是1.2.2,在这个版本中出现一个小bug，就是编译输出的html源代码为，IE不能编译。办法是修改源码，或者手工添加代码把改为，最后也可以把你的lib目录下的jasperreport的jar包的版本换为1.2.1
....待续

matthew 2006-06-06 19:43 发表评论

Ireport+Jasperreport报表设计－转贴

matthew — Tue, 06 Jun 2006 11:11:00 GMT

摘要: 第一部分：使用iReport制作报表的详细过程（Windows环境下） 1 、前言在网络上可以搜索到很多使用 iReport 和 Jasperreport 配合实现各种报表任务的文章，但是我觉得很少有一篇（几乎没有）做一个比较详细的介绍如何使用... 阅读全文

matthew 2006-06-06 19:11 发表评论

关于Java报表－jasperreport

matthew — Tue, 06 Jun 2006 10:53:00 GMT

新开了个Blog,该填点东西进来呵。这段时间由于种种原因在研究B/S架构下的报表设计，也早想写点自己的经验记录自己的学习过程。总的感觉报表是个比较麻烦的东西，算是个细致活。我会在往后的学习中把一些遇到的问题和解决办法记录下来，首先还是贴点别人的文章吧。。。

matthew 2006-06-06 18:53 发表评论