JasperReports - 章节( Sections)

我们在“ 入门 ”一章中讨论了简单报告模板的结构。在类似的行上，JasperReports将报告模板组织成多个部分。截面是报表中具有指定高度的部分，可以包含线条，矩形，图像或文本字段等报表对象。

报告引擎在报告填充时间内迭代所提供的报告数据源的虚拟记录。根据每个部分定义的行为，引擎然后在适当时呈现每个报告部分。例如，为数据源中的每个记录呈现详细信息部分。发生分页时，页眉和页脚部分将根据需要呈现。

在JasperReports中，术语和报告部分也称为report bands 。截面由一个或多个带组成。这些部分在报告生成时重复填写并准备最终文档。

主要部分

JasperReports中的报告模板包含以下主要部分 -

<title></title>
<pageheader></pageheader>
<columnheader></columnheader>
<groupheader></groupheader>
<detail></detail>
<groupfooter></groupfooter>
<columnfooter></columnfooter>
<pagefooter></pagefooter>
<lastpagefooter></lastpagefooter>
<summary></summary>
<nodata></nodata>
<background></background>

下表总结了每个部分 -

S.NO	部分和描述
1	Title 此部分仅在报告开头出现一次。
2	Page Header 此部分显示在生成的文档中每页的开头。
3	Column Header 此部分显示在生成的文档中每列的开头。如果报告只定义了一列，则忽略列标题和页脚部分。
4	Group Header 本节由报告组（章节Groups ）介绍。每次分组表达式更改其值时，组标题部分将打印在详细信息部分上方。如果定义了多个组，则按组定义的顺序打印组标题。
5	Detail 对报告的数据源提供的每行数据重复此部分。细节部分可以由多个带组成。
6	Group Footer 本节由报告组（章节Groups ）介绍。在分组表达式的值更改之前，组页脚部分将打印在详细信息部分下方。始终为数据源中的最后一行数据打印组页脚。如果定义了多个组，则按组定义的相反顺序打印组页脚。
7	Column Footer 此部分显示在每列的底部。如果报告的列数为1，则忽略列标题和页脚部分。
8	Page Footer 此部分显示在每页的底部。
9	Last Page Footer 此部分替换报告最后一页上的常规页脚。如果还有摘要部分，那么这可能不是文档的最后一页。当必须在最后一页的底部显示摘要信息时，此部分有时很有用。
10	Summary 此部分仅在报告末尾出现一次。
11	No Data When No Data Print report属性设置为“ No Data部分”时，将打印此部分。如果在报告模板中定义了“noData”部分，并且数据源为空，则“noData”部分将是在填充时考虑的唯一部分，其内容将生成报告输出。
12	Background 背景部分显示在每个页面上，不能溢出到下一页。放置在此部分上的元素将在页面初始化时进行评估，并显示在后台。所有其他页面对象都显示在背景对象的顶部。此部分对于创建页面水印非常有用。

部分，元素和属性关系

下图显示了报表部分中的元素和属性关系。

部分元素

所有上述报告部分都是可选的。但任何报告模板都至少有一个这样的部分。这些部分中的每一部分都包含一个< band “元素作为其唯一的子元素。 “ band ”可包含零个或多个以下子元素 -

《line》, 《rectangle》, 《ellipse》, 《image》, 《staticText》, 《textField》, 《subReport》, or 《elementGroup》

这些元素中的每一个都必须包含一个< reportElement “作为其第一个元素（elementGroup除外）。 “ reportElement ”确定如何为该特定元素布置数据。与变量和参数不同，报表元素不需要具有名称，因为通常您不需要在报表模板中获取任何单个元素。

下表总结了< reportElement “的属性 -

属性	描述	有效值
x	指定band元素的x坐标。	一个整数值，表示元素的x坐标，以像素为单位。此属性是必需的。
y	指定band元素的y坐标。	一个整数值，表示元素的y坐标，以像素为单位。此属性是必需的。
width	指定band元素的宽度。	一个整数值，表示以像素为单位的元素宽度。此属性是必需的。
height	指定band元素的高度。	一个整数值，表示元素高度，以像素为单位。此属性是必需的。
key	band元素的唯一标识符。	A unique string value.
stretchType	指定当包含的条带伸展时元素如何伸展	NoStretch (default) - 元素不会拉伸。 RelativeToTallestObject - 元素将拉伸以容纳其组中的最高对象。 RelativeToBand - 元素将拉伸以适应乐队的高度。
positionType	指定乐队拉伸时元素的位置。	Float - 元素将根据周围元素的大小移动。 FixRelativeToTop (default) - 元素将保持相对于乐队顶部的固定位置。 FixRelativeToBottom - 元素将保持相对于乐队底部的固定位置。
isPrintRepeatedValues	指定是否打印重复值。	true (default) - 将打印重复值。 false - 不会打印重复值。
mode	指定元素的背景模式	Opaque, Transparent
isRemoveLineWhenBlank	指定当元素为空并且同一水平空间中没有其他元素时是否应删除该元素。	true, false
isPrintInFirstWholeBand	指定元素是否必须在整个波段中打印，即，不在报表页面或列之间划分的波段。	true, false
isPrintWhenDetailOverFlows	指定当波段溢出到新页面或列时是否打印元素。	true, false
printWhenGroupChanges	指定在指定的组更改时将打印元素。	字符串值。
forecolor	指定元素的前景色。	可以是＃字符前面的十六进制RGB值，也可以是以下预定义值之一: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white.
backcolor	指定元素的背景颜色。	与forecolor有效值相同

部分属性

以下是报告部分的属性 -

Height

该部分的高度指定该特定部分的高度（以像素为单位），在整个报表设计中非常重要。

表达时打印

一个布尔表达式，用于确定是否应打印该部分。

拆分允许

一个标志，指示当该部分不适合当前页面时是否允许该部分分割。如果为true，则该部分将转移到下一页。请注意，如果该部分不适合下一页，则无论标志的值如何，该部分都将被拆分。 splitType可以采用以下值 -

splitType="Stretch:"拆分拉伸内容。如果该部分在当前页面上拉伸（如果可用空间小于声明的高度），则允许将添加到原始高度的区域拆分到下一页面。
splitType="Prevent:"首次尝试时防止拆分。如果该部分不适合下一页，则拆分正常进行，因为波段拆分防止仅在第一次拆分尝试时有效。
splitType="Immediate:"立即拆分。除了最上面的元素之外，乐队可以拆分。

例子 (Example)

为了演示每个部分，让我们编写报告模板（jasper_report_template.jrxml）。将此文件保存到C:\tools\jasperreports-5.0.1\test目录。在这个文件中，我们将在每个部分中显示一个文本（我们在上面讨论过）。该文件的内容如下 -

<?xml version = "1.0" encoding = "UTF-8"?>
<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" pageWidth = "300" pageHeight = "300" 
   columnWidth = "300" leftMargin = "0" rightMargin = "0" 
   topMargin = "0" bottomMargin = "0" >
   <title>
      <band height = "50">
         <textField>
            <reportElement x = "100" y = "16" width = "100" height = "20"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Title"]]>
            </textFieldExpression>
         </textField>
      </band>
   </title>
   <pageHeader>
      <band height = "40">
         <textField>
            <reportElement  mode = "Opaque" x = "100" y = "10" 
               width = "90" height = "20"/>
            <textElement>
               <font isBold = "true"/>
            </textElement>
            <textFieldExpression>
               <![CDATA["Page Header"]]>
            </textFieldExpression>
         </textField>
      </band>
   </pageHeader>
   <columnHeader>
      <band height = "40">
         <textField>
            <reportElement  x = "100" y = "10" width = "90" height = "20"/>
            <textElement>
               <font isItalic = "true"/>
            </textElement>
            <textFieldExpression>
               <![CDATA["Column Header"]]>
            </textFieldExpression>
         </textField>
      </band>
   </columnHeader>
   <detail>
      <band height ="40">
         <textField>
            <reportElement mode = "Opaque" x = "100" y = "10" 
               width = "90" height = "20" backcolor = "#99CCFF"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Report Details"]]>
            </textFieldExpression>
         </textField>
      </band>
   </detail>
   <columnFooter>
      <band height = "40">
         <textField>
            <reportElement  x = "100" y = "10" width = "90" height = "20"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Column Footer"]]>
            </textFieldExpression>
         </textField>
      </band>
   </columnFooter>
   <pageFooter>
      <band height = "40">
         <textField>
            <reportElement  x = "100" y = "10" width = "90" height = "20"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Page Footer"]]>
            </textFieldExpression>
         </textField>
      </band>
   </pageFooter>
   <lastPageFooter>
      <band height = "40">
         <textField>
            <reportElement  x = "100" y = "10" width = "90" height = "20"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Last Page Footer"]]>
            </textFieldExpression>
         </textField>
      </band>
   </lastPageFooter>
   <summary>
      <band height = "40">
         <textField>
            <reportElement  x = "100" y = "10" width = "90" height = "20"/>
            <textElement/>
            <textFieldExpression>
               <![CDATA["Summary"]]>
            </textFieldExpression>
         </textField>
      </band>
   </summary>
</jasperReport>

下面给出了填写和生成报告的java代码。让我们将此文件JasperReportFill.java保存到C:\tools\jasperreports-5.0.1\test\src\com\iowiki目录。

package com.iowiki;
import net.sf.jasperreports.engine.JREmptyDataSource;
import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperFillManager;
public class JasperReportFill {
   public static void main(String[] args) {
      String sourceFileName = "C://tools/jasperreports-5.0.1/test/" + 
         "jasper_report_template.jasper";
      try {
         JasperFillManager.fillReportToFile(sourceFileName, null,
            new JREmptyDataSource());
      } catch (JRException e) {
         // TODO Auto-generated catch block
         e.printStackTrace();
      }
   }
}

在这里，我们在填充报表时使用JREmptyDataSource的实例来模拟其中包含一条记录的数据源，但此单条记录中的所有字段都为空。

报表生成 (Report Generation)

我们将使用常规的ANT构建过程编译并执行上述文件。文件build.xml的内容（保存在目录C:\tools\jasperreports-5.0.1\test下）如下所示。

导入文件 - baseBuild.xml是从环境设置一章中选取的，应该与build.xml放在同一目录中。

<?xml version = "1.0" encoding = "UTF-8"?>
<project name = "JasperReportTest" default = "viewFillReport" basedir = ".">
   <import file = "baseBuild.xml" />
   <target name = "viewFillReport" depends = "compile,compilereportdesing,run"
      description = "Launches the report viewer to preview 
      the report stored in the .JRprint file.">
      <java classname = "net.sf.jasperreports.view.JasperViewer" fork = "true">
         <arg value = "-F${file.name}.JRprint" />
         <classpath refid = "classpath" />
      </java>
   </target>
   <target name = "compilereportdesing" description = "Compiles the JXML file and
      produces the .jasper file.">
      <taskdef name = "jrc"
         classname = "net.sf.jasperreports.ant.JRAntCompileTask">
         <classpath refid = "classpath" />
      </taskdef>
      <jrc destdir = ".">
         <src>
            <fileset dir = ".">
               <include name = "*.jrxml" />
            </fileset>
         </src>
         <classpath refid = "classpath" />
      </jrc>
   </target>
</project>

接下来，让我们打开命令行窗口并转到build.xml所在的目录。最后，执行命令ant -Dmain-class=com.iowiki.JasperReportFill （viewFullReport是默认目标），如下所示 -

C:\tools\jasperreports-5.0.1\test>ant -Dmain-class=com.iowiki.JasperReportFill
Buildfile: C:\tools\jasperreports-5.0.1\test\build.xml
clean-sample:
   [delete] Deleting directory C:\tools\jasperreports-5.0.1\test\classes
   [delete] Deleting: C:\tools\jasperreports-5.0.1\test\jasper_report_template.jasper
   [delete] Deleting: C:\tools\jasperreports-5.0.1\test\jasper_report_template.jrprint
compile:
   [mkdir] Created dir: C:\tools\jasperreports-5.0.1\test\classes
   [javac] C:\tools\jasperreports-5.0.1\test\baseBuild.xml:28:
   warning: 'includeantruntime' was not set, defau
   [javac] Compiling 1 source file to C:\tools\jasperreports-5.0.1\test\classes
compilereportdesing:
   [jrc] Compiling 1 report design files.
   [jrc] log4j:WARN No appenders could be found for logger
   (net.sf.jasperreports.engine.xml.JRXmlDigesterFac
   [jrc] log4j:WARN Please initialize the log4j system properly.
   [jrc] log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
   [jrc] File : C:\tools\jasperreports-5.0.1\test\jasper_report_template.jrxml ... OK.
run:
   [echo] Runnin class : com.iowiki.JasperReportFill
   [java] log4j:WARN No appenders could be found for logger
   (net.sf.jasperreports.extensions.ExtensionsEnviro
   [java] log4j:WARN Please initialize the log4j system properly.
viewFillReport:
   [java] log4j:WARN No appenders could be found for logger
   (net.sf.jasperreports.extensions.ExtensionsEnviro
   [java] log4j:WARN Please initialize the log4j system properly.
BUILD SUCCESSFUL
Total time: 18 minutes 22 seconds

作为上述编译的结果，JasperViewer窗口打开，如下面的屏幕 -

在这里，我们可以在每个部分中看到打印文本。需要注意的是，由于JRXML包含元素，它将显示在报告的最后一页而不是显示的元素中。只有具有多个列的和元素才会显示在报表上。

<上一篇.JasperReports - 变量

JasperReports - 小组( Groups).下一篇>

JasperReports - 教程

JasperReports - 入门( Getting Started)

JasperReports - 环境设置( Environment Setup)

JasperReports - 生命周期( Life Cycle)

JasperReports - 设计( Designs)

JasperReports - 编译设计( Compiling Design)

JasperReports - 填充物( Fillings)

JasperReports - 查看和打印( View & Print)

JasperReports - 出口( Exporting)

JasperReports - 参数( Parameters)

JasperReports - 数据源( Data Sources)

JasperReports - Fields( Fields)

JasperReports - 表达( Expression)

JasperReports - 变量