Jasperreport+ireport 实践操作及 web 应用【转】

Jasperreport+ireport 实践操作及 web 应用【转】

 

学习完jasperreports+ireport,给我感觉深刻,不仅掌握了报表开发技术,还掌握了如何在web中生成pdf,xls,rtf文件,以下是jasperreports+ireport开发知识点:
1.字段,变量,参数,传参
2.矢量图,位图
3.超链接,锚
4.数据源,自定义数据源
5.国际化(I18N)
6.脚本
7.子报表
8.图表(饼图,柱图,线图)
9.导出pdf,xls,html...

操作版本: jasperreports2.0.2+ireport2.0.2

说明: 本文并非入门级教程,所以阅读本文需要有一定基础.
以下针对每个知识点,讲解在ireport中是如何操作,以及在真实项目中如何部署.

1. 字段 , 变量 , 参数 , 传参

这个知识点很简单,在ireport的 view 菜单下有 Fields,Variables,Parameters三个菜单,如要定义一个参数,可进行如下操作.
点 击 Parameters 菜单,此时弹出一个操作参数的窗口,单击 New 按钮,输入参数名(Parameter Name),选择参数类型(Parameter Class Type),如要赋一个默认值则填写默认值表达式(Default Value Expression)(默认值如为字符串则以"string"形式填写,如为整形则以 new Integer(1) 形式填写,以此类推.),填好后,点 OK 就新建了一个参数了.

定义字段与定义参数是一样的操作,至于定义变量操作差不多,也相对少用一些,在此就不讲述.

在ireport 中如何引用字段, 变量, 参数?
引用字段使用 $F{field_name}
引用变量使用 $V{variable_name}
引用参数使用 $P{param_name}  或 $P!{param_name}
$P!{param_name}一般用于拼接sql语句,它的值可以与sql语句拼接后,再去执行查询.
例:定义一个参数名为 where 类型为String 默认值为 "where id=100"
有一查询语句:select * from user $P!{where}
则执行查询时会替换成:select * from user where id=100

$P{param_name}在sql语句中使用时,也有一特殊情况.
例:有一参数名为 id,类型为Integer,默认值为 new Integer(100)
有一查询语句:select * from user where id=$P{id}
执行查询可正常查询,但如果有一参数名为 name,类型为String,默认值为"zhanngle"
有一查询语句:select * from user where name=$P{name}
执行查询时出错,不知道为什么(即使数据库中有该条记录),不知是不是bug,还是自已哪里弄错了.解决办法是,将查询语句改为:select * from user where name='$P!{name}'
可以证明$P!{}语法,只做替换操作,如上只将$P!{name}替换成zhanngle.
也可以证明$P{}语法,在sql语句中使用时,值为数字类型还可以正常执行,如为字符串类型则会出错.

在程序中如何传参?
如上例定义了一个name参数,那么在程序中如何动态传参查询出不同的记录呢,也很简单.
程序代码如下:

Map params = new  HashMap();
params.put( " name " , " zhanngle " );
JasperPrint print = JasperFillManager.fillReport(jasper, params,conn);

就是将参数名和值put进入一map,然后再填充报表时将map传过去就行了.

2. 矢量图 , 位图

Jasperreports支持矢量图与位图功能,是因为他封装了jfreechart(jfreechart是一个开源的图形解决方案库), 使用ireport绘制矢量图或插入位图,可以不用我们写一行代码,这些jasperreports已经为我们全部封装好了,ireport只提供了三种 矢量图,分别是矩形,圆形,线条,下面先介绍如何绘制矢量图,再介绍如何插入位图.

 

初始工作:先新建一个空报表

绘制矩形: 点击工具栏的 Rectangle 按钮,在Detail区域,绘制一个矩形,绘制方法与windows自带的画图工具一样,绘制好后,在该矩形上点右键,选属性,即可设置该矩形的属性,大家可以根据自己需要进行设置,如设置前景色,背景色...

绘制圆形与绘制线条方法一样,只需要在工具栏点相应的圆形工具或线条工具就行了.

很简单吧.

 

问题出现

1.        图与图之间(更具体的说法,应该是元素与元素之间)不能有任何重叠,如重叠则只能显示最上层的图.

2.        使用线条工具可以绘制斜线,当导出为pdf文件,没有任何问题,当导出html,xls文件时,发现斜线变成了矩形,解决方案是:使用外部图形编辑软件,绘制一条斜线,并保存为图片文件,再将这个图片文件插入到报表相应位置中.

在ireport 中如何测试预览pdf,html,xls… 文件?

1．首先要设置一下pdf文件有什么预览，html文件用什么预览…

点Options -> Settings -> External Programs,在弹出的窗口中填写正确的外部程序。

如我的设置如下：

External Editor: C:/Program Files/EditPlus 2/editplus.exe (jrxml文件编辑器)

PDF Viewer: D:/Program Files/Adobe/Acrobat 7.0/Reader/AcroRd32.exe

HTML Viewer: C:/Program Files/Internet Explorer/IEXPLORE.EXE

XLS Viewer: "D:/Program Files/Microsoft Office/OFFICE11/EXCEL.EXE"

RTF Viewer: C:/Program Files/Windows NT/Accessories/wordpad.exe

该步操作只要设置一次，以后就不需要再设置了。

2．设置你要预览的是什么文件，ireport默认预览的是pdf文件，但不是使用我们配制的外部程序预览的，而是使用 jasperreports的JRViewer预览的。你也可以设置使用我们配制的外部程序来预览，点Build -> PDF Preview,再点Execute (empty data source)按钮，即可预览PDF文件。点Build -> HTML Preview,再点Execute (empty data source)按钮，即可预览HTML文件。

注意： 任何一个报表都必须要有一个数据源来为报表提供数据。

Execute (empty data source)的意思就是构造一个只有一条记录的数据源传给报表，并且这条记录的值都是null，这个按钮在测试报表不需要数据时，非常有用。

Execute (whit active connection)的意思就是将当前激活的连接或数据源传给报表，并生成报表。

 

位图

插入位图也很简单,在工具栏上点击 Image 按钮,然后在 Detail 区域绘制一个”矩形”(与绘制矩形操作相同),此时可以在你绘制的区域看到一个图片,在这个图片上点右键,选属性,选 Image 选项卡,点 “Find …”按钮,选择你要插入的图片,OK后,就可以看到你要插入的图片了.

 

在真实项目中如何插入图片, 动态改变图片?

在真实项目中可不能使用上面介绍的方法来插入图片,上面的方法只是启到 hello world 的作用,要想在真实项目中插入图片,可以按照以下方法来配制.

1.        定义一个参数名为 imageName 类型:String 没有默认值  

2.        在报表设计界面中绘制一个Image,打开该Image的属性框,选Image选项卡,在Image Expression文本框中输入:$P{imageName},代表该图片的路径是由imageName的参数值来决定的,我们可以在程序中传入该参数的值.

如何在程序中传入该参数值呢?

示例代码如下:

ServletContext context = request.getSession().getServletContext();
Map params = new  HashMap();
Params.put(“imageName”,context.getRealPath(“ / reports / test.jpg”));
JasperPrint print = JasperFillManager.fillReport(jasper, params,conn);

 

传入不同的路径值即可动态改变图片

 

在html 中如何显示图片?

当导出带有图片的报表到pdf,xls文件时,没有任何问题,但导出到html文件时,发现图片不能正常显示,不要急,jasperreports已经为我们提供了解决方案.解决步骤如下:

1.将以下代码添加到web.xml文件中

< servlet >
     < servlet-name > JasperreportsImageServlet </ servlet-name >
     < servlet-class > net.sf.jasperreports.j2ee.servlets.ImageServlet </ servlet-class >
</ servlet >
 
< servlet-mapping >
     < servlet-name > JasperreportsImageServlet </ servlet-name >
     < url-pattern > /servlets/image </ url-pattern >
</ servlet-mapping >

2.程序代码按以下方式编写

ServletContext context = request.getSession().getServletContext();
Map params = new  HashMap();
Params.put(“imageName”,context.getRealPath(“ / reports / test.jpg”));
Map imageMap = new  HashMap();
request.getSession().setAttribute( " IMAGES_MAP " , imageMap);
 
JasperPrint print = JasperFillManager.fillReport(jasper,params,conn);
request.getSession().setAttribute(net.sf.jasperreports.j2ee.servlets.ImageServlet.DEFAULT_JASPER_PRINT_SESSION_ATTRIBUTE,print);
 
JRHtmlExporter exporter  =   new  JRHtmlExporter();
exporter.setParameter(JRExporterParameter.JASPER_PRINT, print);
exporter.setParameter(JRExporterParameter.OUTPUT_WRITER, response.getWriter());
exporter.setParameter(JRHtmlExporterParameter.IMAGES_MAP,imageMap);
exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI, request.getContextPath() + " /servlets/image?image= " );
exporter.setParameter(JRHtmlExporterParameter.IS_REMOVE_EMPTY_SPACE_BETWEEN_ROWS, Boolean.TRUE);
exporter.setParameter(JRHtmlExporterParameter.IS_USING_IMAGES_TO_ALIGN, Boolean.TRUE);

 

3. 超链接 , 锚

有时我们想在报表中为某个关键字添加超链接或锚,使鼠标点击该关键字时跳转页面.针对这一小功能,jasperreports 也提供了支持,在ireport中操作很简单.不是所有的元素都支持超链接,目前我所知道支持超链接的常用元素有,动态文本框元素(Text Field),位图元素(Image),图表元素(Chart tool).这三种元素设置超链接的方法都是一样,所以只介绍动态文本框如何设置超链接.

 

如何在 ireport 中插入超链接 ?

由于静态文本框不支持超链接,所以只能通过动态文本框为静态文字设置超链接,操作方法如下所述:

1.在工具栏中选中 Text Field 按钮,回到 Detail 区域,绘制一个Text Field (与绘制矩形方法一样),然后在该Text Field 上点右键,选 Edit Expresion,在弹出的窗口中输入表达式 "CSDN",然后再点 apply 按钮.( 注意: "CSDN"要包含双引号)

2.打开该 Text Field 的属性框,选 Hyperlink 选项卡,将 Hyperlink target 改为 blank,Hyperlink Type 改为 Reference,在Hyperlink Reference Expression框中输入" http://www.csdn.net ",再点关闭.( 注意: " http://www.csdn.net " 要包含双引号)

此时一个超链接已设置好,导出pdf,html文件看看,点击CSDN即可弹出CSDN的网页.

 

如何在ireport 中插入锚?

其实锚是超链接的一种特殊形式,因此支持超链接的元素都支持锚,不支持超链接的元素都不支持锚,锚的设置也很简单,只要你知道使用html的<a>设置锚,那么ireport也是差不多的.

设置锚,也需要两步操作

1.设置锚对象

在 Title 区域绘制一个动态文本框,输入表达式 “2007年终财务报表”,再打开它的Hyperlink 选项卡,在 Anchor Name Expression 框中输入 “title”,点关闭.此时已定义了一个锚对象.它的锚名字是 title.

2.链接锚对象

在 Detail区域绘制一个动态文本框,输入表达式 “返回顶部”,再打开它的 Hyperlink 选项卡,将Hyperlink target改为 self,Hyperlink Type 改为 LocalAnchor,在Hyperlink Anchor Expression框中输入 “title”,点关闭.

一个锚链接已设置完毕,导出pdf,html看看,当然,如果你的报表内容不多,那么锚起不到任何作用.

 

4. 数据源 , 自定义数据源

数据源顾名思义数据来源，即报表数据从何而来。jasperreports可以从数据库、XML文件、CSV文件、 java.util.Collection对象以及自定义数据源得到数据。在真实项目中，报表数据一般从数据库得到，下面介绍在ireport中如何配制 连接制数据库的数据源。操作步骤如下：

 

说明： 本例以MySql数据库来配制数据源

新建一个Document（报表文档），点 Data ->  Connections/Data Sources -> New -> Database JDBC Connection -> Next。在弹出的窗口中按照提示填写属性，例：

Name：mysql,

JDBC Driver：com.mysql.jdbc.Driver

JDBC URL：jdbc:mysql://localhost:3306/db_name

User Name：root

Password：your_password

 

填好后，单击Test按钮，如弹出 Connection test successful!，则代表数据源配制正确，并再点Save 按钮，保存配制。否则配制错误，请检查哪里出错。

配制好后，即可连接数据库。

那么如何用数据源查询数据库，并将查询结果显示在报表上呢？

说明： 本例操作必须配制好数据库数据源才能正常操作。而且连接的数据库里要有表。

点 Data -> Report Query，在弹出的窗口中输入SQL查询语句：select * from t_users 。

如果sql语句正确将在窗口底部显示该表的所有字段，点击OK，即完成了报表查询工作。

大家可以查看一下Fields面板，ireport已经自动将查询出的所有字段，定义成字段对象了（也就是最前面所说的定义字段）。

说完了如何将数据查询出来，接下来的工作就是如何将数据显示在报表界面上。

点View -> Fields打开Fields面板，在面板上任意选一个字段，将它拖到Detail区域的左上角对齐，再选一个字段拖到Detail区域的中上角，好了就 用两字段做试验吧，只要Detail区域够宽，大家可以多拖两个字段到Detail区域，拖到Detail区域的字段将在报表中显示。调整好Detail 区域的高度，运行（Build -> Execute (whit active connection)）一下看看吧，如果你看到有正确数据，那恭喜你，你试验成功了！

 

自定义数据源

有时，你可能需要自定义一个数据源来满足你的需求，jasperreports对此也提供了良好支持。

只要你实现JRDataSource接口，就行了，很简单吧！

JRDataSource接口声明如下：

public   interface  JRDataSource
... {
public   boolean  next()  throws  JRException;
public  Object getFieldValue(JRField jrField)  throws
JRException;
}

以下我是我自定义的一个数据源代码：

1．先创建一个Bean类，该bean类属性全是大写，这是因为ireport自动定义字段时，字段名全是大写，你也可以手动改为小写，那么该bean类属性就可以为小写，你要确保bean类的属性名与字段名一致（包括大小写）。

 

package  test;
import  java.sql.Timestamp;
 
publicclass Bean  ... {
    privateintID;
     private  String NAME;
     private  String NICKNAME;
    privateintSCORE;
    privatefloatBALANCE;
     private  Timestamp LASTLOGINDATE;
 
    publicfloat getBALANCE()  ... {
       returnBALANCE;
    }
    publicvoid setBALANCE( float  balance)  ... {
        this .BALANCE  =  balance;
    }
    publicint getID()  ... {
       returnID;
    }
    publicvoid setID( int  id)  ... {
        this .ID  =  id;
    }
     public  Timestamp getLASTLOGINDATE()  ... {
       returnLASTLOGINDATE;
    }
    publicvoid setLASTLOGINDATE(Timestamp lastLoginDate)  ... {
        this .LASTLOGINDATE  =  lastLoginDate;
    }
     public  String getNAME()  ... {
       returnNAME;
    }
    publicvoid setNAME(String name)  ... {
        this .NAME  =  name;
    }