使用Eclipse BIRT和POJO的报表教程

Eclipse Birt

本教程介绍如何使用Eclipse BIRT和POJO来制作报表。本教程还介绍了如何部署所制作的BIRT报表到Web容器（Tomcat）中，以及如何把它运用到一个Eclipse RCP应用程序中。 本教程使用的是Eclipse 3.7 (Indigo)。

原文传送门：http://www.vogella.com/tutorials/EclipseBIRT/article.html

1. Eclipse BIRT

1.1. 概述

Eclipse BIRT允许创建基于来自不同数据源数据的报表。

BIRT提供了以下数据源：

  • 数据库（通过JDBC）
  • 文本文件（CVS，XML）
  • Web服务（WSDL通过档案）
  • 脚本数据源

您使用BIRT的“数据集”来定义查询的数据源。这些数据集可以在报表中使用。

在Java程序中，经常方便地使用Java对象作为数据源的报表。本文将重点放在简单Java对象（POJO）作为数据源的BIRT报表的使用。

1.2.示例

在本教程中，我们将建立一个报表，该报表将显示美国的股票市场信息。我们从一个Java对象中获取数据，该数据将显示在一个图表和详细信息的表格中。其结果应该是这样的：

2.安装

使用Eclipse Update Manager来安装“Business Intelligence, Reporting and Charting” - > BIRT Framework。

3.创建项目和报表

创建一个新的Java项目名称为“de.vogella.birt.stocks”。

通过File -> New -> Other -> Business Intelligence and Reporting -> Report来创建一个新的报表“stock_report.rptdesign”。

新的报表显示在“报表设计”的角度。删除例子报表中的一切，除了报表的标题。结果应该像下面这样。

4.Java类

该报表将显示股票数据。为了证明BIRT我们使用模拟对象提供数据。

创建包“de.vogella.birt.stocks.model”，然后在下面的类。这个类将代表域模型。

package de.vogella.birt.stocks.model;

import java.util.Date;

/**
 * Domain model for stock data
 * @author Lars Vogel
 */

public class StockData {
  private Date date;
  private double open;
  private double high;
  private double low;
  private double close;
  private long volume;

  public double getClose() {
    return close;
  }

  public void setClose(double close) {
    this.close = close;
  }

  public Date getDate() {
    return date;
  }

  public void setDate(Date date) {
    this.date = date;
  }

  public double getHigh() {
    return high;
  }

  public void setHigh(double high) {
    this.high = high;
  }

  public double getLow() {
    return low;
  }

  public void setLow(double low) {
    this.low = low;
  }

  public double getOpen() {
    return open;
  }

  public void setOpen(double open) {
    this.open = open;
  }

  public long getVolume() {
    return volume;
  }

  public void setVolume(long volume) {
    this.volume = volume;
  }

}

创建包“de.vogella.birt.stocks.daomock”，然后在下面的类“StockDaoMock”。这只会模拟/假数据并没有真正从互联网上得到它，因为我们在这里学习的BIRT这样就应该可以了。

package de.vogella.birt.stocks.daomock;

import java.util.ArrayList;
import java.util.Calendar;
import java.util.List;

import de.vogella.birt.stocks.model.StockData;

public class StockDaoMock {

  public List<StockData> getStockValues(String company) {
    // Ignore the company and always return the data
    // A real implementation would of course use the company string
    List<StockData> history = new ArrayList<StockData>();
    // We fake the values, we will return fake value for 01.01.2009 -
    // 31.01.2009
    double begin = 2.5;
    for (int i = 1; i <= 31; i++) {
      Calendar day = Calendar.getInstance();
      day.set(Calendar.HOUR, 0);
      day.set(Calendar.MINUTE, 0);
      day.set(Calendar.SECOND, 0);
      day.set(Calendar.MILLISECOND, 0);
      day.set(Calendar.YEAR, 2009);
      day.set(Calendar.MONTH, 0);
      day.set(Calendar.DAY_OF_MONTH, i);
      StockData data = new StockData();
      data.setOpen(begin);
      double close = Math.round(begin + Math.random() * begin * 0.1);
      data.setClose(close);
      data.setLow(Math.round(Math.min(begin, begin - Math.random() * begin * 0.1)));
      data.setHigh(Math.round(Math.max(begin, close) + Math.random() * 2));
      data.setVolume(1000 + (int) (Math.random() * 500));
      begin = close;
      data.setDate(day.getTime());
      history.add(data);
    }
    return history;
  }
}

5.数据源和数据集

使用Java对象（POJO的）作为数据源在Eclipse BIRT你要映射的Java类的JavaScript的领域。这个JavaScript用于在您的报表，并会访问Java对象。

5.1.创建数据源

数据源与报表连接您的数据。 BIRT提供不同类型的数据源，我们使用“脚本数据源”。回到你的stocks_report，使用“Report Design”的角度来看，选择“Data Explorer”查看。

创建一个新的数据源，在您的报表名为“srcStocks”。

5.2.该数据集

该数据集定义了数据源的数据和BIRT的数据映射。创建一个名为“dataSetSocks”新的数据集。

按下一步，并定义报表的列。

5.3. JavaScript

现在我们就来编写JavaScript做为我们的数据集。选择数据集，然后选择“open”的脚本。打开脚本之前所述第一访问的数据集调用。我们用它来装载我们的名单与股票的对象。要访问一个Java类，你只需要使用以下语法：Packages.myJavaClass其中myJavaClass是完整的Java类名。

count = 0;

// create instance of
// the GetStockHistory class
gsh = new Packages.de.vogella.birt.stocks.daomock.StockDaoMock(); 

//Load the List

stock = gsh.getStockValues("Java");

复制下面的代码到获取脚本。

if(count < stock.size()){
       row["columnDate"] = stock.get(count).getDate();
       row["columnOpen"] = stock.get(count).getOpen();
       row["columnHigh"] = stock.get(count).getHigh();
       row["columnLow"] = stock.get(count).getLow();
       row["columnClose"] = stock.get(count).getClose();
       row["columnVolume"] = stock.get(count).getVolume();
       count++;
       return true;
}

return false;

通过双击dataset -> Preview Result来检查您的脚本

6.显示表中的数据

6.1.概述

现在，我们将在一个表中显示数据。

6.2.创建一个表

从“Data Explorer”切换到“Palette”。选择“Layout”标签。

拖放报表上的表格元素。

为表定义以下设置。

返回到"Data Explorer"。然后，拖放数据集的列到表中的“Details row”。

结果应该像下面这样。

完成。你可以看到这份报表的预览，如果你点击“Review”选项卡。结果应该如下所示：

7.图

7.1.创建图表

切换回调色板中选择一个图表和拖放在您的报表。

选择折线图的标准设置。

按下一步，选择你的数据集。

在接下来的步骤中，我们必须分配列到轴线上。我们指定的时间作为x轴，然后通过拖放打开值到y轴上。

一共定义5个系列。通过拖动列的总和符号指定的列到这些系列。

目前在x轴的第一显示最新日期。反向x轴所必须的数据升序进行排序。按突出显示的按钮。

转到下一个标签，并给你列给出的标题。隐藏在最后一个。

日期的显示使用长格式，我们想改变这种情况。执行以下，并选择“short”为日期类型的X轴

改变通过以下的线的显示。

点击Finish按钮把图表引入到您的报表中。

8.在Tomcat中部署

8.1.概述

下面介绍如何使用Tomcat的BIRT报表。一般来说，你需要：

  • 安装BIRT Web查看器中的Tomcat
  • 您的BIRT项目导出到.jar文件
  • 移动.jar文件到BIRT安装目录/ WEB-INF / lib目录
  • 将报表设计文件为BIRT在Tomcat的根目录
  • 重新启动Tomcat

8.2.在Tomcat的安装BIRT

我们将利用我们假设已经安装的独立的Tomcat6.0。请参阅Apache Tomcat Tutorial的详细信息。

你需要http://download.eclipse.org/birt/downloads/的“BIRT部署的组件”。

此下载的birt.war复制到Tomcat的webappsfolder。

BIRT的例子应该在http://localhost:8080/birt/中有效了。如果你看到这样的事情，你的Tomcat的您的Web浏览器应该是正确的。

8.3.安装在Tomcat中的BIRT报表

要运行自己的报表，你必须在.rptdesign文件复制在Tomcat中的BIRT文件夹的根目录。为了使您的Java类，可将项目导出到一个jar文件。

在那之后的jar文件必须复制到Tomcat的webapps/ BIRT/ WEB-INF/ lib /目录。重新启动Tomcat，然后导航至您的报表。

你的报表应该在HTTP上找到http://localhost:8080/birt/frameset?__report=stock_report.rptdesign

9.部署在Eclipse RCP应用程序

9.1. BIRT部署到RCP应用程序

我们可以使用Birtviewer也在本地RCP的应用，这是不超过一个浏览器视图，它示出了由一个集成的网络服务器产生的HTML页面。

下面假设你已经熟悉的Eclipse RCP开发。请参阅Eclipse RCP的教程的情况下，你需要一个介绍。

转换“de.vogella.birt.stocks”到插件项目，通过右键单击 -> Configure -> "Convert to plug-in project"。

创建一个新的插件项目“de.vogella.birt.stocks.rcp”。选择模板“RCP Application with a view”。

添加以下插件，dependendies为“de.vogella.birt.stocks.rcp”。

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: Rcp
Bundle-SymbolicName: de.vogella.birt.stocks.rcp; singleton:=true
Bundle-Version: 1.0.0.qualifier
Bundle-Activator: de.vogella.birt.stocks.rcp.Activator
Require-Bundle: org.eclipse.ui,
 org.eclipse.core.runtime,
 org.eclipse.birt.report.viewer,
 org.eclipse.birt.report.engine.emitter.html,
 de.vogella.birt.stocks,
 org.eclipse.birt,
 org.eclipse.birt.chart.ui,
 org.eclipse.birt.chart.device.extension,
 org.eclipse.birt.chart.device.pdf,
 org.eclipse.birt.chart.device.svg,
 org.eclipse.birt.chart.device.swt,
 org.eclipse.birt.chart.engine.extension,
 org.eclipse.birt.chart.reportitem,
 org.eclipse.birt.chart.reportitem.ui,
 org.eclipse.birt.chart.ui.extension,
 org.eclipse.birt.core.script.function,
 org.eclipse.birt.report.engine.script.javascript
Bundle-ActivationPolicy: lazy
Bundle-RequiredExecutionEnvironment: JavaSE-1.6

复制你的报表到这个新项目，并重命名为“stock_report_rcp.rptdesign”。打开此报表，并将“open”脚本更改为如下。

count = 0;
/*
 * load and init data reader
 * import Platform from org.eclipse.core.runtime
 */
importPackage(Packages.org.eclipse.core.runtime);

/* load bundle with POJOs and data loading class */

myBundle = Platform.getBundle("de.vogella.birt.stocks");

/* load data reader class */
readerClass = myBundle.loadClass("de.vogella.birt.stocks.daomock.StockDaoMock");

/* create new instance of DataReader */
readerInstance = readerClass.newInstance();

/* read data */
stock = readerInstance.getStockValues("Java");

使用下边代码做为View.java。

package de.vogella.birt.stocks.rcp;

import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;

import org.eclipse.birt.report.viewer.utilities.WebViewer;
import org.eclipse.core.runtime.FileLocator;
import org.eclipse.core.runtime.Path;
import org.eclipse.core.runtime.Platform;
import org.eclipse.swt.SWT;
import org.eclipse.swt.browser.Browser;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.ui.part.ViewPart;
import org.osgi.framework.Bundle;

public class View extends ViewPart {
  public static final String ID = "de.vogella.birt.stocks.rcp.view";

  public void createPartControl(Composite parent) {
    String path = "";
    try {
      Bundle bundle = Platform.getBundle("de.vogella.birt.stocks.rcp");
      URL url = FileLocator.find(bundle, new Path("stock_report_rcp.rptdesign"), null);
      path = FileLocator.toFileURL(url).getPath();
    } catch (MalformedURLException me) {
      System.out.println("Fehler bei URL " + me.getStackTrace());
    } catch (IOException e) {
      e.printStackTrace();
    }

    Browser browser = new Browser(parent, SWT.NONE);
    // use the filename of your report
    WebViewer.display(path, WebViewer.HTML, browser, "frameset");
  }

/**
   * Passing the focus request to the viewer's control.
   */

  public void setFocus() {
  }
}

10.支持这个网站

本教程是根据CC BY-NC-SA
3.0 DE授权开放内容。在本教程中的源代码是在Eclipse
Public License下发布。请参阅重用的条款细节vogella
License页面。

编写和更新这些教程是一个大量的工作。如果这个免费的社区服务是有用的，你可以通过给小费以及报表拼写错误和事实错误支持的原因。

10.1.谢谢

如果这篇文章帮助你，请考虑适当捐款。

10.2.问题与讨论

如果您在本教程中发现错误，请通知我（见top
of the page）。请确保您已经阅读vogella FAQ，因为已经有解答，所以我不对这里的问题作出回应。

11.链接与文献

11.1.源代码

示例源代码

11.2. Eclipse的BIRT资源

http://wiki.eclipse.org/index.php/BIRT_Project

Eclipse BIRT Wiki

11.3. vogella资源

vogella Training Android and Eclipse Training from the vogella team

Android Tutorial Introduction to Android Programming

GWT Tutorial Program in Java, compile to JavaScript and HTML

Eclipse RCP Tutorial Create native applications in Java

JUnit Tutorial Test your application

Git Tutorial Put all your files in a distributed version control system

附

注：本文对原文进行粗略翻译和略微精简，不足之处还请见谅。

BIRT相关

BIRT? vs JasperReports? vs Pentaho? http://www.innoventsolutions.com/comparison-matrix.html

BIRT Home - Eclipse http://www.eclipse.org/birt/

Demos http://eclipse.org/birt/demos/

在 Eclipse 中用 Java 实现百灵报表(BIRT)的事件处理 http://www.ibm.com/developerworks/cn/opensource/os-cn-ecl-birtje/index.html

用 BIRT 实现高级图表 http://www.ibm.com/developerworks/cn/education/opensource/os-eclipse-birt-advanced/index.html

BIRT中文指南 http://wenku.baidu.com/view/ba67857102768e9951e73869.html

BIRT：基于 Eclipse 的报表 http://www.ibm.com/developerworks/cn/opensource/os-ecl-birt/

时间： 2024-12-09 17:43:36

使用Eclipse BIRT和POJO的报表教程的相关文章

eclipse birt报表开发入门

在开发中,报表或多或少会涉及到,有些报表可能比较简单,而有些报表可能很复杂.无论如何,这些报表功能的开发都是可以通过一些公共的组件来实现的,比如我现在所在的这家公司,如果想要制作报表,只需要配置下报表配置下就可以了(这个报表是通过特定实现的报表语言实现了,支持内部自定义的语言,最终将这些相应的数据保存到数据库中,对报表中的一些事物进行了抽象,比如:报表模型, 查询参数.).如果要自己手动的一步一步的编写报表,那么相对会比较麻烦,如果能提供一个框架,只需要进行一些配置就可以完成自定义报表,那岂不很

MyEclipse Reports和Eclipse BIRT详细对比分析（上）

1. 介绍MyEclipse Reports的BIRT用户 MyEclipse Reports?专门为Eclipse BIRT框架(BIRT)实现MyEclipse Web项目约定和目录布局.开发工作流程.部署和测试的功能.本文档介绍MyEclipse Reports和BIRT两者之间的关键概念和物理差异.一般的报表开发概述和报表功能由MyEclipse Reports提供,详情请见MyEclipse中的报表工具. 本文主要是为那些熟悉BIRT框架和工具的开发者对于和比较MyEclipse Re

MyEclipse Reports和Eclipse BIRT详细对比分析（下）

在MyEclipse Reports和Eclipse BIRT详细对比分析(上)一文中,小编为大家介绍了MyEclipse Reports的BIRT用户.MyEclipse Reports适用范围.项目类型.用户界面组织等.接下来小编继续为大家介绍另外几节内容,希望能够帮助到大家. 5. 支持JDBC驱动程序数据源 MyEclipse报表能够直接适用MyEclipse JDBC驱动程序来作为报表数据源.Data Explorer视图中有新的数据源向导,其中还包括了MyEclipse JDBC驱动

birt报表报错， There is no report design object available.org.eclipse.birt.report.exception.ViewerExcepti

报错信息如下: - There is no report design object available. org.eclipse.birt.report.exception.ViewerException: There is no report design object available. at org.eclipse.birt.report.context.ViewerAttributeBean.__init(ViewerAttributeBean.java:226) at org.ec

OpenJTAG+Eclipse 3.5+GDB+Mini2440图文教程

OpenJTAG+Eclipse 3.5+GDB+Mini2440图文教程 OpenJTAG与JLink的区别比较: 相同点:都同时具备USB转JTAG.USB转串口功能 差别: 1. 操作系统: OpenJTAG可以用在Windows.Linux下: JLink只能用在Windows下,在Linux下它的调试功能无法使用,只能使用“JLink+USB转串口2合1”中的USB转串口功能 2. 集成开发环境: OpenJTAG能用在所有支持GDB调试协议的工具上,比如IAR.Eclipse.win

eclipse下配置安装ssm图文教程（web版）

eclipse下配置安装ssm图文教程(web版) 一.安装所需jar包 1.1  mybatis安装包 可以进入GitHub的https://github.com/mybatis/mybatis-3/releases下载所需版本,本文版本是mybatis-3.4.2 Mybatis实现缓存的jar包: 1.2  spring安装包 补充:spring配置aop的aspect包 可以进入spring官网的http://projects.spring.io/spring-framework/ 下载

org.eclipse.birt.report.exception.ViewerException: 没有可用的报表设计对象.

 这是我的报表的访问页面,换另一个报表就可以,换回来又不行:  ViewerException包括很多种情况呢!通常就是版本问题,检查一下birt文件的版本和你项目里面birt的版本是否一致,不一致的话,把这一段 <?xml version="1.0" encoding="UTF-8"?> <report xmlns=id="1"> 换成可运行文件里的同样部分试试 <?xml version="1.0&qu

org.eclipse.birt.report.data.oda.jdbc.JDBCException: Missing properties in Connection.open(Propertie

首先查看工程的web.xml文件中"BIRT_RESOURCE_PATH"属性的设置,此属性设置的是"用户资源存放路径,这些资源包括 library 文件,image 文件等.默认是当前根目录."比如我的设置为"/library",则表示是所有的库文件都是在跟木下的library目录下. 查看报错报表文件的xml源代码,发现引入的库路径为"library/ds.rptlibrary",这是在将库文件拖放到报表文件时自动添加的,

在Eclipse下搭建Android开发环境教程

我们昨天向各位介绍了<在NetBeans上搭建Android SDK环境>,前不久也介绍过<在MyEclipse 8.6上搭建Android开发环境>, 都受到了读者的欢迎.但是很多朋友都认为NetBeans在中国用户不多,MyEclipse又是收费产品,都没有Eclipse好,很多读者都希望我们 介绍一下Eclipse下搭建的Android开发环境,本文将全程演示Android开发环境的搭建过程,无需配置环境变量.所有软件都是写该文章时最 新版本,希望大家喜欢. 一 相关下载 (