使用 Eclipse BIRT 扩展点：聚合

核心提示： 此类中的大部分方法只是简单描述要在 BIRT Aggregation Widgets 下拉列表中显示的聚合的各个方面，比如数据类型、标题和描述信息，使用 Eclipse BIRT 扩展点：聚合(7)，这 3 个方面有必要进一步解释一下，首先是 getParameterDefn() 方法，在 Te

此类中的大部分方法只是简单描述要在 BIRT Aggregation Widgets 下拉列表中显示的聚合的各个方面，比如数据类型、标题和描述信息。这 3 个方面有必要进一步解释一下。首先是 getParameterDefn() 方法，它返回一个 IParameterDefn 对象数组，可以在该数组中定义聚合需要的参数。一个聚合可以有多个参数，这就是为什么要以数组的形式返回参数。此方法向 BIRT 引擎简单描述这些参数及其类型。在本例中，仅有一个参数（列表达式），它将是一个字符串。

那么，如果参数在 getParameterDefn() 方法中进行描述，要将它们传入到何处来执行实际工作呢？IAggrFunction 对象还充当着 Accumulator 类的工厂，该对象应该在 newAccumulator 方法中创建。Accumulator 是在聚合中执行实际工作的类。它有两个方法需要重载：getValue() 和 onRow()。对于在 BIRT 中处理的每一行，如果使用此聚合，数据绑定将调用 onRow()。作为一个参数，onRow 接收一个包含聚合参数的数组，这些参数由 getParameterDefn() 描述。在更加健壮的方案中，可以调用 getParameterDefn() 并测试传入 onRow() 的参数是否与定义匹配。但是，本文中的简单示例跳过了这一步。onRow() 方法还负责执行处理工作。在上面的聚合代码示例中，它仅用于增加正在计算的字符串总字数。当报告准备好显示值时，它调用 getValue() 方法。

需要进一步说明的另一个元素是 IAggrFunctions getType() 方法。两种聚合类型（SUMMARY_AGGR 和 RUNNING_AGGR）定义该方法属于哪种聚合类型；它出现在报告表的表头或表尾，还是显示在每一行中；它在计算时显示的是累计总计，还是平均值。

测试插件

可以轻松测试此插件，无需象测试任何 Eclipse 插件一样进行部署：只需启动另一个 Eclipse 实例即可。启动另一个实例的最简单方式是从 plugin.xml/manifest 窗口的 Overview 选项卡上启动。在此选项卡上，在 Testing 区域，单击 Launch an Eclipse application 链接，如图 8 所示。