JasperReportsのインストールとセットアップ

JasperReportsとは

JasperReportsとは、xml定義ファイルから帳票を生成するJavaライブラリです。JasperReports Server, iReport, Jaspersoft Studioもこのライブラリを使っているため、このjarファイルが同梱されています。

帳票を作成する場合は、JasperReportsライブラリを直接使うよりも、これらのツールを使うことを推奨します。JasperReports Serverの使い方についてはJasperReports Serverのページ、 iReportの使い方についてはiReportのページ、Jaspersoft Studioの使い方についてはJaspersoft Studioのページを参照してください。

本ページはこれらのツールを使わずに、独自で開発するJavaアプリケーション又はJasperReports本体を変更する開発者を対象にします。

必須環境

JasperReportsを利用するには以下のソフトウエアが必要です：

• Java JDK1.6以降が必要です。iReportはJDK1.7では正常にビルドできないので、iReportで使う場合はJDK1.6を推奨します。
• Apache Ant JasperReportsのデモを実行する場合とビルドする場合に必要

インストール

ダウンロードしたファイルを任意のディレクトリに解凍します。解凍すると以下のようなディレクトリが作成されます：

build	コンパイルされた*.classファイル
demo	JasperReportsのデモ（サンプル）プログラムと設定ファイル
dist	配布用のjasperreports-x.y.z.jarファイル JavaアプリケーションでJasperReportsを使う場合はここのjarファイルをclasspathに設定します。
docs	JasperReportsドキュメント JasperReportsの詳細情報はこのディレクトリ内のJasperReports-Ultimate-Guide-3.pdfを参照してください。
lib	JasperReportsが使う第三者ライブラリ
src	JasperReportsのソースファイル
tests	テストプログラム

JasperReportsのライブラリファイルはdistディレクトリ内にあります。 　　　　　　　一般的なJavaアプリケーションで使うファイルはjaserreports-x.y.z.jarファイルです。このファイルをJavaのclasspathに追加してください。

デモの実行

デモプログラムはApache Antがインストール／セットアップされていることを前提にします。
コメンドプロントから「ant -version」コマンドを実行してバージョン情報が表示されることを確認してください。
デモプログラムはdemoディレクトリの下にあります。しかし、デモプログラムはlibディレクトリにあるjarファイルを利用するためJasperReportsを解凍したディレクトリの構成内で実行してください。
 

ビルドの仕方

JasperReportsをソースファイルからビルドする場合は、JasperReportsを解凍してディレクトリから「ant」を実行します。ビルドされたjarファイルは「dist」フォルダに作成されます。