JasperReport报表设计 - JasperReports教程

在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。