JasperReports的简单介绍

最新推荐文章于 2025-07-15 14:01:08 发布

DryKillLogic

最新推荐文章于 2025-07-15 14:01:08 发布

阅读量1.3k

点赞数

CC 4.0 BY-SA版权

分类专栏：第三方开源技术文章标签： JasperReports

本文链接：https://blog.youkuaiyun.com/DryKillLogic/article/details/37928685

第三方开源技术专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍如何使用JasperReports创建复杂报表的过程。从安装配置到数据源设置，再到报表模板设计，最后到Java代码调用，一步步指导读者掌握报表制作技巧。

简单介绍

JasperReports是世界上最流行的开源报告引擎。它是完全用Java编写的,它是能够使用的数据来自任何类型的数据源,并生成像素级的文档,可以查看、打印或导出在多种文档格式,包括HTML、PDF、Excel、OpenOffice和doc。JasperReports是一个用Java开发的开源的程序库，使用户能够透过它，利用Java语言来开发具有报告功能的程序。JasperReports的模版采用XML格式。iReport是开发JasperReports的图像换工具。

JasperReports可以通过多种数据源（XML、JavaBean、JDBC等）来生成多种格式的报表。这里使用JDBC连接数据库作为数据源，填充报表内容来产生数据。

产生JasperReports报表之前需要先创建报表模板，JasperReports采用XML的格式定义模板，模板基本分为如下几个部分：

title

title 段只在整个报表的第一页的最上面部分显示，除了第一页以外，不管报表中共有多少个页面也不会再出现title段中的内容。

pageHeader

pageHeader 段中的内容将会在整个报表中的每一个页面中都会出现，显示在位置在页面的上部，如果是报表的第一页，pageHeader 中的内容将显示在title段下面，除了第一页以外的其他所有页面中pageHeader 中的内容将在显示在页面的最上端。

columnHeader

针对detail段的表头段，一般情况下在这个段中画报表中列的列标题。每页均会出现一次。

detail

报表内容段，在这个段中设计报表中需要重复出现的内容，detail 段中的内容每页都会出现。

columnFooter

针对detail段的表尾段，每页均会出现一次。

pageFooter

显示在所在页面的最下端，每页都显示，最后一页由lastPageFooter替代

lastPageFooter

最后一页页尾段内容，只在最后一页出现一次。

summary

表格的合计段，出现在整个报表的最后一页中的detail段的后面，一般用来统计报表中某一个或某几个字段的合计值。

使用iReport（4.0.2版本）开发report模板

1.打开iReport，选择需要产生报表的格式

2.选择报表存储位置

3.完成

4.进入到主界面后会看到整个报表分为几部分（即上面介绍的）

5.这时的数据源是空的，没有为报表指定任何数据源，我们这时要点击“小插头”按钮，添加数据源

6.这时会弹出一个对话框，可以看到这里提供了多种数据源，我们选择JDBC

7.这里填上数据库的连接信息

8.在数据源下拉列表中选择我们新加入的数据源

9.点击“向右拐剪头”这个按钮，来指定数据源中我们想获取的数据范围

10.在这个弹出的界面中可以看到可以根据SQL、JavaBean、CSV等方式来选取数据，我们选取SQL方式，输入正确的SQL语句后，可以看到表结构和部分数据，点击“OK”来保存

11.之后我们需要给报表的表头等位置加一些文字，这时拖动“Static Text”按钮到需要添加文字的文职

12.添加静态文字之后，我们需要把用SQL查出来的数据也添加到报表中，拖动“”按钮到Detail中，并修改$F{}中的变量名称，变量名称就是表的字段名称

13.之后我们点击“小榔头”按钮，编译这个报表，输出栏显示“Compilation running time ”时说明编译成功了，报表会被变成一个*.jasper的文件（之前的xml格式是jrxml）

14.此时，一个简单的报表模板就完成了，点击“Preview”来预览下这个报表

15.创建好的模板XML文件如下

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="test_report1" language="groovy" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">
	<property name="ireport.zoom" value="1.0"/>
	<property name="ireport.x" value="0"/>
	<property name="ireport.y" value="0"/>
	<parameter name="PAN" class="java.lang.String">
		<defaultValueExpression><![CDATA[]]></defaultValueExpression>
	</parameter>
	<queryString>
		<![CDATA[SELECT * FROM CARD WHERE PAN LIKE '%1%']]>
	</queryString>
	<field name="CARD_ID" class="java.math.BigDecimal"/>
	<field name="PAN" class="java.lang.String"/>
	<field name="PIN" class="java.lang.String"/>
	<field name="CARD_STATUS_ID" class="java.math.BigDecimal"/>
	<field name="CARD_TYPE_ID" class="java.math.BigDecimal"/>
	<field name="PREV_CARD_ID" class="java.math.BigDecimal"/>
	<field name="NEXT_CARD_ID" class="java.math.BigDecimal"/>
	<field name="CURR_CARD_ID" class="java.math.BigDecimal"/>
	<field name="ISSUE_DATE" class="java.sql.Timestamp"/>
	<field name="EXPIRATION_DATE" class="java.sql.Timestamp"/>
	<field name="FREEZE_DATE" class="java.sql.Timestamp"/>
	<field name="BAD_PIN_COUNT" class="java.math.BigDecimal"/>
	<field name="BAD_PIN_DATE" class="java.sql.Timestamp"/>
	<field name="BAD_PIN_RESET_COUNT" class="java.math.BigDecimal"/>
	<field name="BAD_PIN_RESET_DATE" class="java.sql.Timestamp"/>
	<field name="MANUAL_ENTRIES_COUNT" class="java.math.BigDecimal"/>
	<field name="MANUAL_ENTRIES_DATE" class="java.sql.Timestamp"/>
	<field name="MANUAL_ENTRIES_RESET_COUNT" class="java.math.BigDecimal"/>
	<field name="MANUAL_ENTRIES_RESET_DATE" class="java.sql.Timestamp"/>
	<background>
		<band splitType="Stretch"/>
	</background>
	<title>
		<band height="79" splitType="Stretch">
			<staticText>
				<reportElement x="165" y="22" width="236" height="29"/>
				<textElement/>
				<text><![CDATA[Test Report Title]]></text>
			</staticText>
		</band>
	</title>
	<pageHeader>
		<band height="35" splitType="Stretch">
			<staticText>
				<reportElement x="193" y="9" width="161" height="20"/>
				<textElement/>
				<text><![CDATA[Test Report Page Header]]></text>
			</staticText>
		</band>
	</pageHeader>
	<columnHeader>
		<band height="61" splitType="Stretch">
			<staticText>
				<reportElement x="193" y="23" width="161" height="20"/>
				<textElement/>
				<text><![CDATA[Test Report Column Header]]></text>
			</staticText>
		</band>
	</columnHeader>
	<detail>
		<band height="125" splitType="Stretch">
			<textField>
				<reportElement x="93" y="36" width="100" height="20"/>
				<textElement/>
				<textFieldExpression class="java.lang.String"><![CDATA[$F{......_ID}]]></textFieldExpression>
			</textField>
			<textField>
				<reportElement x="193" y="36" width="100" height="20"/>
				<textElement/>
				<textFieldExpression class="java.lang.String"><![CDATA[$F{......}]]></textFieldExpression>
			</textField>
			<textField>
				<reportElement x="293" y="36" width="100" height="20"/>
				<textElement/>
				<textFieldExpression class="java.lang.String"><![CDATA[$F{......_DATE}]]></textFieldExpression>
			</textField>
		</band>
	</detail>
	<columnFooter>
		<band height="45" splitType="Stretch">
			<staticText>
				<reportElement x="203" y="13" width="167" height="20"/>
				<textElement/>
				<text><![CDATA[Test Report Column Footer]]></text>
			</staticText>
		</band>
	</columnFooter>
	<pageFooter>
		<band height="54" splitType="Stretch">
			<staticText>
				<reportElement x="203" y="15" width="167" height="20"/>
				<textElement/>
				<text><![CDATA[Test Report Page Footer]]></text>
			</staticText>
		</band>
	</pageFooter>
	<summary>
		<band height="42" splitType="Stretch">
			<staticText>
				<reportElement x="203" y="12" width="167" height="20"/>
				<textElement/>
				<text><![CDATA[Test Report Summary]]></text>
			</staticText>
		</band>
	</summary>
</jasperReport>

java中调用报表模板，产生相应的报表文件

用JasperReports提供的API调用模板，创建PDF

package com.test.report;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.sql.Connection;
import java.sql.Driver;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.util.HashMap;
import java.util.Properties;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperRunManager;

public class JDBCGenerateReportTest {

	public static void main(String[] args) {
		
		try {
  		  DriverManager.registerDriver((Driver)Class.forName("oracle.jdbc.driver.OracleDriver").newInstance());
  	  	} catch (InstantiationException e) {
  		  e.printStackTrace();
  	  	} catch (IllegalAccessException e) {
  	  		e.printStackTrace();
  	  	} catch (ClassNotFoundException e) {
			e.printStackTrace();
		} catch (SQLException e) {
			e.printStackTrace();
		}

		Properties prop = new Properties();
  	  	prop.put("user", "your username");
  	  	prop.put("password", "your password");
  	  	Connection conn = null;
		try {
			conn = DriverManager.getConnection("jdbc:oracle:thin:@ip:1521:database", prop);
		} catch (SQLException e) {
			e.printStackTrace();
		}
		
		OutputStream fos = null;
		InputStream fis = null;
		try {
			fos = new FileOutputStream(new File("report.pdf"));
			fis = new FileInputStream(new File("test_report1.jasper"));//注意inputStream中要传入编译后的报表文件
			JasperRunManager.runReportToPdfStream(fis, fos, new HashMap<String,Object>(), conn);
		} catch (JRException e) {
			e.printStackTrace();
		} catch (FileNotFoundException e) {
			e.printStackTrace();
		} finally {
			try {
				fos.close();
			} catch (IOException e) {
				e.printStackTrace();
			}
			try {
				fis.close();
			} catch (IOException e) {
				e.printStackTrace();
			}
		}

	}

}