JasperReports教學 » JasperReport報表設計

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”視窗開啟，顯示我們的報表模板的預覽。

Jasper Design Viewer

正如我們看到獲得的資料只報表表示式顯示，作為JasperDesignViewer沒有獲得實際的資料源或報表引數。通過關閉視窗或按下Ctrl-C在命令列視窗終止JasperDesignViewer。