JasperReports報表字段

報表字段是代表數(shù)據源和報表模板之間的數(shù)據映射元素。字段可以在報告中的表達式進行組合，以獲得所需的輸出。報表模板可以包含零個或更多的<field>元素。當聲明報表字段，數(shù)據源應提供相應的數(shù)據到所有在報告模板中定義的字段。

字段聲明

字段聲明做如下：

<field name="FieldName" class="java.lang.String"/>

name屬性

<field>元素的name屬性是強制性的。它通過名稱引用的報表表達的字段。

class屬性

class屬性指定的字段值的類名。它的默認值是java.lang.String。這是可以改變的，以在運行時可用任何類。不論一個報表字段的類型，引擎采用鑄造于該$ F{}標記用于報表表達式，從而使手工投射不必要。

字段描述

<fieldDesciption>元素是可選元素。實現(xiàn)自定義的數(shù)據源，例如，當這是非常有用的。我們可以存儲一個密鑰或一些信息，使用它我們可以在運行時自定義數(shù)據源中檢索字段的值。通過使用<fieldDesciption>元素而不是字段名，可以檢索從數(shù)據源中的字段值時容易克服字段命名約定的限制。

下面是一段代碼從我們現(xiàn)有的jrxml文件（第二章報告的設計）。在這里我們可以看到name, class 和 fieldDescription 元素的使用。

<field name="country" class="java.lang.String">
    <fieldDescription><![CDATA[country]]></fieldDescription>
</field>
<field name="name" class="java.lang.String">
    <fieldDescription><![CDATA[name]]></fieldDescription>
</field>

排序字段

數(shù)據的排序是必要的，數(shù)據源實現(xiàn)不支持它（如CSV數(shù)據源），JasperReports的支持在內存領域為基礎的數(shù)據源排序。排序可以使用的報表模板的一個或多個<sortField>元素來完成。

如果指定ATLEAST1排序字段，在報告填充過程中的數(shù)據源傳遞給JRSortableDataSource實例。這反過來從獲取數(shù)據源中的所有記錄，根據指定的字段進行排序的內存中，并替換原來的數(shù)據源。

排序字段名稱應該是相同的報表字段名稱。用于排序的字段應該具有實現(xiàn)java.util.Comparable類型。進行自然順序排序的所有字段除外java.lang.String類型（對于字符串類型，對應報告的填充區(qū)域自動分頁使用）。當有多個排序字段指定，排序將使用的字段進行中它們出現(xiàn)在報告模板的順序排序鍵。下面的例子demonstartes顯示排序功能。

Sorted Report 例子

sortField>元素添加到我們現(xiàn)有的報告模板（第報表設計）。讓我們排序字段country 降序排列。修訂后的報告模板（jasper_report_template.jrxml）如下。將其保存到C: oolsjasperreports-5.0.1 est directory:

<?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>
  <sortField name="country" order="Descending"/>
   <sortField name="name"/>
   <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"
            上一篇：JasperReports入門，JasperReports是什么？下一篇：JasperReports報表表達式