海鷗航際

現在很多公司和個人都在使用iReport制作報表模板，我接觸的時間也不長，在這里，我將我在實踐過程中的一些經驗以及碰到的一些問題和大家一起來探討。

一、iReport介紹
說到iReport不得不先介紹Jasperreport，Jasperreport是一個報表制作程序，用戶需要按照它制定的規則編寫一個XML文件，然后得到用戶需要輸出的格式文件。它支持輸出的文件格式包括PDF,HTML,XML,XLS,CVS等等。而iReport就是一個制作Jasperreport的XML文件的可視化開發工具。

二、模板制板
首先必須下載一個iRport（地址：http://ireport.sourceforge.net），現在的最高版是0.4.0，我們這里使用的是0.2.2。

將iReport解壓縮以后編輯目錄下的iReport.bat文件即可，如下

@echo off

set JAVA_HOME=C:\j2sdk1.4.0_03
set ANT_HOME=C:\ant
set IREPORT_HOME=C:\Documenti\progetti\iReport\iReport2\

rem %ANT_HOME%\bin\ant javadocs
%ANT_HOME%\bin\ant iReport

只要設置相應的一些路經就可以，這里是采用ant來運行，當然如果你沒有安裝ant也不想安裝它，那么也可以，找到noAnt文件夾下的startup.bat文件即可運行。

建立新模板時，便得到如圖所示的界面。

選中菜單項"Datatsource"，單擊其子菜單項"Connection/Datasources"，便會彈出一個編輯框，選擇"New"按鈕，

輸入數據源名稱，選擇JDBC Driver，在輸入JDBC URL時，可以點擊"Wizard"按鈕，它會根據你選的JDBC Driver配置好你的URL，不過得修改IP地址以及DatabaseName，輸入數據庫名、用戶名、密碼。點擊"Test"按鈕，確定連接情況，然后保存。

下圖是我做好的一個報表模板：

$F{}是用來標明這是數據庫字段。$F{WINDOWS_NAME}、$F{NUMBER}、$F{vname}、$F{SP_NAME}和$F{SP_TYPE}是數據庫里的字段，也是我要在模板里用到的字段。對于$F{NUMBER}、$F{vname}、$F{SP_NAME}和$F{SP_TYPE}這四個字段，雖然放在其他域也可以顯示出結果，比如：pageHeader域、columnHeader域、columnFooter域等等，但是因為會有多列的數據要顯示，所以必須放到"detail"域中。

模板畫完了，現在來配置模板的查詢語句，以及字段、變量和參數。

首先輸入查詢語句，如"select * from v_baseinfo_statbanjiereport"，點擊"Read fields"按鈕，會查詢出該表的所有字段名

如果您要有條件的查詢，那么就在后面添加Where語句，如"select * from v_baseinfo_statbanjiereport where DEPT_NAME=$P{orgname} and END_SP_DAY=$P{etime}"，點擊"Save query to report"按鈕保存。

這里要提醒大家注意的是，您可以直接把參數寫入Where語句中，象這樣"where DEPT_NAME='中國' and END_SP_DAY='2004-11-23'"；但是從java程序或者jsp頁面傳過來的參數是中文字符的話，您就必須做編碼轉換或者用英文字符、數字來代替；還有像日期參數"2004-11-23"，jasperreports好象解析不了，如果你把SQL語句改成" select * from v_baseinfo_statbanjiereport where DEPT_NAME='$P{orgname}' and END_SP_DAY='$P{etime}'"，那么又會拋出異常，因為Jasperreport會先把SQL語句設置成預編譯語句"select * from v_baseinfo_statbanjiereport where DEPT_NAME=？and END_SP_DAY=？"，所以SQL語句中用到參數的時候，除了其特定的"$P{}"符號外，不能有別的標點符號，傳進去的參數值也盡量不要帶標點符號，所以日期格式得改成"20041123"。

設置模板字段：

設置模板參數：

當這些全部做完后，點擊"Save"按鈕，就會生成一個XML文件，再點擊"Compile"按鈕，就會生成一個后綴名為jasper的文件。

現在可以預覽一下模板的效果，先選擇菜單項"Build"的子菜單項"PDF preview"、"HTML preview"、"JAVA 2D preview"、"Excel preview"、"CSV preview"和"JRViewer preview"中的一項（對這些項顯示工具的配置在菜單項Tools\Options..下的External programs）， 再點擊"Execute report"；如果你想帶數據預覽，還得先激活一下剛配置的數據源，選中菜單欄"Build"下的子菜單欄"Set active connection"，會彈出一編輯框，選中一個數據源名稱，點擊"OK"。

此時我們就要引入一個jsp頁面，假設是pdf.jsp，那么下面就是pdf.jsp的代碼：

<%@ page import="dori.jasper.engine.*" %>
<%@ page import="java.util.*" %>
<%@ page import="java.io.*" %>
<%@ page import="java.sql.*" %>
 
<%
	File reportFile = new File(application.getRealPath("/reports/ribanjietongji.jasper"));
 
	Map parameters = new HashMap();
	parameters.put("orgname", "zhongguo");
	parameters.put("etime", "20041123");
	Connection conn=null
	
	//以下忽略得到數據庫連接過程
//……
		
	byte[] bytes = 
		JasperRunManager.runReportToPdf(
			reportFile.getPath(), 
			parameters, 
			conn
			);
	
	response.setContentType("application/pdf");
	response.setContentLength(bytes.length);
	ServletOutputStream ouputStream = response.getOutputStream();
	ouputStream.write(bytes, 0, bytes.length);
	ouputStream.flush();
	ouputStream.close();
%>

程序里面要和大家說明的就是，"/reports/test.jasper"這個路徑是相對于你這個jsp頁面的，比如你的jsp頁面保存在D:\\..\ROOT\目錄下，那么你就必須在這個目錄下建一個report目錄，然后把你做好的報表模板文件放到該目錄下來。

		Map parameters = new HashMap();
	parameters.put("orgname", "zhongguo");
	parameters.put("etime", "20041123");
	

"orgname"和"etime"必須和模板時定義的參數名稱一致。

三、結束語
到此整個模板就算完成了，有什么沒有說明白或者錯誤的地方，希望你能和我一起來討論。