JasperReports-環境設定

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

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

JasperReport環境

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

Jasperディレクトリ構造

ここにすべてのディレクトリの詳細があります-

build-コンパイルされたJasperReportクラスファイルが含まれています。
demo-JasperReportsの機能のいくつかの側面を示すさまざまな例が含まれています。
dist-jasperreports-x.x.x.jarファイルが含まれています。 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-x.x.x.jarと_lib_ディレクトリの下のJARのみを使用します。 JasperReportsはオープンソースツールであるため、実行中にjasperreports-x.x.x.jarで欠陥またはバグが認識された場合、build.xmlファイルを使用して修正し、JARを再構築できます。

CLASSPATHを設定する

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

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

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

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

ビルド設定

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

シンプルなテキストエディタを使用して記述されています。
ディレクトリC：\ tools \ jasperreports-5.0.1 \ test \ src \ com \ finddevguidesに保存されています。 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.finddevguides.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：\ tools \ jasperreports-5.0.1 \ test \ srcです
classes.dir-はC：\ tools \ jasperreports-5.0.1 \ test \ classesです
main-class-com.finddevguides.HelpMe。このクラスは、コマンドラインからクラスファイル名が渡されないときに実行される単純なクラスです。このファイルをC：\ tools \ jasperreports-5.0.1 \ test \ src \ com \ finddevguidesに保存します。

package com.finddevguides;

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.finddevguides.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-レポートをロードおよび表示できる単純なJava Swingアプリケーションを表します。
net.sf.jasperreports.view.JasperDesignViewer-設計時にレポートテンプレートをプレビューするために使用されます。

Apache ANTのセットアップ

Apache ANTを使用してすべての例をビルドします。リンクを確認してください：/ant/ant_environment [ANT-Environment Setup]の章で、システムにApache ANTをセットアップしてください。

Jasper-reports-jasper-environment-setup