JasperReport报表设计

在JRXML模板（或JRXML文件）中的JasperReport 都是标准的 XML文件，以.JRXML扩展。所有JRXML文件包含标签<jasperReport>，作为根元素。这反过来又包含许多子元素（所有这些都是可选的）。JasperReport框架，可以处理不同类型的数据源。在本在线教程中，我们将展示如何生成一个基本的报表，只是通过传递Java数据对象（使用Java Bean）集合传给JasperReport引擎。最后报表应显示的人的名单的名字和国家。

本章介绍如何设计一个JasperReport。下面的步骤将在本章中：

创建一个JRXML报表模板。
预览XML报表模板。

创建一个JRXML报表模板

创建JRXML文件，该文件是jasper_report_template.jrxml使用文本编辑器，并保存此文件按照我们的环境设置，在 C: oolsjasperreports-5.0.1 est 。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<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="jasper_report_template" language="groovy" pageWidth="595"
pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20"
topMargin="20" bottomMargin="20">
    <queryString>
	<![CDATA[]]>
    </queryString>
    <field name="country" class="java.lang.String">
        <fieldDescription><![CDATA[country]]></fieldDescription>
    </field>
    <field name="name" class="java.lang.String">
        <fieldDescription><![CDATA[name]]></fieldDescription>
    </field>
    <columnHeader>
     <band height="23">
	<staticText>
	    <reportElement mode="Opaque" x="0" y="3" width="535"
		 height="15" backcolor="#70A9A9" />
	    <box>
	        <bottomPen lineWidth="1.0" lineColor="#CCCCCC" />
	    </box>
	    <textElement />
	    <text><![CDATA[]]> </text>
	</staticText>
	<staticText>
	    <reportElement x="414" y="3" width="121" height="15" />
	    <textElement textAlignment="Center"
	        verticalAlignment="Middle">
		<font isBold="true" />
	    </textElement>
	    <text><![CDATA[Country]]></text>
	</staticText>
	<staticText>
	    <reportElement x="0" y="3" width="136" height="15" />
	    <textElement textAlignment="Center"
	        verticalAlignment="Middle">
		<font isBold="true" />
	    </textElement>
	    <text><![CDATA[Name]]></text>
	</staticText>
     </band>
    </columnHeader>
    <detail>
        <band height="16">
	 <staticText>
	     <reportElement mode="Opaque" x="0" y="0" width="535"
		 height="14" backcolor="#E5ECF9" />
	     <box>
	            <bottomPen lineWidth="0.25" lineColor="#CCCCCC" />
	     </box>
	     <textElement />
	     <text><![CDATA[]]> </text>
	 </staticText>
	 <textField>
	     <reportElement x="414" y="0" width="121" height="15" />
	     <textElement textAlignment="Center"
	         verticalAlignment="Middle">
		 <font size="9" />
	     </textElement>
	     <textFieldExpression class="java.lang.String">
	         <![CDATA[$F{country}]]>
		</textFieldExpression>
	 </textField>
	 <textField>
	     <reportElement x="0" y="0" width="136" height="15" />
	     <textElement textAlignment="Center"
	         verticalAlignment="Middle" />
	         <textFieldExpression class="java.lang.String">
			<![CDATA[$F{name}]]>
	         </textFieldExpression>
	 </textField>
        </band>
    </detail>
</jasperReport>

下面是在上述报表模板主要字段的详细信息：

<queryString>: 这是空的（因为我们传递的数据通过Java Beans）。通常包含以检索报表结果的SQL语句。
<field name>: 此元素用于从数据源或查询数据映射到报表模板。name是重复使用到报表主体（它们大小写敏感）。
<fieldDescription>: 此元素的映射字段名称与XML文件中的相应元素。
<staticText>: 这个定义不依赖于任何数据源，变量，参数或报表表达式静态文本。
<textFieldExpression>: 这定义结果字段的外观。
$F{country}: 这是一个包含结果的预定义字段的标签<field name>的变量的值。
<band>: 包含显示在报表中的数据。

一旦报表设计已准备就绪，将其保存在C: 目录。

预览XML报表模板

有提供的实用工具net.sf.jasperreports.view.JasperDesignViewer在JasperReports的JAR文件，这有助于预览报表设计，而无需编译或填充它。此实用程序是一个独立的Java应用程序，因此可以使用ANT执行。

让我们来写一个Ant目标viewDesignXML查看JRXML。因此，让我们在C: oolsjasperreports-5.0.1 est目录创建和保存build.xml（应放置在JRXML在同一个目录下）。这里是build.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<project name="JasperReportTest" default="viewDesignXML" basedir=".">

    <import file="baseBuild.xml" />
    <target name="viewDesignXML" description="Design viewer is launched
	to preview the JXML report design.">
     <java classname= "net.sf.jasperreports.view.JasperDesignViewer"
	    fork="true">
	    <arg value="-XML" />
	    <arg value="-F${file.name}.jrxml" />
	    <classpath refid="classpath" />
     </java>
    </target>

</project>

接下来，让我们打开命令提示符并转到build.xml文件放置的目录。执行命令ant（由于viewDesignXML是默认的目标）。输出如下：

C:	oolsjasperreports-5.0.1	est>ant
Buildfile: C:	oolsjasperreports-5.0.1	estuild.xml

viewDesignXML:
[java] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).
[java] log4j:WARN Please initialize the log4j system properly.

Log4j的警告可以忽略，如上面执行的结果，一个标有“JasperDesignViewer”窗口打开，显示我们的报表模板的预览。

正如我们看到获得的数据只报表表达式显示，作为JasperDesignViewer没有获得实际的数据源或报表参数。通过关闭窗口或按下Ctrl-C在命令行窗口终止JasperDesignViewer。