jasper--helloworld

主要内容参考http://blog.csdn.net/leafxx/archive/2006/03/16/626700.aspx

 

 

JasperReports的报表是用XML文件来定义的，约定用jrxml作后缀名。一个典型的jrxml文件包含以下元素：

    * <jsperReport> - 根元素

    * <title> - 报表的标题，一篇报表里只在开头打印一次

    * <pageHeader> - 页眉，报表每页开头打印一次

    * <detail> - 报表正文

    * <pageFooter> - 页脚，报表每页末尾打印一次

    * <band> - 定义报表部件，以上所有元素都包含一个band元素作为他们唯一的子元素

除了root元素，所有的元素都是可选的。这里是一个jrxml文件的例子，它将生成一个显示字符串“你好，世界！”的简单报表。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jasperReport
  PUBLIC "-//JasperReports//DTD Report Design//EN"
  "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

<jasperReport name="structure">
  <detail>
    <band height="20">
      <staticText>
        <reportElement x="180" y="0" width="200" height="20"/>
        <textElement>
			<font fontName="宋体" size="12" pdfFontName="STSong-Light" pdfEncoding="UniGB-UCS2-H" isPdfEmbedded="true"/>
		</textElement>
        <text><![CDATA[你好，世界！]]></text>
      </staticText>
    </band>
  </detail>
</jasperReport>

在这个简单的例子中，我没有写可选项<title>, <pageHeader>还有<pageFooter>。<staticText>元素，顾名思义，在报表上显示静态的文本，就像你所看到的，它包含了一个单独的<text>元素定义将要显示的文本。

jrxml文件需要“编译”成JasperReports规范的二进制格式，可以调用类net.sf.jasperreports.engine.JasperCompileManager的方法compileReport()来实现。这个方法有几种重载的形式，在我们的例子中，我们将用到的是单个字符串为参数的方法。参考JasperReport文档以获得这个方法其他版本的详细信息。

package tutorial;

import java.util.HashMap;

import net.sf.jasperreports.engine.JREmptyDataSource;
import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperCompileManager;
import net.sf.jasperreports.engine.JasperExportManager;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.JasperPrint;
import net.sf.jasperreports.engine.JasperReport;

public class Structure {

	@SuppressWarnings("unchecked")
	public static void main(String[] args) {

		JasperReport jasperReport;
		JasperPrint jasperPrint;
		try {
			//编译报表设计
			jasperReport = JasperCompileManager
					.compileReport("reports/structure.jrxml");
			//在模板中填充数据
			jasperPrint = JasperFillManager.fillReport(jasperReport,
					new HashMap(), new JREmptyDataSource());
			//输出pdf文件
			JasperExportManager.exportReportToPdfFile(jasperPrint,
					"reports/structure.pdf");

		} catch (JRException e) {
			e.printStackTrace();
		}

	}

}

 

一个jrxml文件只需要编译一次，但在这个简单例子中，每次执行程序都会被编译。在报表生成之前，需要用数据来“填充”它，在这里我们调用net.sf.jasperreports.engine.JasperFillManager类里的fillReport()方法。同样的，它也有许多重载的形式，这里我们用到了其中一个具有三个参数的方法，第一个是JasperReport的实例, 第二个是HashMap，它可以包含任何要传递给report的参数，第三个参数对象要实现JRDataSource接口。这个方法的使用在我们的例子里面是：
jasperPrint = JasperFillManager.fillReport(
          jasperReport, new HashMap(), new JREmptyDataSource());
因为我们的例子里的report类不需要任何参数，所以传给一个它一个空的HashMap，第三个参数net.sf.jasperreports.engine.JREmptyDataSource是一个实现了JRDataSource接口的简便类，这个基本类不包含任何数据。
The parameters are self-explanatory.
最后，在例子中，我们将报表导出为PDF文件，可以用Adobe Acrobat, XPDF, Evince或其他PDF阅读工具打开。在例子中的代码是：JasperExportManager.exportReportToPdfFile(
          jasperPrint, "reports/structure.pdf");