JasperReports报表变量13

报表变量是建立在报表表达式之上的特殊对象。报表变量简化以下任务：

  • 报表，其中大量使用在整个报告模板表达式。这些表达式可以通过使用报表变量只能声明一次。
  • 计数，求和，平均，最低，最高，方差等：报表变量可以基于像对应的表达式的值执行各种计算

如果变量是在报表设计定义，那么这些可以通过在表达式中的新变量引用。因此，在该变量是在报表设计中声明的顺序是非常重要的。

变量声明

变量声明如下：

<variable name="CityNumber" class="java.lang.Integer" incrementType="Group"
   incrementGroup="CityGroup" calculation="Count">
   <variableExpression>
       <![CDATA[Boolean.TRUE]]>
   </variableExpression>
</variable>

如上面所看到的，<variable>元素包含属性的数量。这些属性总结如下：

name属性

类似的参数和字段，</variable>元素的name属性是强制性的。它允许引用由它的声明的名称在报表表达式中的变量。

class属性

class属性也是强制性的，它指定了变量值的类名。它的默认值是java.lang.String。这是可以改变的，在classpath可用的任何类无论是在报表编译时间和报告充填时间。无论报告值的类型，引擎采用该$V {}标记是用来报告表达，从而不必要手动投射。

计算方法

这个属性决定的变量填充报表时要执行什么计算。下面的小节描述所有的<variable>元素的计算属性的可能值。

  • Average: 变量的值是变量表达式的每一个非空值的平均值。有效期仅为数值变量。
  • Count: 该变量的值是变量表达式非空实例的数量。
  • First: 变量的值是变量表达式的第一个实例的值。随后的值将被忽略。
  • Highest: 变量的值是变量表达式的最高值。
  • Lowest: 该变量的值是变量表达式在报表中的最低值。
  • Nothing: 不进行计算的变量。
  • StandardDeviation: 该变量的值是所有非空值匹配报表表达式的标准偏差。有效期仅为数值变量。
  • Sum: 该变量的值是由报表表达式返回所有非空值的总和。
  • System: 该变量的值是一个自定义计算（计算该变量自己的值，使用JasperReports小脚本功能）
  • Variance: 该变量的值是一个报表变量的表达式求值返回的所有非空值的方差。

增量FACTORYCLASS

此属性确定填充报表上的当前记录时，用于计算变量的值的类。默认值是任何类实现net.sf.jasperreports.engine.fill.JRIncrementerFactory。工厂类将被用于由发动机来实例化对象的增量在运行时根据该变量中设置的计算属性。

INCREMENTTYPE

这个决定何时重新计算变量的值。此属性使用的值，如下：

  • Column: 该变量的值重新计算各列的结尾
  • Group: 当指定incrementGroup改变该组的变量值重新计算。
  • None: 该变量的值重新计算每个记录。
  • Page: 该变量的值被重新计算在每一页的末尾。
  • Report: 该变量的值被重新计算一次，在报表的末尾。

INCREMENTGROUP

这决定了该变量的值被重新计算，当incrementType是组的名称。这需要在JRXML报表模板中声明的任何组的名称。

RESETTYPE

这决定了当一个变量的值被复位。此属性使用的值，如下：

  • Column: 该变量的值复位在每一列的开头。
  • Group: 该变量的值是当指定incrementGroup修改组复位。
  • None: 该变量的值不会被重置。
  • Page: 该变量的值复位在每一页的开头。
  • Report: 该变量的值复位只有一次，在报表的开头。

RESETGROUP

这决定了该变量的值复位，当resetType是组的名称。该属性的值是在JRXML报表模板中声明的任何组的名称。

内置报表变量

有一些内置的系统变量，准备在表达式中使用，如下所示：

Variable Name 描述
PAGE_NUMBER 这个变量的值是它的当前页码。它可以被用来同时显示当前页面的数量和使用JasperReports文本字段的元素，evaluationTime属性的一种特殊的功能的总页数。
COLUMN_NUMBER 这个变量包含了当前的列号
REPORT_COUNT 此报表变量包含的处理记录的总数。
PAGE_COUNT 这个变量包含了生成当前页面时所处理的记录数。
COLUMN_COUNT 这个变量包含了生成当前列时所处理的记录数。
GroupName_COUNT 这个变量的名称是从它所对应的组，后缀为_COUNT序列的名称派生的。这个变量包含的记录在当前组的数量。

例子

让一个变量（countNumber）加入到现有的报表模板（第报表设计）。我们将前缀数到每个记录。修订后的报告模板（jasper_report_template.jrxml）如下。将其保存到C:\tools\jasperreports-5.0.1\test 目录:

<?xml version="1.0"?>
<!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" pageWidth="595"
pageHeight="842" columnWidth="515"
leftMargin="40" rightMargin="40" topMargin="50" bottomMargin="50">
<parameter name="ReportTitle" class="java.lang.String"/>
<parameter name="Author" class="java.lang.String"/>

   <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>
   <variable name="countNumber" class="java.lang.Integer" calculation="Count">
      <variableExpression>
         <![CDATA[Boolean.TRUE]]>
      </variableExpression>
   </variable>
   <title>
      <band height="70">
         <line>
            <reportElement x="0" y="0" width="515"
            height="1"/>
         </line>
         <textField isBlankWhenNull="true" bookmarkLevel="1">
            <reportElement x="0" y="10" width="515"
            height="30"/>
            <textElement textAlignment="Center">
               <font size="22"/>
            </textElement>
            <textFieldExpression class="java.lang.String">
               <![CDATA[$P{ReportTitle}]]>
            </textFieldExpression>
            <anchorNameExpression>
               <![CDATA["Title"]]>
            </anchorNameExpression>
         </textField>
         <textField isBlankWhenNull="true">
            <reportElement  x="0" y="40" width="515" height="20"/>
            <textElement textAlignment="Center">
                 <font size="10"/>
            </textElement>
            <textFieldExpression class="java.lang.String">
               <![CDATA[$P{Author}]]>
            </textFieldExpression>
         </textField>
      </band>
   </title>

   <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["  " + String.valueOf($V{countNumber}) +"."+$F{name}]]>
            </textFieldExpression>
         </textField>
      </band>
   </detail>
</jasperReport>

在java代码报表充填保持不变。文件C:\tools\jasperreports-5.0.1\test\src\com\yiibai\JasperReportFill.java内容如下：

package com.yiibai;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;

public class JasperReportFill {
   @SuppressWarnings("unchecked")
   public static void main(String[] args) {
      String sourceFileName =
      "C://tools/jasperreports-5.0.1/test/jasper_report_template.jasper";

      DataBeanList DataBeanList = new DataBeanList();
      ArrayList<DataBean> dataList = DataBeanList.getDataBeanList();

      JRBeanCollectionDataSource beanColDataSource =
      new JRBeanCollectionDataSource(dataList);

      Map parameters = new HashMap();
      /**
       * Passing ReportTitle and Author as parameters
       */
      parameters.put("ReportTitle", "List of Contacts");
      parameters.put("Author", "Prepared By Manisha");

      try {
         JasperFillManager.fillReportToFile(
         sourceFileName, parameters, beanColDataSource);
      } catch (JRException e) {
         e.printStackTrace();
      }
   }
}

POJO文件的内容 C:\tools\jasperreports-5.0.1\test\src\com\yiibai\DataBean.java的内容如下：

package com.yiibai;

public class DataBean {
   private String name;
   private String country;

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }

   public String getCountry() {
      return country;
   }

   public void setCountry(String country) {
      this.country = country;
   }
}

该文件 C:\tools\jasperreports-5.0.1\test\src\com\yiibai\DataBeanList.java 的内容如下：

package com.yiibai;

import java.util.ArrayList;

public class DataBeanList {
   public ArrayList<DataBean> getDataBeanList() {
      ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>();

      dataBeanList.add(produce("Manisha", "India"));
      dataBeanList.add(produce("Dennis Ritchie", "USA"));
      dataBeanList.add(produce("V.Anand", "India"));
      dataBeanList.add(produce("Shrinath", "California"));

      return dataBeanList;
   }

   /**
    * This method returns a DataBean object,
    * with name and country set in it.
    */
   private DataBean produce(String name, String country) {
      DataBean dataBean = new DataBean();
      dataBean.setName(name);
      dataBean.setCountry(country);
      return dataBean;
   }
}

报表生成

我们将编译和执行使用我们常规Ant构建过程上面的文件。 build.xml文件中的内容（根据目录保存在C:\tools\jasperreports-5.0.1\test）如下。

<?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.yiibai.JasperReportFill （viewFullReport默认的目标），如下所示：

C:\tools\jasperreports-5.0.1\test>ant -Dmain-class=com.yiibai.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, defaulting to build.sysclasspath=last;
    set to false for repeatable builds
    [javac] Compiling 7 source files 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.JRXmlDigesterFactory).
      [jrc] log4j:WARN Please initialize the log4j system properly.
      [jrc] log4j:WARN See http://logging.apache.org/log4j/1.2/faq.htmll#noconfig
      for more info.
      [jrc] File : C:\tools\jasperreports-5.0.1\test\jasper_report_template.jrxml ... OK.

run:
     [echo] Runnin class : com.yiibai.JasperReportFill
     [java] log4j:WARN No appenders could be found for logger
     (net.sf.jasperreports.extensions.ExtensionsEnvironment).
     [java] log4j:WARN Please initialize the log4j system properly.

viewFillReport:
     [java] log4j:WARN No appenders could be found for logger
     (net.sf.jasperreports.extensions.ExtensionsEnvironment).
     [java] log4j:WARN Please initialize the log4j system properly.

BUILD SUCCESSFUL
Total time: 18 seconds

正如上文编译的结果，一个JasperViewer窗口打开如下面的屏幕：

在这里，我们看到，计数前缀为每个记录。

时间： 2024-07-31 06:25:14

JasperReports报表变量13的相关文章

JasperReports报表表达式12

报表表达式是JasperReports使我们能够显示在报表上的数据计算的强大功能.计算出数据不是一个静态数据,并且不受特别的报表参数或数据源字段传递的数据.报表表达式是由组合报表参数,字段和静态数据.默认情况下,Java语言是用于编写报表的表达式.其他脚本语言如Groovy脚本语言,JavaScript或BeanShell脚本,报表表达式是由JasperReports编译器支持. 本章将解释如何报表表达式工作假设他们一直只用Java语言编写的.在JRXML报表模板,那里有定义表达式几个元素,如下

JasperReports报表区段14

我们将在本章开始,一个简单的报表模板的结构看.依样画葫芦JasperReports的结构报表模板归类到多个区段.部分是有规定的高度,并且可以包含像直线,矩形,图像或文本字段对象报表的部分. 通过提供的报表数据源的虚拟记录的报表引擎遍历,在报表填充的时候.根据每个部分的定义的行为,引擎则呈现每个报表节在适当的时候.举例来说,细节部分的数据源中呈现为每个记录.当页中断,页眉和页面页脚节在需要时提供. 在JasperReports术语,报表区段也被称为报表带区.部分是由一个或多个频段.这些部分在报告生

JasperReports报表组15

组在JasperReports的协助组织对报告的数据以逻辑方式.报告组代表连续记录的数据源中有一些共同点,比如某个报表字段的值的序列.报告组由<group>元素定义.一个报表可以有任意数量的组.一旦声明,群体可以在整个报告中提到的. 报告组有三个要素: Group expression: 这表示必须改变,以启动一个新的数据组中的数据. Group header section: 帮助位置标签在分组数据的开始. Group footer section: : 帮助位置标签在分组数据的末尾. 在截

javaweb+jasperreports报表+struts2

本文将详细介绍javaweb中采用struts2框架的jasperreports报表开发方法,数据源选取的是connection.模板选取的是编译后的模板(jasper格式文件). 网上很多教程采用了jasperreports-3.x.x的api ,本文采用jarjasperreports-5.6.0.jar的api,两个版本的区别还是很大的,3.x.x版本的很多方法已经过时废弃了. 建议统一采用jarjasperreports-5.6.0.jar版本,因为生成报表的这些工具目前都有,jar包也

JasperReports报表字段11

报表字段是代表数据源和报表模板之间的数据映射元素.字段可以在报告中的表达式进行组合,以获得所需的输出.报表模板可以包含零个或更多的<field>元素.当声明报表字段,数据源应提供相应的数据到所有在报告模板中定义的字段. 字段声明 字段声明做如下: <field name="FieldName" class="java.lang.String"/> name属性 <field>元素的name属性是强制性的.它通过名称引用的报表表达的

JasperReports报表数据源10

数据源的结构数据容器.同时生成报告,Jasper报表引擎获得来自数据源的数据.数据可以从数据库,XML文件,对象数组和集合中的对象来获得.我们将在本章填充报告所看到的fillReportXXX()方法,预计将收到该报告的数据源其以填充,在net.sf.jasperreports.engine.JRDataSource对象或一个java.sql.Connection中的形式(当报表数据在关系数据库中找到). JRDataSource接口只有两个方法,这应该被实现: public boolean n

生成报表（转）

使用JasperReport+iReport进行WEB开发           一.JasperReport和iReport简介:  1.JasperReport简介 JasperReport是一个强大.灵活的报表生成工具,是开放源代码组织sf.net中的一个java 报表打印工程.能够展示丰富的页面内容,并将之转换成PDF,HTML,XML,Excel(通过POI或JExcelAPI实现)和Rtf(通过POI实现)格式.该库完全由Java写成,可以用于在各种Java应用程序,包括J2EE,We

Report Machine（RM）报表控件简单用法-delphi

RM(Report Machine)是一个功能强大的Delphi报表控件包.使用它可以制作出非常复杂的报表.下面讲述最简单的用法: 在Form上放上两个数据库控件:ADOConnection和ADOQuery设置好ADOConnection的ConnectionString.LoginPrompt=False.ADOQuery的Connection指向ADOConnection.ADOQuery的SQL设置好数据查询语句. 在Form上放上两个RM报表控件:RMDBDataSet和RMRepor

JasperReport报表开发(一)--原理介绍

1. JasperReport介绍 JasperReport 是一个开源的Java报表引擎,它不像其他的报表工具,例如Crystal报表是基于Java的,没有自己的表达式语法.Jasper Reports有提供丰富的内容到屏幕上,到打印机,或转换成PDF,HTML,XLS,RTF,ODT,CSV,TXT和XML文件的能力.Jasper Reports是一个Java类库,需要嵌入到Java应用程序中.Jasper Report的特点如下: 具有灵活的报表布局: 可以用文字或图形显示数据: 开发人员