本文主要是介绍BIRT 报表的自动化测试,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
来源:http://www.ibm.com/developerworks/cn/opensource/os-cn-ecl-birttest/如何为 BIRT 报表编写自动化测试用例
BIRT 是一项很受欢迎的报表制作工具,但目前对其的测试还是以人工测试为主。本文介绍了如何对 BIRT 报表进行自动化测试,以及在实际项目中的一些测试实践,从而提高了测试的效率和准确性
----------------------------------------------------
报表测试自动化的重要性
报表在当今企业中是非常重要的一项工具,很多信息系统都要实现报表的功能来满足业务的需求。开源工具 BIRT 是一项很好的报表制作工具,使用简便,功能也较丰富,很多人都选择 BIRT 来制作自己的报表。
要做好一个软件系统离不开测试,报表也不例外。要通过全面测试来保证报表中数据的正确性。常用的测试方法是运行生成报表,然后人工来检查看数据是否正确。然而,这种方法比较繁琐,每次测试都要花费测试人员一定的时间,测试过程难以重用。现在敏捷开发已逐渐成为主流开发方式,系统的代码会不断变化来适应新的需求,这时全面的回归测试就显得更为重要。人工测试的代价太大,难以满足测试的质量要求,而自动化测试一经开发完成后就可以不断重用,非常方便,几乎不再需要人力去干预,是回归测试的首选,能更好的保证测试的质量。
然而,要对报表进行自动化测试并不像制作一张报表那样容易,本文将介绍如何对 BIRT 制作的报表进行自动化测试。
回页首
测试的基本思想
自动化测试的基本思想就是生成报表后,由电脑读出报表的内容,然后与预先计算好的结果进行比较,从而判断报表的结果是否正确。因此,自动化测试用例的重点就是如何编程访问 BIRT 报表的数据。
BIRT 制作的报表,其设计文件是 .rptdesign 格式,该文件定义了报表的元数据,即如何得到报表的内容以及内容的表示方式。BIRT 引擎就是根据这个文件生成报表的。在具体的生成过程中,BIRT 引擎分为两步,先是根据 .rptdesign 文件中的定义生成数据,再把这些数据以某种格式显示出来。一般情况下,这两步是一起完成的。然而在测试中,我们主要关注的是报表逻辑,即数据是否正确。显示样式的验证则比较简单。因此,我们可以在编码的时候通过调用 BIRT API 来把这两步分开,使 BIRT 在计算出报表所包含的数据后,并不对其进行渲染显示,而是以 .rptdocument 文件格式保存下来,该文件中存放了报表内包含的所有数据。然后,可以通过编程访问该文件,读取其中数据,通过和预计算的结果比较,验证其正确性。
回页首
自动化测试项目工程结构
在大型项目中,产品的代码与测试的代码是分开的。通常自动化测试会在产品项目工程之外另外建立一个工程。对于 BIRT 报表自动化测试来说,一个典型的项目工程结构如图 1 所示(以 Eclipse 为例)
图 1. BIRT 自动化测试工程结构图
除了工程常规的 src 和 lib 目录外,BIRT 要能够运行,还需要 ReportEngine,该目录的内容可以在 BIRT runtime 的下载包里找到,直接拷贝过来即可。Rptdesign 目录存放 .rptdesign 报表设计文件,这些也就是我们要测试的报表文件,可以通过编写脚本把产品工程项目中的报表文件同步过来,也可以手动复制。最后就是 rptdocument 目录,该目录用于存放生成的 .rptdocument 文件,便于测试用例从中读取数据进行验证。
回页首
通过 rptdesign 文件来生成 rptdocument
通过 API 来使用 BIRT 之前,先要得到 BIRT 的 engine,代码如下,其中 ENGINEHOME 就是 ReportEngine 所在的目录路径。
清单 1. 获得 BIRT 的工作引擎
EngineConfig config = new EngineConfig(); config.setEngineHome(ENGINEHOME); try { Platform.startup(config); } catch (Exception e) { e.printStackTrace(); //handle the exception here } IReportEngineFactory factory = (IReportEngineFactory) Platform .createFactoryObject(IReportEngineFactory.EXTENSION_REPORT_ENGINE_FACTORY); IReportEngine engine = factory.createReportEngine(config);
在得到 engine 之后,就可以运行报表了。BIRT API 提供了一个 RunTask 类来负责从报表设计文件中计算出报表的数据。代码如下所示。其中 designFile 是 .rptdesign 文件名。DocumentFile 是生成的 .rptdocument 文件名。
清单 2. 生成 .rptdocument 文件
IReportRunnable runnable = engine.openReportDesign(designFile); IRunTask task = engine.createRunTask(runnable); task.run(documentFile);
这样,我们就能够得到包含报表数据的 .rptdocument 文件了。然后就可以编写测试用例进行验证。
回页首
读取 rptdocument 文件数据进行验证
rptdocument 文件内容根据 rptdesign 的不同而有所区别,测试用例的写法也不一样。以下以 BIRT help 教程中的 Tutorial3 Inventory 报表为例讲述如何读取其数据进行自动化测试。该报表使用预览视图时内容如图 2 所示。
图 2. Inventory 报表内容预览
BIRT API 中提供了 DataExtractionTask 来从 rptdocument 中提取数据。
清单 3. 建立数据读取任务
IReportDocument reportDocument = engine.openReportDocument(documentFile); IDataExtractionTask dataExtractionTask = engine.createDataExtractionTask(reportDocument);
而在这过程中,BIRT 是按照不同的 DataSet 来分别提取数据的,在本例中,该报表最后的结果只有一个 Dataset。让 DataExtractionTask 来选中这个 Dataset
清单 4. 选择数据集
List<?> list = dataExtractionTask.getResultSetList(); IResultSetItem resultSetItem = (IResultSetItem) list.get(0); String resultSetName = resultSetItem.getResultSetName(); dataExtractionTask.selectResultSet(resultSetName);
每一个 Dataset 是由多个数据列组成的。DataExtractionTask 可以从中选取部分数据列来提取数据,在这个例子中,我们选取提取所有数据列中的数据。
清单 5. 选择数据列
IResultMetaData resultMetaData = resultSetItem.getResultMetaData(); int columnCount = resultMetaData.getColumnCount(); String[] columnNames = new String[columnCount]; for (int i = 0; i < columnCount; i++){ columnNames[i] = resultMetaData.getColumnName(i); } dataExtractionTask.selectColumns(columnNames);
这样,我们就可以开始提取数据了,BIRT 会返回一个迭代器,每次迭代都会取到一行数据,然后通过 getValue(index) 方法得到这行数据中的某一个值。下面的代码把整个数据集全部取出来,与预先算得的结果进行比较。在实际使用中,数据集可能很大,因此可以根据情况只比较中间的一部分。
清单 6. 获取报表中的数据
IExtractionResults extractionResults = dataExtractionTask.extract(); IDataIterator dataIterator = extractionResults.nextResultIterator(); StringBuffer stringBuffer = new StringBuffer(); while (dataIterator.next()){ for (int j = 0; j < columnNames.length; j++){ Object object = dataIterator.getValue(j); if (object != null){ stringBuffer.append(object.toString()); if (j < columnNames.length - 1){ stringBuffer.append("|"); } } } stringBuffer.append("\n"); } assertEquals(stringBuffer.toString(), actualResult);
其中 actualResult 代表该数据集的字符串表示,是预期的正确结果。
回页首
给报表设置参数
报表的内容通常会随着用户输入参数的不同而变化,这也是报表的一个重要特性。测试的时候我们也需要给报表输入不同的参数,尽量覆盖各种可能的情况,看报表的数据是否正确。
使用 BIRT API 给报表设置参数非常简单,调用其 task 对象的 setParameterValue 方法即可。在本例 Inventory 报表中,有一个 RP_quantityinstock 的参数,它表示找到库存中数量少于这个参数值的物品,并把它们显示在报表上。以下代码表示设置这个参数值为 500。
清单 7. 设置报表参数
IRunTask task = engine.createRunTask(runnable); task.setParameterValue("RP_quantityinstock", 500); task.run(documentFile);
回页首
改变报表的数据源
在实际工程应用中,我们制做的报表一般不会把数据源给写死,而是使用 JNDI 等技术统一管理配置数据源。这样可以增加报表的灵活性,使其方便的连接到不同的数据源上。而在测试的时候,我们需要让报表连到某个特定的测试数据库,这样我们就可以预先知道报表的运行结果来进行对比测试。因此,在编写自动化测试用例时,我们需要改变报表数据源的配置,让其指向我们准备好的测试数据库。
设置数据源的代码相对复杂一些,首先要通过 ReportRunnable 对象得到其 ReportDesignHandle 对象,该对象管理报表设计中的各项元素。然后通过该对象找到数据源对象 OdaDataSourceHandle,其中参数“Data Source”表示数据源的名字。最后我们就可以对数据源对象进行配置了,下面的代码显示如何把数据源改变为 BIRT 自带的示例数据库。
清单 8. 给报表设置数据源
IReportRunnable runnable = engine.openReportDesign(designFile); ReportDesignHandle design = (ReportDesignHandle) runnable.getDesignHandle().getModuleHandle(); OdaDataSourceHandle dsh = (OdaDataSourceHandle)design.findDataSource("Data Source"); dsh.setProperty("odaURL", "jdbc:classicmodels:sampledb"); dsh.setProperty("odaUser", "ClassicModels"); dsh.setProperty("odaDriverClass", "org.eclipse.birt.report.data.oda.sampledb.Driver");
回页首
小结
本文介绍了对 BIRT 报表进行自动化测试的方法和最佳实践。编写自动化测试用例在一开始会比较困难,但是一经完成可以大大提高测试效率和质量,降低成本,一劳永逸。特别是在大型项目中,报表的自动化测试显得更为重要。
这篇关于BIRT 报表的自动化测试的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!