在公司的项目中用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  转载请注明出处