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。