JasperReports入门详细步骤

JasperReports报表生成的基本步骤：

1.扩展名为.jrxml的文件为标准的xml文件，该文件定义了报表的格式和

数据构成。可以通过jasperReports的“黄金搭档”iReport以可视化的方式生成并编辑这个文件。

2.jrxml文件经过JasperReports API 编译后将生成扩展名为.jasper的二

进制文件。

3.可以调用JasperReports API针对jasper文件进行数据和参数的填充，

生成扩展名为.jrprint的文件。

4.调用JasperReports API可以将jrprint文件最终导出成PDF、Excel、

Html等各种格式的文件。

下面将采用iReport + JasperReports 生成如下图的PDF格式报表，表格中的数据来源于数据库，是在固定格式报表基础上，由JasperReport填充得到的。整个报表的生成过程需要两个步骤：

1.使用iReport生成规定报表格式和数据构成的jrxml文件。

2.调用JasperReports API 编译、填充并导出固定格式的报表。

一、用iReport生成报表文件（.jrxml）

开源工具iReport用于定义报表的格式，可以从其官方网站下载

/cap3.html

本应用所使用的是iReport-1.2.2-windows-installer.exe 安装程序，启动后，按照向导即可安装（要确认系统中装有1.4版本以上JDK）。下面的操作大致分为12个步骤：

步骤1：安装成功后启动该程序，将显示如下画面，选择菜单“File->New Document”新建报表文档，可在弹出的对话框选择报表的大小、版式等。

步骤2：按照默认版式创建报表，选择菜单“Data->Connections/Datasources”指定数据库连接或数据源，在弹出的对话框中单击“New”，并在弹出的对话框中指定数据库的连接参数（驱动类、URL、用户名和密码等）iReport通过JDBC 连接数据库，要确认相应数据库的驱动类置于iReport安装路径的lib文件夹下。

步骤3：选择菜单“Data->Report Query”在弹出的对话框中输入SQL语句：

select id, name, salary from emp，选中所有查询的字段后，单击“OK”。

该SQL语句查询的数据为将来报表中要显示的数据，除了用SQL语句，这里还支持HQL（Hibernate Query Language）等其他多种查询方式。这样的操作将在报表的xml文件中生成如下定义：

emp]]>

其中元素定义了用于获取数据的查询语句，将来JasperReports将通过这样的方式查询数据。元素定义了对应于查询结果的字段名称和类型，将来报表中可以使用$F{字段名称}获取并显示查询得到的数据。

步骤4：选择菜单“Format->Styles”用于指定报表元素将使用的样式，这里的Style类似于HTML中CSS样式，一个样式规定了字体、前景色、背景色等显示特征，样式创建后，可以将其施加于特定的报表元素。为了便于维护，样式之间可以实现继承关系，子样式将拥有父样式的一切特征。在弹出的对话框中单击“New”指定一个名为default的样式（通过Style name指定样式名称），指定

其字体、颜色等特征。

步骤5：继续指定一些其他的样式，如用于表头字体的“灰底白字”的样式header，将这些样式的Parent style值指定为刚刚创建的default样式，即指定default 是所有样式的父样式，这样可以通过编辑default样式指定一些所有样式共同的特征。

步骤6：单击“Edit->Insert element...->Static Text”或使用工具栏的按钮，在报表页面中添加静态文本框，将这些文本框置于合适的位置并填入文字，作为表头，通过右边的Element properties 视图将这些文本框的Style(样式)置为方才创建的header。

步骤7：打开右边Library视图的Fields图标，可以看到id，name，salary三个标识，这三个标识对应在“步骤3”中创建的“查询字段”，用鼠标直接拖动这些字段到报表页面的适当位置，这样的操作将在报表xml文本中产生形如：

的文本。其中$F{字段名称}表示该字段的查询

值。

步骤8：在Library视图中单击右键，在弹出的快捷菜单中选择

“Add...->Parameter”，用于创建参数，在弹出的对话框中指定参数的名称和数据类型。

步骤9：在Library视图的Parameter下可以看到刚刚建立的名为“Title”的参数，用鼠标拖到其到指定位置，并适用在步骤5中创建的title样式，此处为报表的标题。这样的操作将在xml文件中产生如下内容：

其中的$P{Title}对应Title参数的值，将来将通过JasperReports API 对“Title”参数赋值。