样式（Styles）

优质

小牛编辑

133浏览

2023-12-01

JasperReports有一个功能，有助于控制报表模板中的文本属性。此元素是在报告级别声明的样式设置的集合。前景色，背景色，字体是否为粗体，斜体或正常，字体大小，字体边框以及许多其他属性等属性由元素控制。样式可以扩展其他样式，也可以添加或覆盖父样式的属性。

风格属性

元素有许多属性。一些最常用的列表如下表所示 -

S.NO	属性和描述
1	name 是强制性的。它必须是唯一的，因为它在整个报表中引用了相应的报表样式。
2	isDefault 指示此样式是否为文档的默认样式。
3	style 是对父样式的引用。
4	mode 指定元素的透明度。可能的值为Opaque和Transparent 。
5	forecolor 是对象的前景色。
6	backcolor 是对象的背景颜色。
7	fill 确定用于填充对象的填充图案。目前，允许的单个值为Solid 。
6	radius 指定矩形角圆弧的半径。
7	scaleImage 仅指定图像的比例。可能的值: Clip, FillFrame, RetainShape, RealHeight,和RealSize 。
8	hAlign 指定水平对齐。可能的值: Left, Center, Right,和Justified 。
9	vAlign 指定垂直对齐方式。可能的值: Top, Middle,和Bottom 。
10	rotation 指定元素的旋转。可能的值: None, Left, Right,和UpsideDown 。
11	lineSpacing 指定文本行之间的行间距。可能的值: Single, 1_1_2, Double 。
12	markup 指定样式文本的标记样式。
13	fontName 指定字体名称。
14	fontSize 指定字体大小。
15	isBold 指示字体样式是否为粗体。
16	isItalic 指示字体样式是否为斜体。
17	isUnderline 指示字体样式是否为下划线。
18	isStrikeThrough 指示字体样式是否为删除线。
19	pdfFontName 指定相关的PDF字体名称。
20	pdfEncoding 指定PDF输出格式的字符编码。
22	isPdfEmbedded 指示是否嵌入了PDF字体。
23	pattern 指定格式化文本的格式模式。
24	isBlankWhenNull 指示如果表达式求值为null，是否应显示空字符串（空格）。

条件样式

在某些情况下，只有在满足特定条件时才应用样式（例如，在报表详细信息部分中交替相邻的行颜色）。这可以使用条件样式来实现。

条件样式有两个元素 -

a Boolean condition expression
a style

仅当条件计算结果为true时才使用该样式。

将样式应用于报表元素

任何类型的报表元素都可以使用style属性引用报表样式定义。因此，将继承适用于当前元素的样式定义声明的所有样式属性。要覆盖继承的值，可以使用在报表元素级别指定的样式属性。

样式模板

通过在公共场所定义样式，我们可以制作一组具有共同外观的报告。然后，报告模板可以引用此常用样式模板。样式模板是包含一个或多个样式定义的XML文件。约定使用的样式模板文件*.jrtx扩展名，但这不是必需的。

样式模板包含以下元素 -

《jasperTemplate》 - 这是样式模板文件的根元素。
《template》 - 此元素用于包含对其他模板文件的引用。此元素的内容被解释为引用的模板文件的位置。
《style》 - 此元素与报表设计模板（JRXML文件）中具有相同名称的元素相同，但样式模板中的样式不能包含条件样式。这种限制是由条件样式涉及报表表达式而导致的，而表达式只能在单个报表定义的上下文中解释。

JRXML报告中对样式模板的引用作为元素包含在内。样式模板在报告填充时加载，样式名称引用在加载所有模板后解析。加载样式模板并将样式名称解析为样式时，会创建样式模板的树/图，树的顶部是报告中定义的样式集。在此树上，样式名称引用将解析为与深度优先遍历中的名称匹配的最后一个样式。

例子 (Example)

让我们试试条件样式和样式模板。让我们将< style “元素alternateStyle添加到现有的报告模板（章节报告设计）。根据条件，字体颜色变为蓝色以进行均匀计数。我们还包含了一个样式模板"styles.jrtx" 。修订后的报告模板（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">
   <template>"styles.jrtx"</template>
   <style name = "alternateStyle" fontName = "Arial" forecolor = "red">
      <conditionalStyle>
         <conditionExpression>
            <![CDATA[new Boolean($V{countNumber}.intValue() % 2 == 0)]]>
         </conditionExpression>
         <style forecolor = "blue" isBold = "true"/>
      </conditionalStyle>
   </style>
   <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 style = "alternateStyle" 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" 
               style = "Strong"/>
            <textElement textAlignment = "Center" verticalAlignment = "Middle" />
            <textFieldExpression class = "java.lang.String">
               <![CDATA[$F{name}]]>
            </textFieldExpression>
         </textField>
      </band>
   </detail>
</jasperReport>

样式模板styles.jrtx的内容如下。将其保存到C:\tools\jasperreports-5.0.1\test目录。

<?xml version = "1.0"?>
<!DOCTYPE jasperTemplate PUBLIC "-//JasperReports//DTD Template//EN"
  "http://jasperreports.sourceforge.net/dtds/jaspertemplate.dtd">
<jasperTemplate>
   <style name = "Strong" isBold = "true" pdfFontName = "Helvetica-Bold" 
      backcolor = "lightGray forecolor = "green"/>
</jasperTemplate>

报告填充的java代码保持不变。文件C:\tools\jasperreports-5.0.1\test\src\com\xnip\JasperReportFill.java的内容如下所示 -

package cn.xnip;
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\xnip\DataBean.java的内容如下 -

package cn.xnip;
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\xnip\DataBeanList.java的内容如下 -

package cn.xnip;
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;
   }
}

报表生成 (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=cn.xnip.JasperReportFill （viewFullReport是默认目标）为 -

C:\tools\jasperreports-5.0.1\test>ant -Dmain-class=cn.xnip.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 3 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.html#noconfig for more info.
   [jrc] File : C:\tools\jasperreports-5.0.1\test\jasper_report_template.jrxml ... OK.
run:
   [echo] Runnin class : cn.xnip.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.

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

在这里，我们可以看到字体的颜色在偶数计数（在列国家/地区）中更改为蓝色。在列名称中，字体颜色更改为绿色（此样式从样式模板引用）。