JasperReport报表设计总结（一）（已完毕） - 企业应用 - Java - Ja...

1. /**  
2.  * @copyRight Beijing Tsing-Tech Reachway Software Co.,Ltd.  
3.  * @author Jimmy.Shine 2007-5-11  
4.  */  
5. package cn.com.reachway.framework.report;   
6.   
7. import java.sql.Connection;   
8. import java.sql.DriverManager;   
9.   
10. import cn.com.reachway.framework.exception.JasperReportException;   
11.   
12. /**  
13.  * Used for get a JDBC connection for Jasper Report  
14.  */  
15. public class JDBCConnection {   
16.  /**  
17.   * Which Jdbc driver were used. Like: "net.sourceforge.jtds.jdbc.Driver"  
18.   */  
19.  private String jdbcDriver;   
20.  /**  
21.   * The jdbc url,define which database server,which db. Like:  
22.   * "jdbc:jtds:sqlserver://192.168.1.50:1433;DatabaseName=JAVA5;SelectMethod=Cursor"  
23.   */  
24.  private String jdbcUrl;   
25.   
26.  private String dbUser;   
27.   
28.  private String dbPassword;   
29.   
30.  public String getDbPassword() {   
31.   return dbPassword;   
32.  }   
33.   
34.  public void setDbPassword(String dbPassword) {   
35.   this.dbPassword = dbPassword;   
36.  }   
37.   
38.  public String getDbUser() {   
39.   return dbUser;   
40.  }   
41.   
42.  public void setDbUser(String dbUser) {   
43.   this.dbUser = dbUser;   
44.  }   
45.   
46.  public String getJdbcDriver() {   
47.   return jdbcDriver;   
48.  }   
49.   
50.  public void setJdbcDriver(String jdbcDriver) {   
51.   this.jdbcDriver = jdbcDriver;   
52.  }   
53.   
54.  public String getJdbcUrl() {   
55.   return jdbcUrl;   
56.  }   
57.   
58.  public void setJdbcUrl(String jdbcUrl) {   
59.   this.jdbcUrl = jdbcUrl;   
60.  }   
61.   
62.  public JDBCConnection() {   
63.   super();   
64.  }   
65.  /**  
66.   * Get the Connection   
67.   * @return connection  
68.   * @throws JasperReportException  
69.   */  
70.  public Connection getConnection() throws JasperReportException {   
71.   Connection con;   
72.   try {   
73.    check();   
74.    Class.forName(this.jdbcDriver);   
75.    con = DriverManager.getConnection(this.jdbcUrl, this.dbUser, this.dbPassword);   
76.    return con;   
77.   } catch (Exception e) {   
78.    e.printStackTrace();   
79.    throw new JasperReportException("Get JDBC Connection Error");   
80.   }   
81.  }   
82.     
83.  /**  
84.   * Check the Configure  
85.   * @throws JasperReportException  
86.   */  
87.  private void check() throws JasperReportException {   
88.   if (this.jdbcDriver == null || this.jdbcDriver.equals("") || this.jdbcUrl == null || this.jdbcUrl.equals("")   
89.     || this.dbUser == null || this.dbUser.equals("") || this.dbPassword == null) {   
90.    throw new JasperReportException("Jdbc Configure error!");   
91.   }   
92.  }   
93.   
94. }   
95.   

1. /**  
2.  * @copyRight Beijing Tsing-Tech Reachway Software Co.,Ltd.  
3.  * @author Jimmy.Shine 2007-5-14  
4.  */  
5. package cn.com.reachway.framework.report.dataSource;   
6.   
7. import net.sf.jasperreports.engine.JRDataSource;   
8. import net.sf.jasperreports.engine.JRException;   
9. import net.sf.jasperreports.engine.JRField;   
10.   
11. /**  
12.  * 报表的dataSource的基类，所有利用DataSource产生报表的继承此类  
13.  */  
14. public abstract class ReportDataSource implements JRDataSource {   
15.   
16.  /**  
17.   * 取值  
18.   */  
19.  public abstract Object getFieldValue(JRField jrField) throws JRException;   
20.   
21.  /**  
22.   * 指针移动  
23.   */  
24.  public abstract boolean next() throws JRException;   
25.   
26. }   
27.   

1. /**  
2.  * @copyRight Beijing Tsing-Tech Reachway Software Co.,Ltd.  
3.  * @author Jimmy.Shine 2007-5-14  
4.  */  
5. package cn.com.reachway.framework.report.dataSource;   
6.   
7. import java.util.ArrayList;   
8. import java.util.List;   
9.   
10. import net.sf.jasperreports.engine.JRException;   
11. import net.sf.jasperreports.engine.JRField;   
12.   
13. /**  
14.  * 利用JavaBean Collection生成ReportDataSource的例子  
15.  */  
16. public class ReportDataSourceSample extends ReportDataSource {   
17.   
18.  private List docs = new ArrayList();   
19.   
20.  private int index = -1;   
21.   
22.  public ReportDataSourceSample() {   
23.   for (int i = 0; i < 10; i++) {   
24.    Document doc = new Document("ViewTimes is:" + i, i);   
25.    this.docs.add(doc);   
26.   }   
27.  }   
28.   
29.  // 内部类，作为demo时使用   
30.  private class Document {   
31.   private String name;   
32.   
33.   private int viewTimes;   
34.   
35.   public String getName() {   
36.    return name;   
37.   }   
38.   
39.   public void setName(String name) {   
40.    this.name = name;   
41.   }   
42.   
43.   public int getViewTimes() {   
44.    return viewTimes;   
45.   }   
46.   
47.   public void setViewTimes(int viewTimes) {   
48.    this.viewTimes = viewTimes;   
49.   }   
50.   
51.   public Document() {   
52.   }   
53.   
54.   public Document(String name, int viewTimes) {   
55.    this.name = name;   
56.    this.viewTimes = viewTimes;   
57.   }   
58.  }   
59.   
60.  public List getDocs() {   
61.   return docs;   
62.  }   
63.   
64.  public void setDocs(List docs) {   
65.   this.docs = docs;   
66.  }   
67.   
68.  @Override  
69.  public Object getFieldValue(JRField jrField) throws JRException {   
70.   
71.   String fieldName = jrField.getName();   
72.   Document doc = this.docs.get(index);   
73.   if ("name".equals(fieldName)) {   
74.    return doc.getName();   
75.   }   
76.   if ("viewTimes".equals(fieldName)) {   
77.    return doc.getViewTimes();   
78.   }   
79.   return null;   
80.  }   
81.   
82.  @Override  
83.  public boolean next() throws JRException {   
84.   index++;   
85.   return (index < this.docs.size());   
86.  }   
87. }   
88.   

以上的例子应当很清楚的写明了如何生成数据源。
对于数据源的填充，笔者使用了二个类，分别用来对应使用Connction及JavaBean Collection进行填充。

1. /**  
2.  * @copyRight Beijing Tsing-Tech Reachway Software Co.,Ltd.  
3.  * @author Jimmy.Shine 2007-5-14  
4.  */  
5. package cn.com.reachway.framework.report.jasperPrint;   
6.   
7. import java.io.File;   
8. import java.util.Map;   
9.   
10. import net.sf.jasperreports.engine.JRDataSource;   
11. import net.sf.jasperreports.engine.JRException;   
12. import net.sf.jasperreports.engine.JasperFillManager;   
13. import net.sf.jasperreports.engine.JasperPrint;   
14. import net.sf.jasperreports.engine.JasperReport;   
15. import net.sf.jasperreports.engine.util.JRLoader;   
16. import cn.com.reachway.framework.exception.JasperReportException;   
17.   
18. /**  
19.  *   
20.  */  
21. public class JasperPrintWithDataSource {   
22.  /** 传入的参数 */  
23.  private Map params;   
24.  /** 模板文件的地址 */  
25.  private String reportFilePath;   
26.  /** dataSrouce */  
27.  private JRDataSource dataSource;   
28.   
29.  public JRDataSource getDataSource() {   
30.   return dataSource;   
31.  }   
32.   
33.  public void setDataSource(JRDataSource dataSource) {   
34.   this.dataSource = dataSource;   
35.  }   
36.   
37.  public Map getParams() {   
38.   return params;   
39.  }   
40.   
41.  public void setParams(Map params) {   
42.   this.params = params;   
43.  }   
44.   
45.  public String getReportFilePath() {   
46.   return reportFilePath;   
47.  }   
48.   
49.  public void setReportFilePath(String reportFilePath) throws JasperReportException {   
50.   if (reportFilePath == null || !reportFilePath.endsWith(".jasper"))   
51.    throw new JasperReportException("您传入的模板文件格式不对，请传入以.jasper为后缀的文件!");   
52.   this.reportFilePath = reportFilePath;   
53.  }   
54.   
55.  public JasperPrintWithDataSource() {   
56.   super();   
57.  }   
58.   
59.  public JasperPrintWithDataSource(String reportFilePath, Map params, JRDataSource dataSource)   
60.    throws JasperReportException {   
61.   if (reportFilePath == null || !reportFilePath.endsWith(".jasper"))   
62.    throw new JasperReportException("模板文件格式不对，请传入以.jasper为后缀的文件!");   
63.   if (dataSource == null)   
64.    throw new JasperReportException("DataSource不应当为null!");   
65.   this.setReportFilePath(reportFilePath);   
66.   this.setParams(params);   
67.   this.setDataSource(dataSource);   
68.  }   
69.  /**  
70.   * 取得JasperPrint  
71.   * @return  
72.   * @throws JasperReportException  
73.   */  
74.  public JasperPrint getJasperPrint() throws JasperReportException {   
75.   File reportFile = new File(this.reportFilePath);   
76.   if (!reportFile.exists())   
77.    throw new JasperReportException("传入的模板文件不存在!");   
78.   
79.   try {   
80.    // Load编译好的模板   
81.    JasperReport jasperReport = (JasperReport) JRLoader.loadObject(reportFile.getPath());   
82.    // 进行数据填充   
83.    JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, this.params, this.dataSource);   
84.    return jasperPrint;   
85.   
86.   } catch (JRException jre) {   
87.    jre.printStackTrace();   
88.    throw new JasperReportException("在进行数据填充时发生了错误中，请检查是否是数据库连接错误或者是用来填充的参数map有误!");   
89.   }   
90.   
91.  }   
92. }   
93.   

其中使用的JasperReportException为笔者定义的异常，用来统一处理报表异常。

5、报表产生
报表产生是程序中最终可见的一部分，在jasperReport的demo中，大部分中使用了jasperReport的net.sf.jasperreports.j2ee.servlets.*中的类来生成。其实这也算是开源的产品的一个问题，其实jasperReport提供的report的工具，只能算是demo级别的，不能算是产品级别的。相信很多的朋友在使用的时候就碰上无法生成的问题。笔者在此基础上封装了一下。
具体参见以下：