Membuat Master Detail Report Menggunakan JRBeansCollections DataSource

Published by Martinus Ady H on July 11th, 2009 in Java, NetBeans.

Diberdayakan oleh Terjemahan

Banyak sekali pertanyaan dari teman-teman tentang bagaimana cara membuat report dengan menggunakan JRBeansCollection sebagai datasource-nya, sebenarnya konsepnya tidak jauh berbeda dari pembuatan report dengan menggunakan JDBC sebagai datasourcenya. Pada latihan kali ini, sekarang mari kita coba bagaimana sih membuat report menggunakan JRBeansCollection sebagai datasourcenya Untuk teman-teman yang belum tahu bagaimana membuat report dengan menggunakan JDBC DataSource, silahkan baca dahulu tulisan tentang Membuat Master Detail Report dengan iReport, dan buat teman-teman yang sudah tidak sabar bagaimana membuat Report dengan menggunakan JRBeansCollections mari langsung kita mulai saja.

Sebelum memulai latihan kali ini, persiapkanlah dahulu perlengkapan yang akan digunakan yaitu :1. iReport 3.0.02. NetBeans IDE 6.73. MySQL 5.0.674. JDK 1.6.0_13

Setelah semua perlengkan selesai, pada tulisan kali ini akan dibagi menjadi beberapa bagian yaitu :1. Download Sample Project RptMasterDetail.zip dan RptMasterDetail.sql2. Modifikasi Report RptMaster.jrxml dan RptDetail.jrxml3. Menggunakan JRBeansCollections Sebagai DataSource

1. Download Sample Project RptMasterDetail.zip dan RptMasterDetail.sqlSebagai langkah awal, mari kita download dahulu aplikasi RptMasterDetail.zip dan Database schema RptMasterDetail.sql dari tutorial Membuat Master Detail Report dengan iReport dengan cara sebagai berikut :

123456789

[martin@opensolarisbox:~/jrbeans]$ wget -c http://martinusadyh.web.id/download/RptMasterDetail.zip --00:49:53--  http://martinusadyh.web.id/download/RptMasterDetail.zip            => `RptMasterDetail.zip' Resolving martinusadyh.web.id... 208.87.243.66 Connecting to martinusadyh.web.id|208.87.243.66|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 31,118 (30K) [application/zip] 100%

10111213141516171819202122232425

[========================================================================================================================================>] 31,118        21.80K/s 00:49:55 (21.75 KB/s) - `RptMasterDetail.zip' saved [31118/31118] [martin@opensolarisbox:~/jrbeans]$ wget -c http://martinusadyh.web.id/download/RptMasterDetail.sql --00:50:03--  http://martinusadyh.web.id/download/RptMasterDetail.sql            => `RptMasterDetail.sql' Resolving martinusadyh.web.id... 208.87.243.66 Connecting to martinusadyh.web.id|208.87.243.66|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 1,824 (1.8K) [text/x-sql] 100%[========================================================================================================================================>] 1,824          6.93K/s 00:50:03 (6.92 KB/s) - `RptMasterDetail.sql' saved [1824/1824] [martin@opensolarisbox:~/jrbeans]$

2.[1.] Setelah proses download selesai, sekarang restore database schema RptMasterDetail.sql kedalam MySQL dengan cara sebagai berikut :

123

[martin@opensolarisbox:~/jrbeans]$ mysql -u root -p < RptMasterDetail.sql Enter password: [martin@opensolarisbox:~/jrbeans]$

3.[2.] Proses konfigurasi database telah selesai, sekarang kita coba melakukan modifikasi report yang menggunakan JDBC DataSource agar menggunakan JRBeansCollections sebagai datasourcenya

4. Modifikasi Report RptMaster.jrxml dan RptDetail.jrxmlEkstrak-lah file RptMasterDetail.zip dengan perintah unzip namafile.zip seperti dibawah ini :

12345678910111213141516171819

[martin@opensolarisbox:~/jrbeans]$ unzip RptMasterDetail.zip Archive:  RptMasterDetail.zip   inflating: RptMasterDetail/src/rptmasterdetail/FormReport.java   inflating: RptMasterDetail/src/rptmasterdetail/FormReport.form   inflating: RptMasterDetail/src/rptmasterdetail/Main.java   inflating: RptMasterDetail/nbproject/private/private.xml   inflating: RptMasterDetail/nbproject/private/private.properties   inflating: RptMasterDetail/nbproject/project.properties   inflating: RptMasterDetail/nbproject/project.xml   inflating: RptMasterDetail/nbproject/build-impl.xml   inflating: RptMasterDetail/nbproject/genfiles.properties   inflating: RptMasterDetail/Report/RptDetail.jasper   inflating: RptMasterDetail/Report/RptMaster.jrxml   inflating: RptMasterDetail/Report/RptDetail.jrxml extracting: RptMasterDetail/Report/netbeans_logo.gif   inflating: RptMasterDetail/Report/RptMaster.jasper   inflating: RptMasterDetail/manifest.mf   inflating: RptMasterDetail/build.xml [martin@opensolarisbox:~/jrbeans]$

5.[3.] kemudian bukalah file RptMaster.jrxml dan RptDetail.jrxml yang terdapat pada direktori RptMasterDetail/Report/ pada iReport seperti gambar dibawah ini :

6. Sekarang coba jalankan report tersebut dari iReport dengan menggunakan Active Connection (buatlah dahulu datasourcenya dengan menggunakan JDBC Connection dan arahkan databasenya ke rptmasterdetail) hingga tampilannya menjadi seperti gambar dibawah ini :

Note: Usahakan report berjalan dengan sukses sampai langkah ini, jika belum berjalan dengan benar silahkan cek ulang lagi mungkin ada konfigurasi yang terlewati.

7. Setelah berhasil menjalankan report dengan JDBC Connection sekarang saatnya untuk merubah report kita agar menggunakan JRBeanCollection sebagai datasourcenya, nah agar report kita menggunakan JRBeanCollection kita harus melakukan beberapa modifikasi yang harus dilakukan yaitu :

1. Modifikasi Pada File RptMaster.jxml Hapus Synxtax Query

Bukalah file RptMaster.jrxml kemudian pilih menu Data > Report Query kemudian hapuslah query SELECT * FROM T_KATEGORI T_KATEGORI WHERE kd_Kategori = $P{PRM_KD_KATEGORI} hingga tampilannya menjadi seperti gambar dibawah ini :

Proses query ini akan diganti dari kode Java kita

Hapus Parameter PRM_KD_KATEGORI

Untuk menghapus parameter PRM_KD_KATEGORI pilihlah menu View > Parameter kemudian hapuslah parameter tersebut hingga menjadi seperti gambar dibawah ini :

PRM_KD_KATEGORI sudah tidak diperlukan lagi jika menggunakan JRBeanCollectionDataSource

Buat Parameter Untuk Menampung Detail Report

Buatlah sebuah parameter dengan tipe java.util.Collection untuk menampung data detail report dengan cara memilih menu View > Parameter kemudian pada jendela Parameters tekanlah tombol New untuk menambahkan sebuah parameter baru. Setelah itu pada jendela Add/Modify Parameters isikanlah sebagai berikut :

Parameter Name PRM_DETAIL_VALUE Parameter Class Type java.util.Collection

seperti gambar dibawah ini :

Parameter ini digunakan untuk menampung detail report

Ganti Connection/Data Source Expression

Klik kanan pada Sub Report kemudian pilihlah Properties, pada dialog yang terbuka pilihlah tab Subreport kemudian gantilah Connection/Data Source Expression-nya menjadi seperti gambar dibawah ini:

Mengganti Data Source Agar Menggunakan JRBeanCollectionDataSource

Hapus Sub Report Parameter

Hapuslah juga Sub Report Paremeter dengan cara klik kanan pada Sub Report kemudian pilih Properties, pada dialog yang terbuka pilihlah tab Sub Report (Other) kemudian hapuslah parameter PRM_DETAIL_KDKATEGORI hingga menjadi seperti gambar dibawah ini:

Hapus Subreport Parameter

Ganti Parameter Class Type Pada Parameter SUBREPOT_DIR

Gantilah Parameter Class Type pada parameter $P{SUBREPORT_DIR} dengan cara memilih menu View > Parameters kemudian pilihlah parameter SUBREPORT_DIR lalu tekan tombol Modify. Setelah jendela Add/Modify Parameter tampil, sekarang gantilah Parameter Class Type dari java.lang.String ke java.io.InputStream seperti gambar dibawah ini :

Ganti Parameter Class Type

Ganti Subreport Expression Class

Setelah melakukan langkah diatas, kita juga harus memodifikasi Subreport Expression Class agar Detail Report kita bisa diakses dari Master Report. Caranya yaitu klik kanan pada Sub Report kemudian pilih Properties, pada dialog yang terbuka pilihlah tab Sub Report (Other) kemudian ganti Subreport Expression Class dari java.lang.String ke java.io.InputStream kemudian hapuslah kalimat + “RptDetail.jasper” menjadi seperti gambar dibawah ini :

Ganti Subreport Expression Class

Proses modifikasi file RptMaster.jrxml sudah selesai, sekarang mari kita lanjutkan dengan memodifikasi file RptDetail.jrxml

2. Modifikasi Pada File RptDetail.jrxml Hapus Syntax Query

Bukalah file RptDetail.jrxml kemudian pilih menu Data > Report Query kemudian hapuslah query SELECT T_BARANG.kd_Barang, T_BARANG.nm_Barang FROM T_BARANG, T_KATEGORI WHERE T_BARANG.kd_Kategori = $P{PRM_DETAIL_KDKATEGORI} GROUP BY

T_BARANG.kd_Barang hingga menjadi seperti gambar dibawah ini:

Hapus Parameter PRM_DETAIL_KDKATEGORI

Untuk menghapus parameter PRM_KD_KATEGORI pilihlah menu View > Parameter kemudian hapuslah parameter tersebut hingga menjadi seperti gambar dibawah ini :

8. Akhirnya selesai juga proses modifikasi file RptMaster.jrxml dan RptDetail.jrxml, sekarang mari kita buat sebuah project untuk memanggil report yang sudah menggunakan JRBeansCollectionsDataSource

9. Menggunakan JRBeansCollections Sebagai DataSourceLangkah selanjutnya yaitu adalah buatlah sebuah project dengan nama porting-report-beans-collection kemudian buatlah beberapa package yaitu portingreportbeanscollection.domain, portingreportbeanscollection.report, portingreportbeanscollection.service, portingreportbeanscollection.service.impl seperti gambar dibawah ini :

Sekarang kopikan file RptMaster.jrxml dan RptDetail.jrxml yang terdapat pada direktori RptMasterDetail/Report/ kedalam packages portingreportbeanscollection.report hingga tampilannya menjadi seperti gambar dibawah ini :

Sekarang buatlah 2 buah Domain Class pada packages portingreportbeanscollection.domain yaitu Barang dan Kategori seperti dibawah ini :

123456

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package portingreportbeanscollection.domain; /**

789101112131415161718

* * @author martin */ public class Barang {     private Integer idBarang;     private String kd_Barang;     private String kodeKategori;     private String nm_Barang;     // Generate Getter and Setter via ALT+INSERT }

1234567891011121314151617181920

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package portingreportbeanscollection.domain; import java.util.List; /** * * @author martin */ public class Kategori {     private String kd_Kategori;     private String nm_Kategori;     private List<barang> listBarang;     // Generate Getter and Setter via ALT+INSERT }

Buatlah sebuah Interface pada packages portingreportbeanscollection.service dengan nama IMaster dengan isi seperti dibawah ini :

12345678910

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package portingreportbeanscollection.service; import portingreportbeanscollection.domain.Kategori; /** * * @author martin */

1112131415161718

public interface IMaster {     public Kategori findKategoriByKode(String prmKodeKategori); }

Setelah selesai membuat Interface, sekarang buatlah sebuah Implementation dari Interface yang telah kita buat pada packages portingreportbeanscollection.service.impl seperti dibawah ini :

123456789101112131415161718192021222324252627282930313233

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package portingreportbeanscollection.service.impl; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; import java.util.ArrayList; import java.util.List; import java.util.logging.Level; import java.util.logging.Logger; import portingreportbeanscollection.domain.Barang; import portingreportbeanscollection.domain.Kategori; import portingreportbeanscollection.service.IMaster; /** * * @author martin */ public class IMasterImpl implements IMaster {     private Connection connection;     private PreparedStatement sqlSearchKategoriByKode;     private final String qrySearchKategoriByKode =             "select * from T_BARANG, T_KATEGORI where " +             "T_KATEGORI.kd_Kategori = T_BARANG.kd_Kategori " +             "AND T_KATEGORI.kd_Kategori = ?";     public IMasterImpl(Connection connection) {         try {             this.connection = connection;             sqlSearchKategoriByKode = this.connection.prepareStatement(qrySearchKategoriByKode);         } catch (SQLException ex) {

34353637383940414243444546474849505152535455565758596061626364656667686970

            Logger.getLogger(IMasterImpl.class.getName()).log(Level.SEVERE, null, ex);         }     }     public Kategori findKategoriByKode(String prmKodeKategori) {         Kategori resultKategori = new Kategori();         try {             sqlSearchKategoriByKode.setString(1, prmKodeKategori);             ResultSet rs = sqlSearchKategoriByKode.executeQuery();             List<barang> listBarang = new ArrayList<barang>();             while (rs.next()) {                 resultKategori.setKd_Kategori(rs.getString("kd_Kategori"));                 resultKategori.setNm_Kategori(rs.getString("nm_Kategori"));                 /* Ambil object barang */                 Barang b = new Barang();                 b.setIdBarang(rs.getInt("id_Barang"));                 b.setKd_Barang(rs.getString("kd_Barang"));                 b.setNm_Barang(rs.getString("nm_Barang"));                 b.setKodeKategori(rs.getString("kd_Kategori"));                 /* Masukkan ke dalam list of barang */                 listBarang.add(b);             }             /* Tambahkan list of barang ke dalam object kategori */             resultKategori.setListBarang(listBarang);         } catch (SQLException ex) {             Logger.getLogger(IMasterImpl.class.getName()).log(Level.SEVERE, null, ex);         }         return resultKategori;     } }

Setelah semua selesai, sekarang tambahkanlah dahulu library MySQL JDBC Driver dan beberapa library untuk jasper report sehingga hasil akhir dari struktur project kita terlihat

seperti gambar dibawah ini :

Ok sekarang setelah semua persiapan dan konfigurasi telah selesai, sekarang mari kita modifikasi file Main.java hingga menjadi seperti dibawah ini :

1234567891011121314

/* * To change this template, choose Tools | Templates * and open the template in the editor. */ package portingreportbeanscollection; import com.mysql.jdbc.jdbc2.optional.MysqlDataSource; import java.sql.SQLException; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import java.util.logging.Level; import java.util.logging.Logger; import net.sf.jasperreports.engine.JRException;

15161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960

import net.sf.jasperreports.engine.JasperCompileManager; import net.sf.jasperreports.engine.JasperFillManager; import net.sf.jasperreports.engine.JasperPrint; import net.sf.jasperreports.engine.JasperReport; import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource; import net.sf.jasperreports.view.JasperViewer; import portingreportbeanscollection.domain.Barang; import portingreportbeanscollection.domain.Kategori; import portingreportbeanscollection.service.IMaster; import portingreportbeanscollection.service.impl.IMasterImpl; /** * * @author martin */ public class Main {     /**      * @param args the command line arguments      */     public static void main(String[] args) {         try {             MysqlDataSource dataSource = new MysqlDataSource();             dataSource.setServerName("localhost");             dataSource.setDatabaseName("rptmasterdetail");             dataSource.setUser("root");             dataSource.setPassword("admin");             final IMaster imaster = new IMasterImpl(dataSource.getConnection());             Kategori k = imaster.findKategoriByKode("HAAP");             if (k != null) {                 System.out.println("Kode : " + k.getKd_Kategori());                 System.out.println("Nama : " + k.getNm_Kategori());                 System.out.println("JmlBrg: " + k.getListBarang().size());                 for (Barang b : k.getListBarang()) {                     System.out.println("ID : " + b.getIdBarang() + " KODE : " + b.getKd_Barang() + " NAME : " + b.getNm_Barang());                 }                 List<kategori> listKategori = new ArrayList<kategori>();                 listKategori.add(k);                 /* Sudah mendapat object Kategori beserta data barangnya,                  * sekarang siapkan parameter untuk reportnya */                 Map<string, Object> parameter = new HashMap<string, Object>();                 /* Sekarang tidak perlu lagi mencari report path, report bisa                  * dicemplungin ke dalam jar sekalian ^_^ */                 parameter.put("SUBREPORT_DIR",                         Main.class.getResourceAsStream(                         "/portingreportbeanscollection/report/RptDetail.jasper"));                 /* Mengisi detail report */

61626364656667686970717273747576777879808182838485868788

                parameter.put("PRM_DETAIL_VALUE", k.getListBarang());                 /* Proses compilasi report */                 JasperReport jp = JasperCompileManager.compileReport(                     Main.class.getResourceAsStream(                     "/portingreportbeanscollection/report/RptMaster.jrxml"));                 /* Proses pengisian report dengan data */                 JasperPrint jasperPrint = JasperFillManager.fillReport(jp, parameter,                     new JRBeanCollectionDataSource(listKategori));                 /* Sudah semua? Maka tampilkan :) */                 JasperViewer.viewReport(jasperPrint);             }         } catch (JRException ex) {             Logger.getLogger(Main.class.getName()).log(Level.SEVERE, null, ex);         } catch (SQLException ex) {             Logger.getLogger(Main.class.getName()).log(Level.SEVERE, null, ex);         }     } }

Nah sekarang kalau sudah, mari kita tambahkan custom ant task yang fungsinya melakukan proses kompilasi report ketika kita mengcompile source code java kita dan menghapus file-file *.java, bak dan jasper ketika kita melakukan proses clean di NetBeans IDE. Untuk mengkonfigurasi NetBeans agar dapat melakukan proses otomatis seperti diatas, langkah yang harus kita lakukan adalah bukalah file build.xml kemudian tambahkanlah baris dibawah ini pada file build.xml:

12345678910

    <path id="report.classpath">         <fileset dir="/export/home/martin/MASTER_APP/iReport-3.0.0/lib" includes="**/*.jar" />         <pathelement location="Report" />     </path>     <taskdef name="jrc" classname="net.sf.jasperreports.ant.JRAntCompileTask">         <classpath refid="report.classpath" />     </taskdef>     <target name="-post-clean">         <delete verbose="true">

11121314151617181920212223242526

            <fileset dir="./src/portingreportbeanscollection/report/" includes="**/*.jasper" />             <fileset dir="./src/portingreportbeanscollection/report/" includes="**/*.bak" />             <fileset dir="./src/portingreportbeanscollection/report/" includes="**/*.java" />         </delete>     </target>     <target name="-pre-compile">          <jrc srcdir="./src/portingreportbeanscollection/report/"              destdir="./src/portingreportbeanscollection/report/"              tempdir="./src/portingreportbeanscollection/report/"              keepjava="false"              xmlvalidation="true">                  <include name="**/*.jrxml"/>         </jrc>     </target>

Dan jika kita melakukan proses Clean and Build di NetBeans IDE, maka tampilan outputnya akan tampak seperti dibawah ini :

123456789101112131415161718192021222324

init: deps-clean: Deleting directory /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/build Deleting directory /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/dist Deleting /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/src/portingreportbeanscollection/report/RptDetail.jasper Deleting /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/src/portingreportbeanscollection/report/RptMaster.jasper clean: init: deps-jar: Created dir: /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/build/classes Compiling 2 report design files. File : /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/src/portingreportbeanscollection/report/RptDetail.jrxml ... OK. File : /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/src/portingreportbeanscollection/report/RptMaster.jrxml ... OK.

Created dir: /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/build/empty Compiling 5 source files to /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/build/classes Copying 4 files to /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/build/classes compile: Created dir: /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/dist Building jar: /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/dist/porting-report-beans-collection.jar Copy libraries to /export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/dist/lib. To run this application from the command line without Ant, try: java -jar "/export/home/martin/OSS/GOOGLE_CODE/martin-personal-project/java/porting-report/porting-report-beans-collection/dist/porting-report-beans-collection.jar" jar: BUILD SUCCESSFUL (total time: 6 seconds)

Jika sudah selesai, sekarang coba jalankan dengan menekan tombol F6 pada NetBeans IDE. Dan jika tidak ada pesan error maka harusnya report akan tampil seperti gambar dibawah ini :

Hasil Akhir Report Menggunakan JRBeanCollection Sebagai Data Source

Nah mudah bukan ?? Point of View yang ingin disampaikan pada tulisan kali ini adalah :- Jika ingin menggunakan JRBeanCollection sebagai data source-nya, pastikan dahulu report sudah berjalan dengan baik menggunakan JDBC data source.- Usahakan nama field pada report (*.jrxml) harus sama dengan nama Domain Class yang kita buat.- Jika sudah menggunakan JRBeanCollection, apapun persistence layernya harusnya sudah tidak begitu bermasalah. Karena yang kita kirimkan ke dalam Jasper Report sudah berbentuk List Of Domain Object, jadi usahakan agar kita bisa menampilkan data terlebih dahulu (via System.out.println()) baru kemudian kirimkan hasilnya ke jasper report.

Link-link terkait :- Membuat Master Detail Report dengan iReport- Download Sample Project MasterDetailRptJRBeansCollections.zip- Subversion access Sample Project MasterDetailRptJRBeansCollections