技术开发 频道

对Ajax 应用程序进行单元测试

  若想从 GWTTestCase 的测试魔力中获益,需要遵守一些规则。幸运的是,规则很简单:

  所有用于实现测试的类和待测 GWT 模块必须位于同一个包内。

  运行测试时,您必须至少传递一个 VM 参数,指明在哪种 GWT 模式(托管或 Web)下运行测试。

  您必须实现 getModuleName() 方法,它返回一个 String,表示您的 XML 模块文件。

  最后,因为与服务器端实体通信的 Ajax 应用程序在本质上是异步的,GWT 还提供了 Timer 类,以便延迟 JUnit,使异步行为在进行相关断言之前全部完成。

  实现 getModuleName 和 Timer 类

  我已经指出,我的测试集中于 getDefinition() 方法(如 清单 4 所示)。您可以从代码看到,测试逻辑非常简单:传入一个单词(比如 pugnacious),然后验证相应的 Label 文本是否得到正确定义。很简单,对吗?但是不要忘记,getDefinition() 方法在 AsyncCallback 对象中具有某种相关的异步性。

  GWTTestCase 类是一个抽象 类,因为它的 getModuleName() 方法就是这么声明的;因此,当您扩展该类时,您需要实现 getModuleName()(除非您是在为框架创建自己的基抽象类)。模块名实际上就是您的 GWT XML 文件所在的包结构的名称去掉文件扩展名。举个例子,在本例中,我有一个名为 WordModule.gwt.xml 的 XML 文件,它位于一个目录结构如:com/acme/gwt。相应的,模块的逻辑名称为 com.acme.gwt.WordModule,这会让您想到 Java 平台的普通包模式。

  我已经得到一个模块名,可以开始定义测试用例了,如清单 5 所示:

  清单 5. 您必须实现 getModuleName 方法并提供一个有效的名字

1 import com.google.gwt.junit.client.GWTTestCase;
2 import com.google.gwt.user.client.Timer;
3
4 public class WordModuleTest extends GWTTestCase {
5
6 public String getModuleName() {
7    return "com.acme.gwt.WordModule";
8 }
9 }
10

  到目前为止一切良好,但是我还没有执行任何测试!由于我的 Ajax 应用程序使用 AsyncCallback 对象,在通过测试用例调用 getDefinition() 方法时, 我必须强迫 JUnit 延迟运行;否则测试将由于没有任何响应而失败。这就要用到 GWT 的 Timer 类。Timer 使我能够重写 getDefinition() 的 run 方法,在 Timer 内完成测试用例逻辑。(测试用例以独立线程运行,有效地阻塞 JUnit 完成整个测试用例)。

  以我的测试为例,我将首先调用 getDefinition() 方法,然后提供一个 Timer 的 run() 方法的实现。run() 方法得到输出 Label 实例的文本并验证是否是正确定义。定义了 Timer 实例后,我就需要确定其何时运行,同时强制 JUnit 挂起直至 Timer 实例完成。也许听起来有点复杂,不必担心,因为实践起来非常简易。实际上,清单 6 展示了整个过程:

  清单 6. 使用 GWT 轻松测试

1 public void testDefinitionValue() throws Exception {
2 WordModule module = new WordModule();
3 module.getDefinition("pugnacious");
4 Timer timer = new Timer() {
5    public void run() {
6     String value = module.getOutputLabel().getText();
7     String control = "inclined to quarrel or fight readily;...";  
8     assertEquals("should be " + control, control, value);
9     finishTest();
10    }
11   };
12   timer.schedule(200);
13   delayTestFinish(500);
14 }
15

  正如您所见,Timer 的 run() 方法是我真正验证 Ajax 应用程序功能及其应用远程过程调用的地方。请注意 run 方法的最后一步是调用 finishTest() 方法,它意味着一切如预期运行,JUnit 可以不受阻塞正常运行。在实践中,您可能会发现需要根据异步行为完成所需的时间调整延迟时间。但用 JUnit 测试 GWT 应用程序的要点在于:您能够在无需 部署完整功能的 Web 应用程序的情况下测试它。因此,您能够更早地 并且更 频繁地 测试您的 GWT 应用程序。

0