JasperReports-環境設定

JasperReportsは純粋なJavaライブラリであり、スタンドアロンアプリケーションではありません。単独で実行することはできないため、別のクライアントまたはサーバー側のJavaアプリケーションに組み込む必要があります。Javaベースであるため、Javaをサポートする任意のプラットフォーム（JDK 1.3以降）で実行できます。JasperReportのすべての機能は、単一のJARファイルjasperreports-xxxjarにまとめられています。このJARは、必須およびオプションのライブラリ（.ZIPファイル）とともに、次のサイトからダウンロードできます：JasperReport LibraryLink。このリンクから最新バージョンをダウンロードしてください。

ZIPファイルには、JasperReportsのJARファイル、JasperReportsのソースコード、依存するJAR、およびJasperReportの機能を示す多くの例が含まれています。

JasperReport環境

レポートの作成を開始するには、環境を準備する必要があります。ダウンロードしたJasperReport.ZIPファイルを任意の場所に抽出します（この場合、C：\ tools \ jasperreports-5.0.1に抽出しました）。抽出したファイルのディレクトリ構造は以下のとおりです。

これがすべてのディレクトリの詳細です-

ビルドは-コンパイルJasperReportクラスファイルが含まれています。
デモ-JasperReports機能のいくつかの側面を示すさまざまな例が含まれています。
dist −jasperreports-xxxjarファイルが含まれています。JasperReportsを利用するために、このJARファイルをCLASSPATHに追加します。
docs -JasperReportsドキュメントのローカルコピーが含まれています。
lib -JasperReportsの構築とアプリケーションでの使用の両方に必要なすべてのJARが含まれています。
src -JasperReportsソースコードが含まれています。
build.xml -JasperReportsソースコードをビルドするためのANTビルドファイル。JasperReportsを変更する予定がない場合、JasperReportsはコンパイルされた形式で配布されるため、このファイルを使用する必要はありません。
Changes.txt -JasperReportsクラスライブラリの現在のバージョンと以前のバージョンの違いを説明するテキストドキュメント。
license.txt -LGPL（Lesser General Public License）ライセンスの全文を含むテキストドキュメント。
readme.txt-提供された例を作成および実行する方法の説明を含むテキストドキュメント。

基本的に、レポートの生成には、distの下のjasperreports-xxxjarとlibディレクトリの下のJARのみを使用します。JasperReportsはオープンソースツールであるため、jasperreports-xxxjarでの実行中に欠陥やバグが認識された場合は、それを修正し、build.xmlファイルを使用してJARを再構築できます。

クラスパスを設定する

JasperReportを使用するには、次のファイルをCLASSPATHに設定する必要があります-

jasperreports-xxxjar、ここでxxxはJasperReportsバージョンです。これはディレクトリC：\ tools \ jasperreports-xxx \ distの下にあります。
libサブディレクトリ（C：\ tools \ jasperreports-xxx \ lib）の下にあるすべてのJARファイル。

インストール時には、JasperReportバージョン5.0.1を使用しました。「マイコンピュータ」を右クリックして「プロパティ」を選択し、「詳細」タブの下にある「環境変数」ボタンをクリックします。ここで、「Path」変数をこれで更新しますC:\tools\jasperreports-5.0.1\dist\jasperreports-5.0.1.jar:C:\tools\jasperreports-5.0.1\lib。これで、レポートを作成する準備が整いました。

このチュートリアルのすべての例では、ANTタスクを使用してレポートを生成しました。ザ・buildfileは、レポートの生成に必要なすべてのJARのインポートを処理します。したがって、上記のようにCLASSPATHを設定すると、ANTを使用せずにレポートを生成したい場合にのみ役立ちます。

ビルドセットアップ

このチュートリアルのすべての例-

シンプルなテキストエディタを使用して書かれています。
ディレクトリC：\ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspointに保存されています。
Apache ANTを使用して、コマンドプロンプトからコンパイルおよび実行されました。を使用しますbaseBuild.xml ANTにインポートするファイル build.xml以降の章でファイルします。このファイルをC：\ tools \ jasperreports-5.0.1 \ testに保存します。以下はbaseBuild.xmlファイルの内容です-

<?xml version = "1.0" encoding = "UTF-8"?>
<project name = "JasperReportExample" basedir = ".">
   <description>Previews our JasperReport XML Design</description>
   <property name = "file.name" value = "jasper_report_template" />
   
   <!-- Directory where the JasperReports project file was extracted
   needs to be changed to match the local environment -->
   <property name = "jasper.dir" value = "../" />
   <property name = "dist.dir" value = "${jasper.dir}/dist" />
   <property name = "lib.dir" value = "${jasper.dir}/lib" />
   <property name = "src.dir" value = "src" />
   <property name = "classes.dir" value = "classes" />
   <property name = "main-class" value = "com.tutorialspoint.HelpMe" />

   <path id = "classpath">
      <pathelement location = "./" />
      <pathelement location = "${classes.dir}" />
	  
      <fileset dir = "${lib.dir}">
         <include name = "**/*.jar" />
      </fileset>
	  
      <fileset dir = "${dist.dir}">
         <include name = "**/*.jar" />
      </fileset>
   </path>
   
   <target name = "compile" depends = "clean-sample">
      <mkdir dir = "${classes.dir}"/>
		
      <javac srcdir = "${src.dir}" destdir = "${classes.dir}" 
         classpathref = "classpath" />
   </target>
   
   <target name = "run" depends = "compile">
      <echo message = "Running class : ${main-class}"/>
	  
      <java fork = "true" classname = "${main-class}">
         <classpath>
            <path refid = "classpath" />
         </classpath>
      </java>
   </target>
   
   <target name = "clean-sample">
      <delete dir = "${classes.dir}" />
      <delete file = "./${file.name}.jasper" />
      <delete file = "./${file.name}.jrprint" />
   </target>
   
</project>

このファイルには、ディレクトリのクリーンアップ、Javaファイルのコンパイル、クラスファイルの実行など、必要なすべてのターゲットが含まれています。

以下は、baseBuild.xmlのさまざまなディレクトリで言及されている詳細です。現在のディレクトリがC：\ tools \ jasperreports-5.0.1 \ testであると仮定します）-

jasper.dir-はC：\ tools \ jasperreports-5.0.1ディレクトリです
lib.dir-はC：\ tools \ jasperreports-5.0.1 \ libディレクトリです
src.dir - Cで：\ツール\ JasperReportsの-5.0.1 \テスト\ SRC
classes.dir −はC：\ tools \ jasperreports-5.0.1 \ test \ classesです
メインクラス-com.tutorialspoint.HelpMe。このクラスは、コマンドラインからクラスファイル名が渡されない場合に実行される単純なクラスです。このファイルをC：\ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspointに保存します。

package com.tutorialspoint;

public class HelpMe {
   public static void main(String[] args) {
      System.out.println("This is the default class executed."
         + "Please pass the fully qualified class" + " name to be executed as command line"
         + " parameter, for example," + " com.tutorialspoint.HelpMe ");
   }
}

ジャスパーマネージャークラス

JRXMLレポートデザインのコンパイル、レポートの入力、レポートの印刷、PDF、HTMLおよびXMLファイルへのエクスポート、生成されたレポートの表示、およびレポートデザインに使用されるクラスは多数あります。

これらのクラスのリストは次のとおりです。

net.sf.jasperreports.engine.JasperCompileManager-JRXMLレポートテンプレートをコンパイルするために使用されます。
net.sf.jasperreports.engine.JasperFillManager-データソースからのデータでレポートを埋めるために使用されます。
net.sf.jasperreports.engine.JasperPrintManager-JasperReportsライブラリによって生成されたドキュメントを印刷するために使用されます。
net.sf.jasperreports.engine.JasperExportManager-レポート入力プロセスによって生成されたドキュメントのPDF、HTML、またはXMLコンテンツを取得するために使用されます。
net.sf.jasperreports.view.JasperViewer-レポートをロードおよび表示できる単純なJavaSwingアプリケーションを表します。
net.sf.jasperreports.view.JasperDesignViewer-レポートテンプレートをプレビューするために設計時に使用されます。

ApacheANTのセットアップ

ApacheANTを使用してすべての例を作成します。したがって、ANT-環境設定の章を確認して、システムにApacheANTを設定してください。