JasperReports data source

前言
所謂的JasperReports data source，我們可以想像成是一個database，其內的資料依顆粒度大小，可以依序想像成table、record。本文會介紹四種JasperReports data source（可以想像成四種database），他們有各自的table和record格式，程式設計師可根據不同程式使用不同的data source。

版本
JasperReports和iReport版本為4.0.1。（本文發表時最新版本為4.0.2）

JREmptyDataSource
請想像成是一個空的database。當報表中不須要使用到任何的table和record時使用。例如報表中沒有detail band（不用顯示多筆records），又或者是報表中只需要顯示參數或變數，就可以使用JREmptyDataSource。以下是範例說明：

JasperReports/iReport中，Text Field的字串長度過長，如何自動斷行（換行），避免值被截斷

版本

JasperReports版本為4.0.1。

前言

有個報表設計如下，其中紅框處的Text Field其寬度為226。

此份報表的資料來源，包含了三筆記錄，其中有一筆記錄的ADDRESS為「大台南市永康區永元路123段456巷789弄876號543樓之21室」。如果報表不做任何設定，則產生出來的報表，這筆記錄的ADDRESS會被截斷成如下圖紅框處（之21室消失了）：

如何使用JasperReports加密PDF檔（How to produce encrypted PDF with JasperReports）

版本
JasperReports版本為4.0.1。

加密結果預覽

如何在JasperReports中製作分組（Group）加總

版本
JasperReports版本為4.0.1。

前言

因為本文的範例，有使用到Subreport，
所以如果閣下還不清楚如何製作Subreport，
請先閱讀如何在JasperReports中製作Subreport。

本文介紹分成二部份，分別是Java程式碼和iReport設計畫面。

報表預覽
在看程式碼和iReport設計畫面時，
先來看一下預期會產生的報表長相。

如何在JasperReports中製作Subreport

本文介紹分成二部份，分別是Java程式碼和iReport設計畫面。

JasperReports版本為4.0.1。

首先介紹Java程式碼。

製作Subreport（子報表）的方式之一，
是使用JRMapCollectionDataSource作為Subreport的data source（資料來源）
根據官方API文件，
JRMapCollectionDataSource建構子的參數為Collection，
所以，將資料放在List裡，List中的每一個元素，則用Map來存放，
因此，存放資料的Collection的結構為：


然後，將資料塞進這個list：


就可以把list放到JRMapCollectionDataSource中：


以上，可以想像成JRMapCollectionDataSource是Database，
List是Table，Map則是Record。

完整的程式碼如下：