将 JUnit 插件集成到 WebSphere Studio 中

Sunil Mahamuni, 高级软件工程师, IBM Global Services India
Pagadala J. Suresh, 软件工程师, IBM Global Services India

2003 年 6 月 01 日

Junit 是一个开放源代码的、并被业界认可的 Java™ 单元测试框架。IBM® WebSphere®Studio Application Developer（以下称为 Application Developer）是基于开放标准的 Eclipse 体系结构的下一代 IDE。本文旨在阐明如何在 Application Developer 中集成 JUnit 插件，并使用 JUnit 测试一个样本类。

引言

Junit 是一个开放源代码的、并被业界认可的 Java™ 单元测试框架。IBM® WebSphere®Studio Application Developer（以下称为 Application Developer）是基于开放标准的 Eclipse 体系结构的下一代 IDE。本文旨在阐明如何在 Application Developer 中集成 JUnit 插件，并使用 JUnit 测试一个样本类。

先决条件

硬件

500 Mhz 奔腾 P3 处理器
256 MB 内存

软件

Windows NT® 4.0 或 Windows® 2000
WebSphere Studio Application Developer 4.0 版（4.01 版和 4.02 版亦可，但某些屏幕图像与本文所示略有差别）

技术水平

您需要知道如何在 Application Developer 中进行一些简单的任务，例如打开一个透视图或者创建一个 Java 类。

将 JUnit 集成进 Application Developer

从 eclipse.org处下载下列文件：
- org.junit.zip （使用 org.junit）包含 JUnit 测试框架的插件。
- org.eclipse.jdt.junit1.0.0.zip （使用 org.eclipse.jdt.junit）包含从 Eclipse 中启动 JUnit 测试并查看测试结果的插件。
将以上文件解压缩至 Application Developer 的 plugins 目录： <Appliation Developer>\plugins 。
打开 Application Developer 工作台。
选择 Window => Preferences。
在 Preferences 窗口中，选择 Plug-in development。
右边的窗格会显示所有已装入的插件。单击 Reload重新装入 JUnit 插件。
重新装入以后，在已装入插件列表中查找下列各项：
- JUnit Testing Framework
- org.eclipse.jdt.junit
  图 0. 重新装入插件
重新启动 Application Developer。
选择 Perspective => Show view => Other => Java。
在 Java 透视图中，找到 JUnit 视图。

运行测试案例

1. 设置用来运行测试案例的项目

打开 Java 透视图。
创建一个 Java 项目，命名为 SampleJavaProject 。
在该项目的上下文菜单中，选择 Properties。
在 Java 的 Properties 窗口中，选择 Java build path。
在右边的窗格中，选择 Libraries选项卡。
单击 Add External JAR。
从 <Application Developer>\plugins\org.junit\ 目录中选择 junit.jar。
想要看到 JUnit 的源代码，您需要从上述目录中添加 src.jar。
添加了 junit.jar 和 src.jar 之后，再将它们添加至库中，如下面图 1 中突出显示的部分所示。
在所选项目的 Properties 窗口中，单击 OK。

图 1. Java build path

2. 创建一个样本类

打开 Java 透视图。
在前面创建的 SampleJavaProject 项目的 test.sample 包中创建一个名为 SampleJavaClass Java 类。

在 Java 编辑器中打开 SampleJavaClass，添加下列代码并保存。

package test.sample;
                public class SampleJavaClass {
                /**
                * Constructor
                */
                public SampleJavaClass() {
                super();
                }
                /**
                * Adds two numbers. This method is tested
                * by sample test cases.
                */
                public int add(int a, int b) {
                return a + b;
                }
                }

SampleJavaClass 包含 add() 方法，该方法在样本测试案例中使用。

3. 创建样本测试案例

打开 Java 透视图。
在 SampleJavaProject 项目的 test.testcase 包中创建一个名为 SampleJavaTestCase Java 类。

在 Java 编辑器中打开 SampleJavaTestCase，添加下列代码并保存。

package test.testcase;
                import junit.framework.TestCase;
                importtest.sample.SampleJavaClass;
                public class SampleJavaTestCase extends TestCase {
                /**
                * Constructor for SampleJavaTestCase
                */
                public SampleJavaTestCase(String name) {
                super(name);
                }
                /**
                * Test to test the method add in Sample Java Class
                */
                public void testAdd() {
                SampleJavaClass samp = new SampleJavaClass();
                int c = samp.add(2, 3);
                assertEquals(c, 5);
                }
                /**
                * Test to test the method add in Sample Java Class.
                * In this test, wrong expected value is given in
                * assert statement, assertEquals(c, 10), to demonstrate assert statement.
                */
                public void testAdd1() {
                SampleJavaClass samp = new SampleJavaClass();
                int c = samp.add(2, 3);
                assertEquals(c, 10);
                }
                /**
                * Main method to run Test Case in JUnit
                * Frame Work
                */
                public static void main(String[] args) {
                junit.textui.TestRunner.run(new SampleJavaTestCase(""));
                }
                }

assertEquals 语句用来验证结果与预期输出是否一致：
assertEquals(actualOutput, expectedOutput);
如果 actualOutput 和 expectedOutput 不匹配，它将在输出中列出测试失败情况。
上面的测试案例中包含 SampleJavaClass 中关于 add() 方法的两个测试。 testAdd() 演示了一个成功测试的输出， testAdd1() 演示了一个失败测试的输出。

4. 运行测试案例

打开 Java 透视图。
请确保下面两个类编译正确：
- test.sample.SampleJavaClass
- test.testcase.SampleJavaTestCase
在 Packages 视图中，选择测试案例 SampleJavaTestCase。
在工具栏中选择 Run => Junit tests。
如果 Debug 透视图已打开，请返回 Java 透视图。
JUnit 视图打开显示测试案例的结果。
提示：当程序以 Run 方式启动时请关闭 Window =>Preferences => Debug => Show Debug perspective选项，这样在执行过测试案例后就不会再显示 Debug 透视图。