Estilos de relatório

JasperReports tem um recurso <style> que ajuda a controlar as propriedades do texto em um modelo de relatório. Este elemento é uma coleção de configurações de estilo declaradas no nível do relatório. Propriedades como cor de primeiro plano, cor de fundo, se a fonte é negrito, itálico ou normal, o tamanho da fonte, uma borda para a fonte e muitos outros atributos são controlados pelo elemento <style>. Os estilos podem estender outros estilos e adicionar ou substituir propriedades do estilo pai.

Propriedades de estilo

Um elemento <style> possui muitos atributos. Alguns dos mais comumente usados ​​estão listados na tabela abaixo -

S.NO Atributo e descrição
1

name

É mandatório. Deve ser exclusivo porque faz referência ao estilo de relatório correspondente em todo o relatório.
2

isDefault

Indica se este estilo é o estilo padrão do documento.
3

style

É uma referência ao estilo pai.
4

mode

Especifica a transparência do elemento. Os valores possíveis são Opaco e Transparente .
5

forecolor

É a cor de primeiro plano do objeto.
6

backcolor

É a cor de fundo do objeto.
7

fill

Determina o padrão de preenchimento usado para preencher o objeto. No momento, o único valor permitido é Solid .
6

radius

Especifica o raio do arco do canto do retângulo.
7

scaleImage

Especifica a escala apenas para as imagens. Valores possíveis: Clip, FillFrame, RetainShape, RealHeight e RealSize .
8

hAlign

Especifica o alinhamento horizontal. Valores possíveis: Esquerda, Centro, Direita e Justificado .
9

vAlign

Especifica o alinhamento vertical. Valores possíveis: Top, Middle e Bottom .
10

rotation

Especifica a rotação do elemento. Valores possíveis: Nenhum, Esquerda, Direita e UpsideDown .
11

lineSpacing

Especifica o espaçamento de linha entre as linhas de texto. Valores possíveis: Single, 1_1_2, Double .
12

markup

Especifica o estilo de marcação para textos estilizados.
13

fontName

Especifica o nome da fonte.
14

fontSize

Especifica o tamanho da fonte.
15

isBold

Indica se o estilo da fonte está em negrito.
16

isItalic

Indica se o estilo da fonte é itálico.
17

isUnderline

Indica se o estilo da fonte está sublinhado.
18

isStrikeThrough

Indica se o estilo da fonte é tachado.
19

pdfFontName

Especifica o nome da fonte do PDF relacionado.
20

pdfEncoding

Especifica a codificação de caracteres para o formato de saída PDF.
22

isPdfEmbedded

Indica se a fonte do PDF está incorporada.
23

pattern

Especifica o padrão de formato para textos formatados.
24

isBlankWhenNull

Indica se uma string vazia (espaço em branco) deve ser mostrada se a expressão for avaliada como nula.

Estilos Condicionais

Em algumas situações, um estilo deve ser aplicado apenas quando determinada condição for atendida (por exemplo, para alternar cores de linhas adjacentes em uma seção de detalhes do relatório). Isso pode ser alcançado usando estilos condicionais.

Um estilo condicional tem dois elementos -

  • uma expressão de condição booleana
  • um estilo

O estilo é usado apenas se a condição for avaliada como verdadeira .

Aplicação de estilos a elementos de relatório

Qualquer tipo de elemento de relatório pode fazer referência a uma definição de estilo de relatório usando o atributo style. Conseqüentemente, todas as propriedades de estilo declaradas pela definição de estilo que são aplicáveis ​​ao elemento atual serão herdadas. Para substituir os valores herdados, as propriedades de estilo especificadas no nível do elemento do relatório podem ser usadas.

Modelos de estilo

Podemos fazer um conjunto de relatórios com uma aparência comum, definindo o estilo em um lugar comum. Este modelo de estilo comum pode então ser referenciado pelos modelos de relatório. Um modelo de estilo é um arquivo XML que contém uma ou mais definições de estilo. Arquivos de modelo de estilo usados ​​pela convenção*.jrtx extensão, mas isso não é obrigatório.

Um modelo de estilo contém os seguintes elementos -

  • <jasperTemplate> - Este é o elemento raiz de um arquivo de modelo de estilo.

  • <template> - Este elemento é usado para incluir referências a outros arquivos de modelo. O conteúdo deste elemento é interpretado como a localização do arquivo de modelo referido.

  • <style> - este elemento é idêntico ao elemento com o mesmo nome dos modelos de design de relatório (arquivos JRXML), com a exceção de que um estilo em um modelo de estilo não pode conter estilos condicionais. Essa limitação é causada pelo fato de que os estilos condicionais envolvem expressões de relatório e as expressões só podem ser interpretadas no contexto de uma única definição de relatório.

Referências a modelos de estilo são incluídas em relatórios JRXML como elementos <template>. Os modelos de estilo são carregados no tempo de preenchimento do relatório e as referências de nome de estilo são resolvidas assim que todos os modelos forem carregados. Ao carregar modelos de estilo e resolver nomes de estilo para estilos, uma árvore / gráfico de modelos de estilo é criado, sendo o topo da árvore o conjunto de estilos definidos no relatório. Nesta árvore, as referências de nome de estilo são resolvidas para o último estilo que corresponde ao nome em uma travessia em profundidade.

Exemplo

Vamos experimentar os estilos condicionais e modelos de estilo. Vamos adicionar o <style> elemento alternateStyleao nosso modelo de relatório existente (Capítulo Report Designs ). Com base na condição, a cor da fonte muda para azul para contagem uniforme. Também incluímos um modelo de estilo"styles.jrtx". O modelo de relatório revisado (jasper_report_template.jrxml) é o seguinte. Salve-o no diretório 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>

O conteúdo do modelo de estilo styles.jrtxsão como segue. Salve-o no diretório 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>

Os códigos java para preenchimento de relatório permanecem inalterados. O conteúdo do arquivoC:\tools\jasperreports-5.0.1\test\src\com\tutorialspoint\JasperReportFill.java são os dados abaixo -

package com.tutorialspoint;

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();
      }
   }
}

O conteúdo do arquivo POJO C:\tools\jasperreports-5.0.1\test\src\com\tutorialspoint\DataBean.java são como abaixo -

package com.tutorialspoint;

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;
   }
}

O conteúdo do arquivo C:\tools\jasperreports-5.0.1\test\src\com\tutorialspoint\DataBeanList.java são como abaixo -

package com.tutorialspoint;

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;
   }
}

Geração de relatório

Vamos compilar e executar o arquivo acima usando nosso processo normal de construção ANT. O conteúdo do arquivo build.xml (salvo no diretório C: \ tools \ jasperreports-5.0.1 \ test) é fornecido a seguir.

O arquivo de importação - baseBuild.xml é obtido no capítulo Configuração do ambiente e deve ser colocado no mesmo diretório do 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>

A seguir, vamos abrir a janela da linha de comando e ir para o diretório onde build.xml está colocado. Finalmente, execute o comandoant -Dmain-class=com.tutorialspoint.JasperReportFill (viewFullReport é o destino padrão) como -

C:\tools\jasperreports-5.0.1\test>ant -Dmain-class=com.tutorialspoint.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 : com.tutorialspoint.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.

Como resultado da compilação acima, uma janela JasperViewer é aberta conforme mostrado na tela abaixo -

Aqui, podemos ver que a cor da fonte é alterada para azul para contagem par (no país da coluna). No nome da coluna, a cor da fonte é alterada para verde (este estilo é referenciado no modelo de estilo).

ja/tutorial
es/tutorial
de/tutorial
fr/tutorial
th/tutorial
pt/tutorial
ru/tutorial
vi/tutorial
it/tutorial
ko/tutorial
tr/tutorial
id/tutorial
pl/tutorial
hi/tutorial
japost
espost
depost
frpost
thpost
ptpost
rupost
vipost
itpost
kopost
trpost
idpost
plpost
hipost

© Copyright 2021 - 2024 | All Rights Reserved