jasperreportapi介紹-資料下載頁(yè)
【導(dǎo)讀】數(shù)，處理來(lái)自不同源來(lái)的數(shù)據(jù)，并轉(zhuǎn)化為各種不同的形式來(lái)輸出。這個(gè)類可以完成將由報(bào)表填充進(jìn)程產(chǎn)生的文檔直接輸出為需要的。在webapp這個(gè)例子中，有這種形式。的類，利用組件來(lái)顯示例子。的，可以用來(lái)方便調(diào)試。有的時(shí)候，可能想在提交的相應(yīng)的處理進(jìn)程之前，手動(dòng)加載這些序列化的對(duì)象。這個(gè)類可以從不同的源，如文件、Url、以及輸入流中加載序列化的對(duì)象。如果沒(méi)有，則解析成File，如果fail，則從classpath中尋找一個(gè)相應(yīng)的資源，如果還沒(méi)有，那就只好拋出異常啦。，這里是主要的部分啦！時(shí)指定要使用的解析器。里的一個(gè)createXMLReader()方法。這就需要在運(yùn)行時(shí)，給SAX指定的java系統(tǒng)屬性。有兩種方法可以完成這個(gè)工作，我們這里會(huì)利用XercesXMLparser來(lái)示例。為了生成一個(gè)報(bào)表，必須要先建立一個(gè)report''''sdesign，可以通過(guò)編輯一。在這里我們主要用XML的方式來(lái)做。這樣可以修改xml之后，點(diǎn)擊reload就可以立即看到改變。輸出是一個(gè)單個(gè)的文件，已經(jīng)可以view了。輸出一般和輸入是同一個(gè)類型。reportdesign,然后輸出到一個(gè)在硬盤(pán)上的文檔中。
【正文】 ELEMENT defaultValueExpression (PCDATA) 定義一個(gè)變量很簡(jiǎn)單： parameter name=ReportTitle class=/只要指定其名稱和類就可以了 Parameter Name Parameter Class Prompting for Parameter Values，在報(bào)表出來(lái)之前，可能會(huì)要用戶輸入一些信息，然后根據(jù)這些信息來(lái)生成報(bào)表，所有就有了 isForPrompting 這個(gè)屬性， 然后再 parameterDescription里面指定一些信息，例如： parameter name=Comments class= isForPrompting=true parameterDesciption ![CDATA[ Please type here the report ments if any ]] /parameterDesciption /parameter Parameter Default Value 參數(shù)值是通過(guò) 類型的對(duì)象傳遞給報(bào)表填充進(jìn)程的，如果不給某個(gè)Key賦值，那么默認(rèn)的 null，但是如果想給默認(rèn)的值的話， 可以用來(lái)指定 defaultValueExpression，例如： parameter name=MyDate class= defaultValueExpression new () /defaultValueExpression /parameter Builtin Report Parameters Parameter REPORT_PARAMETERS_MAP，這個(gè) builtin parameter 會(huì)一直指向用戶傳遞的 類型的對(duì)象，這 個(gè)在想子報(bào)表使用一些父報(bào)表的參數(shù)的時(shí)候很有用。 Parameter REPORT_CONNECTION，指向一個(gè) 類型的對(duì)象，這個(gè)對(duì)象是用戶傳遞給 engine 的來(lái)通過(guò) JDBC 執(zhí)行 SQL 查詢；只有在 report 真的收到了一個(gè) 用來(lái)填充數(shù)據(jù)的 而且不是一個(gè) 實(shí)例的時(shí)候，才不為空。否則是空的。這個(gè)也是在子報(bào)表中很有用。 Parameter REPORT_DATASOURCE，指向數(shù)據(jù) 填充時(shí)用的數(shù)據(jù)源。 Parameter REPORT_SCRIPTLET，即使不用 scriplet 的時(shí)候，也指向一個(gè)Parameter REPORT_SCRIPTLET 的實(shí)例；但當(dāng)用到了 scriplet 的時(shí)候，則指向在數(shù)據(jù)填充時(shí)的 scriptlet classs 實(shí)例， 在 scriptlet 例子中有介紹，可以用來(lái)調(diào)用特定的方法、復(fù)制或使用在數(shù)據(jù)填充時(shí) scriplet 準(zhǔn)備的數(shù)據(jù)。 Data Source 在填充數(shù)據(jù)時(shí)， JasperReport 遞代數(shù)據(jù)， 接口很簡(jiǎn)單，要繼承它的話，只要實(shí)現(xiàn)兩個(gè)方法， public boolean next() throws JRException。和 public Object getFieldValue(JRField jrField) throws JRException。 從數(shù)據(jù)源得到數(shù)據(jù)的唯一方法是通過(guò) “report fields” 。 有很多實(shí)現(xiàn)，下面來(lái)分別看看： Class ， 用來(lái)包裝 類型的對(duì)象。在例子 like jasper, scriptlet, subreport and query 中可以看到。 通常是自動(dòng)調(diào)用的，當(dāng)要手動(dòng)的時(shí)候，還要自己包裝一個(gè) 類型的對(duì)象，用一個(gè)數(shù)據(jù)源類的實(shí)例，在數(shù)據(jù)填充之前。 在使用這種類型的數(shù)據(jù)源時(shí)，最重要的一點(diǎn)是要對(duì) ResultSet 中的每一個(gè)列都聲明一個(gè) report field，并且 report field 的名字和類型都要和 ResultSet 中的相同。 “ 這樣好像是錯(cuò)誤的?。。。?為了最大的可能性，可以對(duì)數(shù)據(jù)庫(kù)中的每個(gè)列都對(duì)應(yīng)聲明一個(gè) report field” Class ，前面提過(guò)，例如 fonts, images, shapes and unicod 等都需要 Class ，用來(lái)包裝 類型的對(duì)象。有兩種方法來(lái)使用這種對(duì)象， 通常要從它得到數(shù)據(jù)，要聲明對(duì) 對(duì)象里面的每個(gè)列都聲明一個(gè) report field。另一種方法是利用 index,例如知道要取得數(shù)據(jù)在 index=2 的位置， 則可以用 COLUMN_2來(lái)訪問(wèn)，在 datasource 中有例子。 Class ，包裝 an array of JavaBeans，然后利用 reflection 來(lái)取得 report field 值， 一個(gè) JavaBean 代表這種數(shù)據(jù)源的一條記錄，例如有一個(gè) report field 名字是ProductDescription，那么在取得值的時(shí)候，程序會(huì)默認(rèn)的調(diào)用getProductDescription()來(lái)取得它的值。 如果是 boolean 的值，則還可以調(diào)用 is 前綴。在 datasource 例子里也有。 Class ，這個(gè)和前一個(gè)很類似，但是它包裝的是 類型的對(duì)象。
鄂ICP備17016276號(hào)-1