カテゴリーアーカイブ: 日記

ちょっと必要がありまして、Jasper Reports というオープンソースの帳票出力ライブラリで PDF の出力を行いました。 使い方を忘れてしまいそうなのでメモがてら。 初めて使うライブラリは勝手が分からずなかなか大変です。

Jasper Reports とその帳票設計を行う iReport というアプリです。

jasperforge JasperReports Project Home

JasperReports is the world’s most popular open source reporting engine. It is entierly written in Java and it is able to use data coming from any kind of data source and produce pixel-perfect documents that can be viewed, printed or exported in a variety of document formats including HTML, PDF, Excel, OpenOffice and Word.

jasperforge iReport Project Home

iReport is the free, open source report designer for JasperReports. Create very sophisticated layouts containing charts, images, subreports, crosstabs and much more. Access your data through JDBC, TableModels, JavaBeans, XML, Hibernate, CSV, and custom sources. Then publish your reports as PDF, RTF, XML, XLS, CSV, HTML, XHTML, text, DOCX, or OpenOffice.

Jasper Report は LGPL、iReport は AGPL です。 iReport のほうは NetBeans ベースでつくられているよう。 前者がライブラリで、後者がそのライブラリで読み込む GUI 帳票設計アプリケーションとなります。

とりあえず、ファイルをダウンロード。 以下二つを利用しました。 iReport のほうは、Linux、Mac OS X 版もあります。 Jasper Reports は pure java です。

jasperreports-3.7.1-project.tar.gz

iReport-3.7.1-windows-installer.exe

また、Jasper Reports の PDF 出力は iText PDF ライブラリに依存しています。 iText 自体は上記 project.tar.gz （のlib）に同梱されいますが、日本語の出力の際に必要な iTextAsian.jar が含まれていませんので以下からダウンロードします。（下の方です）

Browse iText, a JAVA-PDF library Files on SourceForge.net

extrajars  – ExtraJars1.0  – iTextAsian.jar

これでファイルの準備は完了。 iReport のほうは適当にセットアップしておきます。

Jasper Reports はいろいろなデータソースから帳票を出力できますが、今回は Java の Bean 経由で出力してみます。 DB に直つなぎとかもできるみたいですね。

最終的に Java からだすので、先にプログラムソースの準備を。

以下のようなモジュール構成にしておきます。 Jasper Reports の依存ライブラリがよく分かりませんでしたが、今回のプログラムで class not found がでなくなった最小構成としています。 また、先の iTextAsian.jar もいっしょに入れておきます。

templates フォルダには Jasper Repost の定義体を入れることにしましょう。

SampleReportBean.java が帳票に出力したいレコードを表現した Bean です。 Bean の内容は以下の通り。 getter、setter は省略。

   1: package net.maple4ever.jasper;

   2:  

   3: public class SampleReportBean {

   4:  

   5:     // メーカ

   6:     private String maker;

   7:     // 機種名

   8:     private String name;

   9:     // OS

  10:     private String os;

  11:     // CPU

  12:     private String cpu;

  13:     // メモリ容量

  14:     private String memory;

  15:     // ハードディスク容量

  16:     private String hdd;

  17:  

  18:     // 以下 getter/setter （省略）

  19: }

さてさて、ここから iReport の世界に入っていきます。 iReport 起動。

とりあえずオプション設定。 iTextAsian.jar と今ほどつくった Java プロジェクトに class path を通します。

Eclipse で Java プロジェクトつくった場合は、プロジェクトロケーション/bin にします。(class ファイルできるところね） で、上のスクリーンショットでは忘れてしまっていますが、Relodable にチェックを入れます。 iTextAsian.jar にはチェックいらないでしょう。（Java プログラムを修正すると読み直してくれます）

了解おして、ここで iReport を一回再起動。（しないと iTextAsian が反映されませんでした）

でもってファイル –> NEW あたりから帳票新規作成。 ファイルの置き場所を先ほどの templates フォルダにします。 種類、ここでは A4 のブランクにしました。

Open this Template おして、

みたいな感じです。

できたら、まずは帳票プロパティの Language を Java に変更します。 Groovy が標準のようですね。 これやらないと、後で Java から呼ぶときに groovy の class ないぞってエラーになります。

帳票設計画面はこんな感じです。

上から Title、Page Header、Column Header、Detail 1、Column Footer、Page Footer、Summary となっています。 この中で Detail の部分が繰り返しのデータをおくところになります。 ここが重要。

でもって、Title、Summary 部分が１ページと最終ページ。 Page/Column  Header、Footer が表ごとページごととなるようです。

ふまえて、レコードとなるさきほどの Bean を Detail 1 に配置していきます。 まずはデザイナ上部、Preview の横のデータベース矢印みたいなアイコンをクリックします。

さきほどつくった Bean のパッケージを入力して Read attributes を押下します。 さすると、Bean のプロパティがでてきます。 うまく読めないときは class path の設定を確認。

選択して Add Selected field(s) ボタンを押下します。 するとこのフィールドがデザイナ上で配置できるようになります。

画面左ツリーの Fields 木にいま追加したフィールド出現するので、ドラッグアンドドロップで Detail 1 に置いていきます。 罫線とか必要ならパレット開いて描画していきます。 static text とかでテーブルヘッダとかタイトルとかもつける。

日本語フォントは PDF Font name を「HeiseiKakuGo-W5」に、PDF Encording を「UniJIS-UCS2-H (Japanese)」にします。 こうしないと PDF になったときに日本語が出力されません。（Adobe Reader のフォント。ちょっと詳しくないですが、iTextAsian.jar の設定値なのかもしれません。 MSP ゴシックとかは設定できない模様）

まぁまぁこんな感じです。

また繰り返しリストではなく、帳票全体でひとつの埋め込み項目は「パラメータ」として配置することができます。 左ツリーのparameter で追加して名前をつけて置いていきます。

でもって、なんとなくできたらデータを埋め込んでみます。 iReport には任意の Java を呼び出してその帰り値の Collection を埋め込んでくれる便利な機能がありました。（Biz Stream はこれできないよね?）

とりあえずさきほどの Java のプロジェクトに SampleReportFactory.java というソースを追加しました。 createBeanCollection という static なメソッドが標準で使われるようなのでこれも用意しておきます。 こんな感じです。

   1: public class SampleReportFactory {

   2:     

   3:     public static List<SampleReportBean> createBeanCollection() {

   4:         

   5:         List<SampleReportBean> lines =

   6:             new ArrayList<SampleReportBean>();

   7:         

   8:         for(int i=1; i<100;i++) {

   9:             SampleReportBean line = new SampleReportBean();

  10:             line.setName("自作機２号");

  11:             line.setMaker("ひろまさ");

  12:             line.setOs("Ubuntu 9.10");

  13:             line.setCpu("PhenomII X4");

  14:             line.setHdd("320GByte");

  15:             line.setMemory("4GByte");

  16:             line.setColor(String.valueOf(i % 2));

  17:             lines.add(line);

  18:         }

  19:         return lines;

  20:     }

  21: }

iReport に戻って画面上部のデータソースのアイコンを押下します。

JavaBeans set datasource を選択。

でもっていまつくった SampleReportFactory を指定します。

Test おして OK もらったら Save します。

で、デザイナの Preview を押してみると帳票につくったデータソースがバインドされた結果が表示されます。

ソースコードから入力をつくれるので桁数試験とか結構便利です。

さてさて、ちゃんとした帳票だと罫線の制御とかしたくなることがあります。

ちょっとマニュアル調べて簡単そうだったのが各描画オブジェクトがもつ、Print When Express というプロパティ。 フィールドとかの値を判定して表示の可否をきめることができます。

たとえば、行をしましまにしたかったら Bean にそれっぽいフラグ項目をつくって、

こんな感じで Print When Expression を設定してあげると true のときだけ表示になります。（Jasper への戻値は、boolean じゃなくて Boolean のようなので注意してください）

というわけで灰色ざぶとんを行の下に敷いて、しましま。 とか。

他にも良い方法があるとは思うですが、これさえあればあとは組み合わせ、、知恵と勇気でなんでもいけるかと。。（笑）

では最後に Java から作った帳票をだしてみます。 iReport 終了。 iReport で保存・コンパイルされたものが templates フォルダに入っているはずです。

.jasper がコンパイルされた結果です。 プログラムからはこちらを使います。（動的コンパイルもできるみたいですがここでは割愛）

面倒なので先ほどの SampleReportFactory クラスに main を追加する感じで。 List はさきほどつくったもの。 また、HashMap にパラメータを設定して Jasper に渡すと PDF ができる感じです。

   1: public class SampleReportFactory {

   2:  

   3:     // さきほどの createBeanCollection メソッド省略

   4:  

   5:     public static void main(String args[]) throws JRException {

   6:         

   7:         // 出力するBean のつまった List を DataSource に設定

   8:         JRBeanCollectionDataSource ds =

   9:             new JRBeanCollectionDataSource(

  10:                 SampleReportFactory.createBeanCollection());

  11:         // パラメータの Map 作成

  12:         Map<String,String> param = new HashMap<String,String>();

  13:         param.put("now", "2010/03/11");

  14:         // これらのデータを元に PDF 作成

  15:         JasperPrint pdf = JasperFillManager.fillReport(

  16:                 "./templates/sample-report.jasper", param, ds);

  17:         // PDF をファイルとして出力

  18:         JasperExportManager.exportReportToPdfFile(pdf,

  19:                 "./templates/sample-report.pdf");

  20:         

  21:         // pdf.addPage((JRPrintPage)pdf.getPages().get(0));

  22:         

  23:     }

  24:  

  25: }

実行～。

おめでとうございます（笑）

最後のサンプルソースの一番下にコメントでかいてありますが、複数のテンプレートをつなげて一つの PDF にすることもできそうです。

   1: // pdf.addPage((JRPrintPage)pdf.getPages().get(0));

addPage の引数に index ありもあったので、交互差し込みとかもできるかもですね。

ここまできたら、本家のマニュアルの xml タグを調べていけばあとはなんとか。。（笑）

JasperReports 3.7.1 – Schema Reference

This document describes the structure of the JRXML report template files for the JasperReports library.

Expression 系でいろいろできそうです。

以上、参考になりましたら。