在公司的項目中用JapserReport也做了不少報表了，現在也做個記錄吧，很多東西都從網上而來，總結一下而已。

注意：本文由 bangke 所撰寫 版權歸屬于bangke  轉載請注明出處

1.下載不說了，需要JapserReport和iReport，要pdf支持中文的話需要itextasian.jar(google!)
2.資源：The JasperReports Ultimate Guide.pdf(google!)
 http://jasperreports.sourceforge.net/
 http://plateau.sicool.com (good!)
 源代碼包下面的examples

3.先集中說一下中文支持問題：
   1）iReport中文顯示：去掉iReport lib目錄下的tinylaf.jar，會丑點兒：）
   2）要在pdf中顯示中文：如下圖設置字體或定義字體
      注意：在iReport中新建一個TextField會自動把pdf字體設為CP1252，需要修改，否則pdf輸出會報錯說找不到字體

4.明確需求：
  JasperReport(0.5.2)目前支持Tabular形式的報表，分組，子報表
  不支持cross report(交叉表）和單元格合并。

5.JasperReport簡述：
  JasperReport總的來說采用報表樣式和數據相分離的設計，在報表楊始中定義好和數據源的映射關系，然后在實際應用的時候再用數據源填充樣式得到最終的報表輸出。
  1）數據源：
  在JasperReport中可以定義多種數據源，都實現了dori.jasper.engine.JRDataSource接口。
  接口有兩個方法：
  public boolean next() throws JRException;
  public Object getFieldValue(JRField jrField) throws JRException;
  各個數據源簡介：
  dori.jasper.engine.JRResultSetDataSource封裝了一個java.sql.ResultSet
  dori.jasper.engine.JREmptyDataSource在沒有實際數據源的數據的時候可以使用它
  dori.jasper.engine.data.JRTableModelDataSource封裝了javax.swing.table.TableModel
  dori.jasper.engine.data.JRBeanArrayDataSource封裝了an array of JavaBeans and uses reflection to retrieve report field values.
  dori.jasper.engine.data.JRBeanCollectionDataSource封裝了java.util.Collection of JavaBeans，和上面的JRBeanArrayDataSource用法相像（強烈推薦，我一直都用它）
  簡而言之就是JRDataSource中封裝了一個循環的集合，在報表中一后會通過（屬性名）反射來取得每個數據項的內容
  為什么選擇JRBeanCollectionDataSource后面會解釋。

  構造數據源，采用數據工廠（針對JRBeanCollectionDataSource來說），工廠方法：
 

public static JRDataSource getJRDataSource(String name,HttpServletRequest request) throws Exception{
    InterCustomerDS ds = null;//InterCustomerDS是一個interface!
    try {
      ds = (InterCustomerDS) Class.forName(name).
          newInstance();
      ds.createDS(request);//這里需要request中的一些parameter來生成數據源
      return new JRBeanCollectionDataSource(ds.getBeanCollection());
    }
    catch (ClassNotFoundException ex) {
      throw new Exception(ex.getMessage());
    }
    catch (IllegalAccessException ex) {
      throw new Exception(ex.getMessage());
    }
    catch (InstantiationException ex) {
      throw new Exception(ex.getMessage());
    }

  }

  一個簡單的數據源需要兩個類，一個POJO，一個InterCustomerDS的實現

  POJO:

public class TestVO {
  private String portfolio;
  private String year;
  private String period;

  public CCSPVO() {
  }
  public String getPeriod() {
    return period;
  }
  public String getPortfolio() {
    return portfolio;
  }
  public String getYear() {
    return year;
  }
  public void setPeriod(String period) {
    this.period = period;
  }
  public void setPortfolio(String portfolio) {
    this.portfolio = portfolio;
  }
  public void setYear(String year) {
    this.year = year;
  }
 }
 

 TestDateSource:

public class TestDataSource implements InterCustomerDS {

  private Collection co;
  public CCSPDataSource() {
  }

  public void createDS(HttpServletRequest request) throws Exception{
    co=new ArrayList();
    /**//*
    這之中做數據庫查詢，然后使用查詢出來的結果生成TestVO，再把TestVO放入co中
    */
  }
  
  public Object[] getBeanArray() {
    return co.toArray();
  }

  public Collection getBeanCollection() {
    return co;
  }
}

  2）報表樣式：
  JasperReport將一張報表分為了幾個Sections，又叫bands(按照一張報表的內容來劃分的）：title, pageHeader, columnHeader, detail, columnFooter, pageFooter, summary, (如果有group的話，還有groupHeader和groupFooter)。用iReport畫報表的工作簡單得說就是把特定的內容放在特定的section中。
  title和summary在整個報表中只顯示一次（不過有個選項可以設置為每頁顯示一次）
  column和page是每頁顯示一次
  detail才是最關鍵的地方，循環顯示數據源的內容，直到全部顯示完為止。
  在樣式中的3個變量：fields,variables,parameters
  fields：從數據源傳入樣式的屬性名（日后通過反射取值使用，所以fields名一定要和數據源中的屬性名一樣！比如使用JRBeanCollectionDataSource的話，fields名就要和javabean中對應的屬性名一樣！）
  parameters：應用程序向報表傳入得非數據源形式的數據。
  variables：對fields，parameters，也包括所有java對象進行合法運算后得到的變量。（通常用做對數據源某個屬性的統計，比如求和什么等等）
 
  具體使用iReport設計報表樣式不說了，網上很多資料.
  需要注意的是
  在報表樣式中可以輸入表達式，也就是合法的java scriptlet
  在JasperReport中存在的都是java object所以某個textfield和對應數據的object類型一定要相同。
  parameters除了iReport默認的那些類型外其實可以使用任何java類型的。
  每個band在print when expression中輸入返回Boolean的表達式可以控制是否顯示
  可以使用group來添加bands，group其實并不需要和某個field對應，也就是說group沒有expression是可以的，只不過又expression的話會按照expression(通常的fields）來動態分組（這里又需要注意，效果上和sql的group by相當，但并不需要在查詢數據源的sql中寫group by, JasperReport回自己幫你做好的）
  在輸出數據的時候可以套用pattern，也就是正則表達式，比如輸出Double的時候使用 #,##0.00 表示金額：1，234.00, #0.00表示1234.00
 
  3）輸出報表
  采用一個Helper類，分別使用不同的方法得到填充了數據源的JasperPrint比如：
  

public JasperPrint getPrinterbyBeanCollection(File reportFile,Map reportParameters,JRBeanCollectionDataSource bean) throws Exception{
   try {
     if(!reportFile.exists()){
       throw new Exception("the jasper file is not exist");
     }
     JasperReport jasperReport = (JasperReport) JRLoader.loadObject(reportFile.
         getPath());
     JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport,
         reportParameters, bean);
     return jasperPrint;
   }
   catch (JRException ex) {
     logger.error("report",ex);
     throw new Exception(ex.getMessage());
   }
 }

  
  然后使用JasperPrint得到報表輸出，比如html輸出：
  

public void htmlExport(JasperPrint print,Map imagesMap,Object out) throws Exception{
    try{
      JRHtmlExporter exporter = new JRHtmlExporter();
      exporter.setParameter(JRExporterParameter.JASPER_PRINT, print);
      exporter.setParameter(JRExporterParameter.OUTPUT_WRITER, out);
      exporter.setParameter(JRHtmlExporterParameter.BETWEEN_PAGES_HTML, "");
      exporter.setParameter(JRHtmlExporterParameter.IS_REMOVE_EMPTY_SPACE_BETWEEN_ROWS, Boolean.TRUE);
      exporter.setParameter(JRHtmlExporterParameter.IMAGES_MAP, imagesMap);
      exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI, "image?image=");
      exporter.exportReport();
    }catch(Exception ex){
      logger.error("report",ex);
      throw new Exception(ex.getMessage());
    }
  }

6.普通報表開發：
  開發3步驟
  1.定義POJO，寫DataSource查詢數據庫生成一個Collection of POJOs
  2.使用iReport設計報表，定義和POJO屬性一樣的fields等
  3.用戶輸入web頁面及輸出的Servlet開發

7.SubReport
  其實和普通報表開發一樣，只不過多寫幾個報表樣式，POJO和DateSource。
  關鍵是在masterreport中對子報表的subreport選項卡中的Connection/DataSource Expression要選DataSource,然后填入你子報表的DataSource，當然先要把子報表的DataSource作為parameter傳入masterreport。（這里JasperReport的example全是Connection的example，害的我想了半天，呵呵，實際上在J2EE這個要求解藕程度很高的范圍內將sql寫在報表樣式中是不適合使用的）

8.最后說說為什么使用JRBeanCollectionDataSource，原因上面其實很多地方都說明了
  1。使用POJO和Collection簡單，規范
  2。充分的解除報表樣式和數據庫之間的耦合，假如我要查詢的sql變了，我只需要修改sql和結果集存入POJO的對應處，報表樣式是不用修改的。

9.喝咖啡，休息，（其實我更喜歡喝雪碧，呵呵）！                                                                        

                                                                               本文由 bangke 所撰寫 版權歸屬于bangke  轉載請注明出處