Jasper-reports-jasper-filling-reports

提供:Dev Guides
移動先:案内検索

JasperReports-レポートの記入

レポート作成ツールの主な目的は、高品質のドキュメントを作成することです。 レポート入力プロセスは、データのセットを操作することでレポートツールがこれを達成するのに役立ちます。

レポート記入プロセスに必要な主な入力は次のとおりです-

  • レポートテンプレート-これは実際のJasperReportファイルです。
  • レポートパラメータ-これらは基本的に、レポート入力時にエンジンに渡される名前付きの値です。 それらについては、link:/jasper_reports/jasper_report_parameters [Report Parameter]の章で説明します。
  • データソース-SQLクエリ、XMLファイル、csvファイル、HQL(Hibernate Query Language)クエリ、Java Beansのコレクションなど、さまざまなデータソースからJasperファイルを入力できます。 これについては、link:/jasper_reports/jasper_report_data_sources [レポートデータソース]の章で詳しく説明します。

このプロセスによって生成される出力は、表示、印刷、または他の形式へのエクスポートが可能な .jrprint ドキュメントです。 ファサードクラス_net.sf.jasperreports.engine.JasperFillManager_は通常、レポートテンプレートにデータを入力するために使用されます。 このクラスには、レポートテンプレートを埋めるさまざまな_fillReportXXX()_メソッドがあります(テンプレートは、ディスクに配置したり、入力ストリームから選択したり、インメモリとして直接提供したりできます)。

このファサードクラスには、fillReportXXX()メソッドの2つのカテゴリがあります-

  • 最初のタイプは、3番目のパラメーターとしてjava.sql.Connectionオブジェクトを受け取ります。 ほとんどの場合、レポートにはリレーショナルデータベースのデータが入力されます。 これは以下によって達成されます-
  • JDBCを介してデータベースに接続します。
  • レポートテンプレート内にSQLクエリを含めます。
  • JasperReportsエンジンは、渡された接続を使用してSQLクエリを実行します。
  • このようにして、レポートを埋めるためのレポートデータソースが生成されます。
  • 2番目のタイプは、入力が必要なデータが他のフォームで利用可能な場合に、net.sf.jasperreports.engine.JRDataSourceオブジェクトを受け取ります。

レポートテンプレートの入力

レポートテンプレートを作成しましょう。 JRXMLファイル(C:\ tools \ jasperreports-5.0.1 \ test \ jasper_report_template.jrxml)の内容は以下のとおりです-

<?xml version = "1.0" encoding = "UTF-8"?>
<!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" language = "groovy" pageWidth = "595"
   pageHeight = "842" columnWidth = "555" leftMargin = "20" rightMargin = "20"
   topMargin = "20" bottomMargin = "20">

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

   <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[$F{name}]]>
            </textFieldExpression>
         </textField>

      </band>
   </detail>

</jasperReport>

次に、Javaデータオブジェクト(Java Bean)のコレクションをJasperReport Engineに渡して、このコンパイル済みレポートに入力します。

データオブジェクト(Java Bean)を表すPOJO DataBean.javaを記述します。 このクラスは、2つのStringオブジェクト、つまり 「名前」と「国」。 それをディレクトリ C:\ tools \ jasperreports-5.0.1 \ test \ src \ com \ finddevguides に保存します。

package com.finddevguides;

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

Java Beanオブジェクトのコレクションを生成するビジネスロジックを持つクラスDataBeanList.javaを記述します。 これはさらにJasperReportsエンジンに渡され、レポートを生成します。 ここでは、リストに4つのDataBeanオブジェクトを追加しています。 それをディレクトリ C:\ tools \ jasperreports-5.0.1 \ test \ src \ com \ finddevguides に保存します。

package com.finddevguides;

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

メインクラスファイル JasperReportFill.java を作成します。このファイルは、クラス(DataBeanList)からJava Beanコレクションを取得し、それをJasperReportsエンジンに渡して、レポートテンプレートに入力します。 それをディレクトリ C:\ tools \ jasperreports-5.0.1 \ test \ src \ com \ finddevguides に保存します。

package com.finddevguides;

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();
      try {
         JasperFillManager.fillReportToFile(
            sourceFileName, parameters, beanColDataSource);
      } catch (JRException e) {
         e.printStackTrace();
      }
   }
}

レポートを生成する

通常のANTビルドプロセスを使用して、これらのファイルをコンパイルして実行します。 build.xmlファイルは以下のとおりです-

インポートファイル-baseBuild.xmlは、チャプターリンク:/jasper_reports/jasper_environment_setup [Environment Setup]から選択され、build.xmlと同じディレクトリに配置する必要があります。

<?xml version = "1.0" encoding = "UTF-8"?>
<project name = "JasperReportTest" default = "executereport" basedir = ".">
   <import file = "baseBuild.xml"/>

   <target name = "executereport" depends = "compile,compilereportdesing,run">
      <echo message = "Im here"/>
   </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.finddevguides.JasperReportFillexecutereport がデフォルトのターゲット)を実行します-

C:\tools\jasperreports-5.0.1\test>ant -Dmain-class = com.finddevguides.JasperReportFill
Buildfile: C:\tools\jasperreports-5.0.1\test\build.xml

compile:
   [javac] C:\tools\jasperreports-5.0.1\test\baseBuild.xml:27:
   warning: 'includeantruntime' was not set, defaulting to
   build.sysclasspath=last; set to false for repeatable builds
   [javac] Compiling 1 source file to
   C:\tools\jasperreports-5.0.1\test\classes

run:
   [echo] Runnin class : com.finddevguides.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.

BUILD SUCCESSFUL
Total time: 8 seconds

上記の実行の結果、ファイル_jasper_report_template.jrprint_が_.jasper_ファイルと同じディレクトリに生成されます(この場合、C:\ tools \ jasperreports-5.0.1 \ testに生成されます)。