Jasperreports和iReport 的使用

 

²      下载

iReport- 0.4.0 (报表的可视化编辑工具)

iTextAsian.jar加入classpath,如果报表中含有亚洲字符，输出PDF文件时才能正常的显示。

 

²      iReport的使用步骤

 

1、 选择工具栏上新建报表，设置基本信息，包括名称，打印纸大小，打印方向（纵向或者是横向），在more标签页选择XML编码方式，如果需要XML支持中文，那么XML ENCODING为GB2312，还可选择总标题和总结为单独一页打印。

 

2、 报表上主要的元素为静态文本(static text)、变量(variable)、动态域(Field)、参数(Parameter)。静态文本就是显示在报表上不变的文字。变量是指通过系统自带的计算得到的一些值（如当前页、总记录数等）。动态域可以是连接数据库时所的的字段，也可以是通过自定义数据源(可能是包含一组数据的实体类)。参数是程序运行时传到报表内部的变量，通常通过Map形式传入，可作为显示变量或者用于sql语句中变化的条件。

注：$P{param_name}代表参数，{}内是参数的名称，在报表中设定后，在运行的时候通过从外部传入的参数来动态生成标题等数据，并且可以作为查询条件传入sql语句使用(如果是使用JDBC直接连接数据库的话)

 

$V{PAGE_NUMBER}代表当前页数，$V代表variable，对现有的group，$V{groupname_COUNT}代表当前组的记录数

 

$F{Field_name}表示字段，是报表中最重要的部分。如果JDBC方式的连接，输入sql查询语句就可得到所有查询所得到的字段；如果是Custom Datasource方式，新建一字段，例如user_id。数据类中getFieldValue(JRField field)，field就是报表中的$F{Field_name}。程序中根据JRField对象的name属性来确定返回哪个值

//代表返回当前行的第四个字段

if("user_id".equals(field.getName()))return data[index][3]；

    

3、 拖拽上述元素到报表页面上后，需要设定他们的字体fontname是用ireport预览时使用的字体，如果可能含有中文，那么必须选择一个中文字体，否则无法正常显示。PDF font name选择STSONG_LIGHT,在PDF Embeded PDF Encoding复选框上打钩，并在下拉框中选择UniGB_UCS2_H(Chinese_simplified) 。这样输出的pdf文件才能正常显示中文。

注意：如果用ireport生成含中文的报表，则需要把iTextAsian.jar拷贝到iReport的lib文件夹下。

在TextField标签页里选择文本域的类，重新选择一下evaluation time为now（如果不激活该下拉框，运行时候会出现evaluation time 错误字样）。如果文本在某个组里，那么从Evaluation group里选择相应的组。勾选blank when null 。TextField expression是文本的表达式，能够完成一些如字符串连接等简单操作，比如”当前页”+$V{PAGE_NUMBER}。Pattern里点击create按钮可选择时间日期相关的格式化后的形式，便于报表打印时间等动态生成。

 

4、 在build菜单内能选择多种方式，默认的为编译以后用JRViewer在iReport中预览显示效果，选择pdf preview就是输出为一个PDF文件来预览显示效果。在实际的web打印中，使用jaseperreport提供的方法生成PDF。

5、 几种Datasource的方法

a)      JDBC连接数据库。新建一个连接，选择类型为Database JDBC connection，给这个连接一个名字，填写driver，数据库连接的url，数据库用户名密码等信息后，测试通过即可建立连接。

b)      Customer JRDatasource取得数据。首先写一个包含数据的类，它实现了JRDatasource接口，实现next()和getFieldValue(JRFeild field)两个方法。Next方法用于取得下一条记录，getFieldValue方法则根据jasper文件中定义的field的名称来取得对应列的数据。另外，为了在ireport中能预览效果，我们还需要构造取得该数据源类的方法，通常命名为XXXDatasourceFactory类，它提供了getTheDatasource类取得数据源类这个对象。在连接时，填上工厂类和取得数据源类的对应方法后即可得到数据。

然后在菜单上的build->set active connection选择连接，在datasource->report query里输入sql语句或javabean方式得到数据域。得到的数据域按名存放在Fields里，可拖拽到页面报表上。

6、 编译过程就是把 *.jrxml文件编译成jasperreport能使用的*.jasper文件。我们从ireport只需要得到一个jasper文件即可。

 

 

²      WEB打印程序

1、 首先需要取的数据的类，形成对象数组的方法可以通过JDBC或其他方式计算获得。

Public Datasource implements JRDatasource{

     Private Object[][] data={};

     Public void next(){

       //取得对象数组下一行

}

Public object getFieldValue(JRField field){

     //逐个字符串匹配域的名称并返回相应的值

}

}

2、 调用jasperreport里生成PDF的方法

JasperRunManager.runReportToPdfFile

(String arg,String output,Map param,JRDatasource datasource)

 

//arg表示该报表使用的jasper文件目录， output指输入pdf文件的路径和文件名，param指报表中需要使用的参数的map，datasource就是包含数据的实体类。

注意：在Tomcat下运行时需要加入iTextAsian.jar到common/lib目录下。否则会出现STSONG_LIGHT或UniGB_UCS2_H无法找到的错误