JasperReport報表設計

在JRXML模板（或JRXML文件）中的JasperReport 都是標準的 XML文件，以.JRXML擴展。所有JRXML文件包含標籤，作爲根元素。這反過來又包含許多子元素（所有這些都是可選的）。JasperReport框架，可以處理不同類型的數據源。在本教程中，我們將展示如何生成一個基本的報表，只是通過傳遞Java數據對象（使用Java Bean）集合傳給JasperReport引擎。最後報表應顯示的人的名單的名字和國家。

本章介紹如何設計一個JasperReport。下面的步驟將在本章中：

• 創建一個JRXML報表模板。

• 預覽XML報表模板。

創建一個JRXML報表模板

創建JRXML文件，該文件是jasper_report_template.jrxml使用文本編輯器，並保存此文件按照我們的環境設置，在 C: oolsjasperreports-5.0.1 est 。

<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"> <![CDATA[]]> <field name="country" class="java.lang.String"> <![CDATA[country]]> <field name="name" class="java.lang.String"> <![CDATA[name]]> <band height="23"> <reportElement mode="Opaque" x="0" y="3" width="535" height="15" backcolor="#70A9A9" /> <bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="3" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Country]]> <reportElement x="0" y="3" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Name]]> <band height="16"> <reportElement mode="Opaque" x="0" y="0" width="535" height="14" backcolor="#E5ECF9" /> <bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="0" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font size="9" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{country}]]> <reportElement x="0" y="0" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{name}]]>

下面是在上述報表模板主要字段的詳細信息：

• : 這是空的（因爲我們傳遞的數據通過Java Beans）。通常包含以檢索報表結果的SQL語句。

• : 此元素用於從數據源或查詢數據映射到報表模板。name是重複使用到報表主體（它們大小寫敏感）。

• : 此元素的映射字段名稱與XML文件中的相應元素。

• : 這個定義不依賴於任何數據源，變量，參數或報表表達式靜態文本。

• : 這定義結果字段的外觀。

• $F{country}: 這是一個包含結果的預定義字段的標籤的變量的值。

• :  包含顯示在報表中的數據。

一旦報表設計已準備就緒，將其保存在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文件：

<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" />

接下來，讓我們打開命令提示符並轉到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。