ireport教程之柱形圖的開發實現方法，本文介紹ireport中柱形圖的具體開發實現方法。
工具/原料
ireport
方法/步驟
下面以柱狀圖（bar3DChart）為例，詳細說明圖表的開發過程。
1. 確定資料來源型別和其中引數
我選擇的是JRDataSourceProvider型別的資料來源。我也試過JDBC資料來源，沒問題，只是我的應用需求是要根據使用者的選擇展示，所以用JRDataSourceProvider更靈活和方便些，不必每次選擇都去查資料庫。
用iReport開發圖表，在定義圖表屬性中的資料時，需要新增category series，一個category series中包括series expression、category expression、Value expression、label expression等。當我開始看到這些東西時，真的時搞不明白是什麼意思。試來試去，基本上弄清楚了，關鍵是前3個，Value expression很明白是指資料的值，category expression代表分組，series expression則代表分組中的不同指標。舉例說明：我公司的一款資料產品銷往全國各地的不同電信運營商，圖表要按地區展示各運營商的產品套數，那麼這裡的地區就是category expression，運營商就是series expression，Value expression就是產品的套數了。
於是圖表資料來源的引數有3個就夠了，即category、series和value。其他一些圖表可能情況略有不同，如餅圖（piechart），xylinechart等，如要做的通用些，可再加入些其他引數。我這裡有3個足夠了。
2. 開發資料來源類
首先定義一個使用者圖表的bean：ChartDataBean，包括3個成員變數及相應的getter和setter。3個成員變數的名稱如前所述，無論圖表要顯示什麼樣的資料，都按這3個變數進行對應並賦值即可。這樣的名稱也與iReport中圖表的資料相對應，不至於搞錯。如下：
public class ChartDataBean {
String serieas;
String category;
float value;
public String getCategory() {
return category;
}
public void setCategory(String category) {
this.category = category;
}
public String getSerieas() {
return serieas;
}
public void setSerieas(String serieas) {
this.serieas = serieas;
}
public float getValue() {
return value;
}
public void setValue(float value) {
this.value = value;
}
}
然後定義一個ChartDataSource類，該類應用了JRDataSource介面。該類用於在生成圖表時將資料傳入。如下：
public class ChartDataSource implements JRDataSource {
private int m_nldx;
private Vector
public ChartDataSource(){
this(new Vector
}
public ChartDataSource(Vector
this.m_nldx=-1;
this.v=v;
}
public Object getFieldValue(JRField arg0) throws JRException {
Object o = null;
String sName = arg0.getName();
ChartDataBean resultset = v.elementAt(m_nldx);
if(resultset == null)
return null;
if(sName.equals("serieas"))
o =resultset.getSerieas();
else if(sName.equals("category"))
o = resultset.getCategory();
else if(sName.equals("value"))
o = resultset.getValue();
return o;
}
public boolean next() throws JRException {
// TODO Auto-generated method stub
m_nldx ++;
return (m_nldx < v.size());
}
}
最後定義一個ChartDataSourceProvider類，該類繼承類JRAbstractBeanDataSourceProvider，如下：
public class ChartDataSourceProvider extends JRAbstractBeanDataSourceProvider {
public ChartDataSourceProvider(Class arg0) {
super(arg0);
// TODO Auto-generated constructor stub
}
public ChartDataSourceProvider() {
super(ChartDataBean.class);
// TODO Auto-generated constructor stub
}
public JRDataSource create(JasperReport arg0) throws JRException {
// TODO Auto-generated method stub
ChartDataSource ds=new ChartDataSource(getQueryResult());
return ds;
}
public void dispose(JRDataSource arg0) throws JRException {
// TODO Auto-generated method stub
}
public static Vector
Vector
ChartDataBean result = new ChartDataBean();
result.setCategory("北京");
result.setSerieas("聯通");
result.setValue(1500);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("北京");
result.setSerieas("電信");
result.setValue(1600);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("北京");
result.setSerieas("移動");
result.setValue(2000);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("上海");
result.setSerieas("聯通");
result.setValue(1900);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("上海");
result.setSerieas("電信");
result.setValue(600);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("上海");
result.setSerieas("移動");
result.setValue(1200);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("天津");
result.setSerieas("聯通");
result.setValue(900);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("天津");
result.setSerieas("電信");
result.setValue(800);
vector.addElement(result);
result = new ChartDataBean();
result.setCategory("天津");
result.setSerieas("移動");
result.setValue(1400);
vector.addElement(result);
return vector;
}
}
以上getQueryResult（）方法中加入了一些資料用於在iReport開發中測試預覽用。實際上我認為，ChartDataSourceProvider類只是為iReport設計時從資料來源中提取field資訊而用的，在報表生成過程中並不會用到該類。
3. 圖表設計
在前面工作的基礎上，我們就可以利用iReport進行圖表開發了。
首先新建一個報表檔案，檔名最好能反應報表的內容，如bar3DChart；
然後定義報表資料來源，在定義資料來源前要先設定class path，通過選單option->classpath，在classpath對話方塊中點選Add Folder，將你前面開發資料來源類的java工程中放置編譯後的.class檔案的目錄新增到classpath列表中，如我的是web工程，class的目錄是D:\Myprj\prj1\WebRoot\WEB-INF\classes;
新增一個新資料來源，通過選單data->connection/datasource，開啟connection/datasource，點選new按鈕，在connection properties對話方塊中選擇JRDataSourceProvider，點選next按鈕，在新開啟的對話方塊中有兩個輸入項：name和jasperreports datasource provider class。Name可任意輸入，如：ChartDataSourceProvider；jasperreports datasource provider class則要輸入你前面定義的ChartDataSourceProvider類，一定要輸入全路徑類名，和你在java工程中的包名類名一致：如com.project1.report.chart. ChartDataSourceProvider，輸入完成後可點選test按鈕測試一下，如彈出Connection test successful！對話方塊則表明資料來源類新增成功，否則要檢查一下classpath是否正確設定。
注：這裡有個情況說明一下，如果ChartDataSourceProvider類是在iReport開啟後編譯的，那麼即使classpath設定正確，類名輸入也無問題，還是測試失敗。這時就必須將iReport關閉後再開啟，測試才會成功，資料來源才可用，我也不知道這是為什麼。這個問題在我剛開始用iReport時困擾了我一天，我新加了一個數據源，但怎麼都連不通，反覆檢查各種設定、路徑、名稱、大小寫等，就是不行，實在是莫名其妙呀！第二天上班，我開機後再試試，我什麼都沒改動，還是昨天那些東西，竟然連線成功了！我就琢磨了，是不是跟機器關開了一次有關係？機器一天都是開著的，下班才關，什麼都沒動，再開機問題就解決了？可也不能那麼邪乎吧，什麼東西做得非要重啟機器？於是經過幾次試驗我就發現：資料來源類在重新編譯後，必須重新啟動一次iReport。
注意要將新加的資料來源設為預設。
讀取Field，選單file->report query開啟report query對話方塊，在DataSource Provider屬性頁中點選Get fields from data source按鈕，下面的列表裡會出現field的列表，有serieas、category、value和class，多了個class，不去管他；點選ok；
下面設計圖表了。
在報表title或summary band中加入一個圖表工具（chart tool），在彈出的圖表選擇對話方塊中選擇bar 3D,並點選ok確定。將band和圖表調整至合適的大小；
雙擊bar 3D圖表，開啟bar3DChart對話方塊，在chart屬性頁中將Evaluation Time設為report（如選其他選項會出現我不想要的效果，我還沒去仔細琢磨），然後點選Edit chart properties按鈕，開啟chart properties對話方塊；
在chart properties對話方塊選擇Chart Data屬性頁，在Chart Data屬性頁中選擇Details屬性頁；
點選Add按鈕新增一個category series，在彈出的對話方塊的data屬性頁中有4個需要定義的表示式（expression），我們定義前3個。如Series Expression，可以通過點選右邊的按鈕開啟表示式編輯器，在編輯器下邊的objects and expression屬性頁中左邊第一個框中選Field，然後在第二個框中雙擊seriesas，在上邊的文字編輯區中就會出現表示式：$F{serieas}。點選應用按鈕（？我的iReport中顯示的是套用，我估計英文應該是apply，按咱們的習慣還是較應用吧）。其他兩個表示式如法炮製，結果應該是這樣的：series expression：$F{serieas}、category expression：$F{category}、Value expression：$F{value}、label expression：空白；點選ok；然後關閉chart properties對話方塊。
這時可以通過選單build->execute report(Using active conn.)來預覽圖表了。
至此，在iReport中的圖表設計工作完成。圖表在web工程中的部署、載入、展現等與報表的方法是一樣的。
4. 圖表部署
我用的web伺服器是tomcat5，假定web工程部署在webapps/myproject/中，在webapps/myproject/下新建一個目錄reports用來放置報表檔案。將前面iReport編譯生成的bar3DChart.jasper檔案放在該目錄下。.jasper檔案預設生成在iReport的安裝目錄下。
部署和生成報表所需的幾個jar包也要放到myproject/WEB-INF/lib下，這些jar包有：jasperreports-2.0.4、iReport、jfreechart-1.0.9、jcommon-1.0.12等。版本可能不太一樣。注意的是，iReport和jasperreport的圖表功能實際上是用了jfreechart工具來實現的，所以一定要將jfreechart的jar包匯入到工程中。
5. 圖表的生成和展示
開發servlet。我這裡以servlet方式生成圖表。Servlet如下：
public class ReportServlet extends BaseHttpServlet {
/** * */
public void service(
HttpServletRequest request,
HttpServletResponse response
) throws IOException, ServletException
{
PrintWriter out = response.getWriter();
try
{
HttpSession session = request.getSession(false);
//獲得圖表資料。圖表資料是在其他地方查表得到並生成Vector
Vector dataList = (Vector) session.getAttribute ("storedDataList");
//載入圖表，一定要指對路徑和檔名
File reportFile = new File(context.getRealPath ("/reports/bar3DChart.jasper"));
if (!reportFile.exists())
throw new JRRuntimeException("File WebappReport.jasper not found. The report design must be compiled first.");
JasperReport jasperReport = (JasperReport)JRLoader.loadObject(reportFile.getPath());
//圖表的引數，及ireport中的定義變數，如報表標題、圖表日期等，也是於他處設定儲存在session中
Map parameters =(Map)session.getAttribute
("jasper_parameters"); //這裡匯入圖表資料，並生成報表
JasperPrint jasperPrint =
JasperFillManager.fillReport(
jasperReport,
parameters,
new ChartDataSource(dataList)
);
//JasperPrint jasperPrint =(JasperPrint)session.getAttribute
//(ImageServlet.DEFAULT_JASPER_PRINT_SESSION_ATTRIBUTE);
//注：以上的步驟實際上都可以在他處完成，最後將jasperPrint儲存到session中，這樣在servlet中只需從session中取得jasperPrint即可(如上面註釋掉的這條語句)，可以將servlet做成通用的類來展示輸出所有的報表。
//輸出html 用JRHtmlExporter
JRHtmlExporter exporter = new JRHtmlExporter();
Map imagesMap = new HashMap();
response.setContentType("text/html");
request.getSession().setAttribute("IMAGES_MAP", imagesMap); request.getSession().setAttribute(ImageServlet.DEFAULT_JASPER_PRINT_SESSION_ATTRIBUTE, jasperPrint);
exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
exporter.setParameter(JRExporterParameter.OUTPUT_WRITER, out);
exporter.setParameter(JRHtmlExporterParameter.IMAGES_MAP, imagesMap); exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI,"image?image="); exporter.setParameter(JRHtmlExporterParameter.BETWEEN_PAGES_HTML, "");
exporter.exportReport();
}
catch (JRException e)
{
out.println("");
out.println("");
out.println("
out.println(" ");
out.println("");
out.println("");
out.println("JasperReports encountered this error :");
out.println("
");");e.printStackTrace();
out.println("
out.println("");
out.println("");
}
}
6. 新增servlet對映
在web.xml中新增如下設定：
ImageServlet幹嘛用的？注意到ReportServlet的程式碼中有這麼一句：
exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI,"image?image=");
ImageServlet就是為這句而來的，html方式輸出報表時要用到的小圖示就在這裡，如果沒有ImageServlet或設定不對，你可以看看輸出的報表是什麼樣的，盡是紅叉叉！
同為比較常用的java報表生成工具，FineReport對柱狀圖的解決方案和實現方法與ireport有所不同，具體實現思路和步驟如下，供ireport使用者借鑑：
在FineReport中，圖表有兩種插入方式：作為單元格元素插入或者作為懸浮元素插入，以下是用兩種思路實現柱形圖的過程：
單元格圖表
1. 描述
如下圖，每一組都跟隨有一個統計圖直觀的檢視該組的資料情況，可以使用單元格圖表實現這樣的可擴充套件的效果效果。
· 單元格圖表的優勢
圖表作為單元格元素插入到報表中，就可以通過單元格的父子關係，跟隨主格的擴充套件自動生成相應的圖表，而不需要對每組資料單獨製作對應的圖表。
2. 示例
以下我們詳細介紹上圖中跟隨擴充套件的圖表製作步驟。
2.1 資料準備
開啟報表%FR_HOME%\WebReport\WEB-INF\reportlets\doc\Primary\GroupReport\Group.cpt。在地區銷量分組報表的基礎上新增圖表，實現每個地區有一張銷量統計圖。
這邊擴展出來的每張圖表只顯示當前地區的資料，因此不能直接將資料集作為圖表資料來源（資料集是取出銷量表中的所有資料），只能使用報表中單元格資料。
注：單元格元素圖表與單元格資料來源圖表不是一個概念，單元格元素圖表是指圖表插入方式為單元格，可跟隨單元格擴充套件，擁有單元格的一些屬性，而單元格資料來源圖表是指圖表繫結資料的時候繫結的是單元格資料，而非資料集資料。
2.2 插入單元格圖表
合併第二行後面的一片區域，右擊單元格單元格元素>插入圖表>柱形圖，點選確定。
2.3 設定圖表資料
設定圖表資料如下圖，每個銷售員的銷量圖，點選完成：
2.4 設定圖表父格
由父子格概念可知，圖表所在單元格預設以銷售員資料列為父格，擴展出的每個銷售員都會對應有一張圖表；
而這裡我們只需要擴展出來的每個地區跟隨一張圖表，因此需要設定圖表所在單元格為地區單元格。
2.5 儲存並預覽
儲存模板並分頁預覽，便可以看到上圖效果了
懸浮元素圖表
圖表還可以作為懸浮元素插入到報表中。
· 懸浮圖表的優勢
作為懸浮元素插入到報表中的圖表，沒有單元格的限制，可以圖表位置固定，也可以隨意拖放到任何位置，大小設定後不會改變，沒有父格，不會因為其他單元格的擴充套件而受影響。
懸浮圖表的定義與單元格圖表是基本上完全相同的，只是在第一步插入圖表的時候，選擇摻入懸浮元素即可，這裡就不重複介紹了，可以看到，可以隨意拖動圖表及改變圖表大小，操作方便，如下圖：
注：懸浮元素做出來的圖表不同於上一節單元格圖表，能根據父格進行資料過濾，進行擴充套件從而根據地區顯示對應的柱形圖，懸浮元素沒有父格概念一說，故，其不能通過設定父格來進行資料過濾，進行擴充套件，添加了幾個懸浮元素圖表，最後在web端檢視的時候只會顯示幾個圖表。