第十四章 高级特性-海纳百川：BIRT报表扩展点

如果仅仅只是前面章节提到的BIRT的设计器的便捷性和BIRT引擎提供的用户自定义BIRT报表展示器等自定义特性，只是表现在BIRT报表作为工具的优势，或者作为服务提供者为系统集成做出的贡献，但这还不足以让BIRT成为eclipse开源社区排名前六的基础插件平台。

众所周知，大凡伟大的IT作品，皆是以开放为基础。ios的app store，android的app market，eclipse的plug-in，maven的osgi，microsoft的windows虽然闭源，但提供了visual studio应用开发平台，而visual studio是一个很优秀的平台;

BIRT同样也提供了扩展点，为它的数据源，数据集，数据操作函数，数据展示，数据导出，图表等等提供多数据源，多种形式的展示，多种格式的导出等等扩展。比如Oracle给multimedia CLOB提供的新特性，只要实现BIRT的数据源，数据集和数据展示，数据导出的新特性，同样可以用BIRT报表进行展示；任何第三方，无论是数据库厂商，还是数据提供商，例如医院，教育机构，航天航空机构等等，都可以实现这些扩展点中提供的接口和实现类，来完成报表的功能。

下面先从一个最简单的扩展例子——扩展BIRT报表的聚合函数，开始着手详细讲解BIRT的扩展点。感谢IBM开源社区提供这个古老的案例。

本节介绍商业智能和报告工具（Business Intelligence and Reporting Tools，BIRT）扩展点模型，并在 BIRT V2.3.x 和 V2.5.x 中实际创建一个聚合扩展。在较早的 BIRT 版本中，创建聚合扩展的方式是扩展 org.eclipse.birt.data.aggregation 扩展点，这会在一个名为 Total 的全局对象中添加一个小函数，您可以在整个报告的任何表达式中使用该函数，其工作原理类似于脚本函数扩展点。

但是，从 BIRT V2.2 到 V2.3，聚合扩展已经发生了变化。新的方式更加复杂，但可以在 Aggregation Widgets 下拉列表中得到一个不错的聚合，还为参数和表达式提供了漂亮的文本框。当创建此扩展时，可以在您的表中以列绑定的形式访问结果。

从总体上看，新的聚合扩展点包含一个对象，该对象是 IAggregationFactory 接口的扩展。可以在此接口中重载方法来完成 3 项操作：

· 初始化您的工厂（在构造函数中）

· 提供由工厂提供的一组聚合（以列表形式提供，包含聚合对象的实际实例）

· 返回聚合对象的单一实例

聚合的每个实例都需要实现 IAggrFunction 接口。需要实现许多含义明显的方法，比如 getName、getDataType 和getParmaeterDefn，还需要实现其他含义不太明显的方法。例如，getNumberOfPasses() 和 getType() 方法是相关的。getType() 方法制定此聚合器的执行方式和类型。有两种聚合类型：SUMMARY_AGGR 表示只为摘要计算该聚合（比如表的表头或表尾），RUNNING_AGGR 表示为表中的每一行或表尾计算聚合。getNumberOfPasses() 方法显示获得结果所需的 pass 数。所有基于评级的聚合器，比如 TopNpercent、PercentSum 和 Percentile，都会返回值 2，其余聚合器返回值 1。

IAggrFunction 接口的实际实现必须返回其 newAccumulator() 方法中的 Accumulator