BIRT：基于 Eclipse 的报表[转]

count from item,user_item
where item.itemid= user_item.itemid
and user_item.userid= ?

同时在数据集items上创建参数user，它对应SQL中的参数。

D. 从"Palette"视图拖入"列表"到报表中，在"属性编辑器"的"绑定"页中，选择数据集为user。它用来显示主表的信息，在本例中是用户信息。

E. 从"Palette"视图拖入"网格"到"列表"的"明细数据"中，设置网格为1行2列，它用来存放"用户姓名"和"用户地址"。在"数据资源管理器"视图，选择数据集user，将username和addr分别拖入网格的2列中。

F. 在"数据资源管理器"视图，选择数据集items，将它拖入"列表"的"明细数据"中，位于刚刚插入的网格下方。此时，BIRT会生成数据集items对应的"表"。

G. 选择刚刚生成的"表"，在"属性编辑器"的"绑定"页中，会出现在items中定义的参数。修改它的值：row["userid"]。于是，父子报表就发生了联系。

H. 选择预览，或运行报表，就可以看到结果了。

很遗憾，到目前为止，另一种最常见的报表"交叉表"还不被BIRT支持。但是，BIRT的官方网站已明确表示，将在未来的版本中支持它。

3. 统计图表

俗话说，"一图顶千言"。没有图的报表是枯燥，且缺乏表现力的。在本例中，我们将使用图表来表示：每个用户的消费总数。

A. 创建新报表和数据源。

B. 创建数据集chart，使用SQL：

select user.username,round(sum(item.price*user_item.count),2)
from item, user_item, user
where item.itemid= user_item.itemid
  and user.userid= user_item.userid
group by user.username

C. 从"Palette"视图拖入"图表"到报表中，此时会弹出"编辑图表"窗体。

D. 在"选择图表类型"页，选择图表类型为"条形图"。在"选择数据"页，使用数据集chart，同时选中username列，将其拖入"类别x系列"。对于统计列，同样将其拖入"类别y系列"。在"图表格式"页，分别为x和y系列，填写相应的显示名称。

E. 选择预览，或运行报表，即可看到统计图表。

4. 使用脚本

可以使用脚本，是BIRT的一大特色。在BIRT中，数据源、数据集和报表项，都可以书写脚本。具体做法：选择数据源、数据集和报表项任意一种对象，然后选择"脚本"页面。如选择数据源user后，对应的脚本输入页面：

选择对应的事件，然后在下方的脚本输入框中输入脚本即可。如对于第一个例子，我们需要统计用户地址是"No.5 St."的用户数：

A. 选择数据集，然后选择"脚本"，进入数据集的脚本编辑窗口。

B. 选择事件"afterOpen"，在脚本窗口内输入：count=0;

C. 选择事件"onFetch"，在脚本窗口内输入：if( row["addr"]== "No.5 St.") count++;

D. 选择报表，在脚本窗口选择事件"onRender"，输入：this.caption=count;

E. 预览，或运行报表后，会在报表的标题输出count的数值。

另外，BIRT也支持使用java来作为报表项的事件处理程序。具体做法，请参见BIRT的帮助文档。

5. 库和模板

除了脚本使开发者可以自定义报表的行为外，BIRT还提供了库和模板机制来重用设计，加快报表的开发。在TheServerSide上有一篇相当详细的文档：Using Eclipse BIRT Report Libraries and Templates。

回页首

应用集成

BIRT与现有应用的集成非常简单，由于BIRT主要是web应用，本节以web应用为例进行说明。

1. 从Eclipse BIRT官方网站下载birt-runtime-2_0_0.zip。

2. 解压之后，只需要其中的web view example目录下的内容。

3. 复制以下第三方软件包到web view example目录：

  需要的jar文件 复制位置 Apache AxisiText 1.3prototype.js v1.4.0

axis.jar axis-ant.jar commons-discovery-0.2.jar jaxrpc.jar saaj.jar wsdl4j-1.5.1.jar	WEB-INF/Lib
itext-1.3.jar	Plugins/org.eclipse.birt.report.engine.emitter.pdf/lib
prototype.js v1.4.0	ajax/lib

4. 将web view example目录发布到web容器中，如tomcat，改名：birtApp。

5. 启动tomcat，并访问birtApp。在首页中选择"View Example"，如果成功发布，系统将提示成功。

6. 发布设计完成的报表文件，在birtApp中创建reports目录，用于存放报表设计文件。

7. 在应用中通过：http://localhost:8080/birtApp/frameset?__report=报表文件路径，就可以访问报表了。

这个web应用支持2个动作：

• frameset，以frameset的形式显示报表。这个界面包含一些frame，如页面导航，报表主体在其中的一个frame中显示；使用形式：
  http://localhost:8080/birtApp/frameset?__report=报表文件路径&参数=........
• run，报表以一个单独的html页面或pdf显示，由于这种形式没有frmaeset，因此使用者必须自己提供相应的参数，如报表参数，页号等。使用形式：
  http://localhost:8080/birtApp/run?__report=报表文件路径&参数=........

对于以上2个动作，以下列出可用的参数：

选项 说明 __format __isnull __locale __report 报表参数

报表输出格式：html或pdf，缺省是html。对于frameset不起作用。

指明一个参数是null，常用于字符串类型。如果提供参数且值为空： - 对于日期和数字类型，BIRT会将它们当作null处理。 - 对于字符串，BIRT会将它作为空字符串。因此，为了说明某个字符串是null，通常写为：__isnull=参数。

本地化选项，缺省是jvm的locale。

报表设计文件路径。

报表参数参数值对，形式：参数名=参数值。对于frameset，直接在地址栏中输入参数名=参数值后回车，不会影响报表结果。虽然，此时选择"运行报表"时，弹出的参数值已经改变。

虽然本节所说的是针对web应用的集成，但是这种方法同样也可与非web应用集成。此时，我们可以采取一种变通的方法：在非web应用中使用内嵌的web容器，如jetty，也可达到同样的效果。这种做法和Eclipse的做法类似。还记得在报表设计时使用"报表 -> 运行报表"吗？那个弹出的窗体，实际就是一个web页面。

回页首

结论

与一些老牌报表软件相比，BIRT可能仍显稚嫩。然而，它也不乏其独到之处，如脚本控制、库和模板。加之有世界领先的报表厂商Actuate支持，实际上BIRT的ROM（Report Object Model）就是Actuate捐献的，我们有充分的理由对BIRT的前景表示乐观。

参考资料

• BIRT官方网站 http://www.eclipse.org/birt/phoenix/
• BIRT and POJOs as datasources example http://tools.osmosis.gr/blog/archives/2005/06/birt_and_object.html
• Using Eclipse BIRT Report Libraries and Templates http://www.theserverside.com/articles/article.tss?l=EclipseBRT

关于作者

		胡键，西安交通大学硕士，2000 年毕业后一直从事软件开发。2002 年开始使用 Java，在平时的项目开发中经常采用 OpenSource 的工具，如 Ant、Maven、Hibernate、Struts 等，目前正在研究信息集成方面的规范和技术。可以通过[e-mail]与他取得联系，或访问个人 blog：http://blog.donews.com/foxgem/。