使用Jasperreport作为报表控件开发胖客户端报表应用

提示:在有些板块，文中的图片看不到，建议到我的blog浏览文章：http://blog.youkuaiyun.com/jemlee2002/
文章将会涉及3个方面的内容：

第一部分：使用iReport制作报表的详细过程（Windows环境下）

第二部分：使用Jasperreport作为报表控件开发胖客户端报表应用

第三部分：使用Jasperreport作为报表控件开发Web报表应用

1、概述

我们对第一部分的内容做个简要的回忆，第一部分主要是介绍使用iReport如何制作一个数据报表，我认为文章比较详细的介绍“如何从零到满足大部分需求报表出现”。但是文中没有涉及Jasperreport的任何内容，目的是让你纯粹的理解如何做报表，因为做报表和把报表内嵌到应用程序编程是可以分工的，便于整合也便于分解。

我们知道iReport是一个Jasperreport的前端开发工具，iReport用来制作和预览报表，为应用使用报表提供足够的前端支持。现在简要的介绍Jasperreport是如何工作的，这样你可以更好的理解iReport是如何帮助Jasperreport实现前端的工作，其实这些工作在我们看来就是“脏活”，为什么呢？看看下面的资料就知道了。

        通过上图你大概已经明白Jasperreport的工作原理了。首先是要有一个XML文件（一般是以jrxml后缀），那么这个XML文件从那里来呢？做什么用呢？ 这个XML文件就是报表的定义文件，整个报表的每一个细节都在这个XML文件之中定义，一个简单报表的xml文件就有几百行，你可以手工编辑这个XML文件（一行一行，一段一段的编辑吧――这就是所谓的“脏活”）。如果是手工制作这个XML文件，单从效率上考虑就不允许，特别是现在很多应用系统的开发时间变得越来越紧张，总是会在时间上出问题。节省时间最好的办法就是充分的利用自动化工具，詹姆斯.马丁的软件工程思想也是反复的强调过程的自动化，如何做到自动化呢？就是充分的利用自动化工具集成到开发流程，说了一大堆不就是为了说要用iReport来做报表吗！这是我们第一部分已经完成的工作，但是这里重要的是理解Jasperreport的工作原理。

2、结合Jbuilder开发胖客户端报表应用

2.1、建立Application

参考Jbuilder有关资料。只要是普通Window窗口应用即可。

2.2、引入JasperReports需要的库文件

通过jbuilder9【Tool】－【configure Libraries】－按最左边的【New】－输入一个名称，比如Report－【add】按钮，导航到iReport的lib目录，把lib目录里面的所有文件引入。如图：

 

按两次OK回到Jbuilder的开发界面。

2.3、向工程添加Report系列库文件

通过右击工程，选择【properties】－【paths】Label－【Required Libraries】Label－【Add】按钮－选择“Report”－按两次OK回到Jbuilder的开发界面。这样就添加完成了需要的库文件了。这么做是比较理想的，但是报表运行时可能不需要iReport的lib下所有的jar文件。

2.4、在主界面上添加需要的组件

在主Frame添加一个Button和一个Label以及一个TextBox，当然你也可以通过创建菜单连接，如图：

 

这个窗体时用来做测试用的，实际的界面可能很复杂，其中的TextBox就是为报表的变量做准备的。这里填写的值就是要传递给报表的变量，也就是第一部分定义的带$P{}符号的变量，程序会把他们对应起来。Button的单击事件代码如下：

/**

   * RptDialog对话框是用来承载报表的显示。

   * @param e

   */

  void jButton1_actionPerformed(ActionEvent e) {

        //请创建一个对话框类RptDialog

     RptDialog dlg = new RptDialog(this.jGroupID.getText());

     Dimension dlgSize = dlg.getPreferredSize();

     Dimension frmSize = getSize();

     Point loc = getLocation();

     dlg.setLocation( (frmSize.width - dlgSize.width) / 2 + loc.x,

                     (frmSize.height - dlgSize.height) / 2 + loc.y);

     dlg.setModal(true);

     dlg.pack();

     dlg.show();

  }

RptDialog是接下来制作的一个Dialog对象，通过Jbuilder新建一个Dialog对象并命名RptDialog。RptDialog的代码如下：

import java.awt.*;

import javax.swing.*;

import dori.jasper.engine.*;

import dori.jasper.view.*;

import dori.jasper.engine.util.JRLoader;

import java.sql.Connection;

import java.io.File;

import java.util.Map;

import java.util.HashMap;

import mytest.trac.CommectionDB;

/**

 * <p>Title: RptDialog </p>

 * <p>Description: 报表承载对话框</p>

 * <p>Copyright: Copyright (c) 2004</p>

 * <p>Company: *****</p>

 * @author 李克喜

 * @version 1.0

 */

public class RptDialog extends JDialog {

  JPanel ReportPan = new JPanel();

  BorderLayout borderLayout1 = new BorderLayout();

  //Bug项目名称

  String proname = "";

  //显示报表需要的控件

  JRViewer jrview;

  public RptDialog(String GroupID) {

    proname = GroupID;

    try {

      jbInit();

      pack();

    }

    catch (Exception ex) {

      ex.printStackTrace();

    }

  }

  private void jbInit() throws Exception {

    ReportPan.setLayout(borderLayout1);

    getContentPane().add(ReportPan);

    //装载报表,在Jbuilder工程的目录创建一个Reports文件夹，并把报表的jasper文件搁置在该文件夹。

    String reportPath = System.getProperty("user.dir") + "//Reports// BugsRpt.jasper";

    JasperReport jasperReport =

(JasperReport) JRLoader.loadObjectFromLocation(reportPath);

    //创建数据库的连接，参考java的JDBC编程资料创建连接方式

    CommectionDB conndb = new CommectionDB();

    //注意：这个连接要求与制作报表时使用的连接一致

    Connection conn = conndb.getDbConnection();

    //报表配置参数，前文提过的SQL语句的Where条件参数就是与这里对应。
  //条件的值可能是通过多种方式得到的，比如上一个页面传递过来的

    Map parameters = new HashMap();   

    //ProjectName就是iReport的变量$P{ProjectName}的名称，参考第一部分的5.6添加参数和使用参
proname就是从界面上获取的值。

 parameters.put("ProjectName ", proname);  

 JasperPrint jasperPrint =

           JasperFillManager.fillReport(

           jasperReport,

           parameters,

           conn

    );

   //装载过程，注意其中的红体字部分

   jrview = new dori.jasper.view.JRViewer(jasperPrint);

   ReportPan.setLayout(borderLayout1);

   ReportPan.setPreferredSize(new Dimension(800, 600));

   getContentPane().add(ReportPan, BorderLayout.CENTER);

   ReportPan.add(jrview,null);

  }

}

到这里，所有需要设置和编程的工作基本完成了。

3、运行

确定数据库已经启动了，在JBuilder运行应用程序。在TextBox输入有意义的组值，比如“BugWin系统”，这是我的测试值，实际情况是根据你的需要来确定的。单击Button，系统会弹出对话框，运行结果和第一部分6.2、预览报表结果一致。

4、总结

随着技术的进步，应用环境的不断变化，胖客户端的应用可能会逐渐退出主流，但是它的存在是必要的。所以我要写胖客户端的应用方面的报表使用技术。文中简要明了的介绍了如何使用Jasperreport编程报表程序。希望对你有一点帮助。

 

转自：http://blog.youkuaiyun.com/jemlee2002/archive/2004/10/08/127745.aspx