一、简介
JUnit是一款由Erich Gamma(《设计模式》的作者)和Kent Beck(极限编程的提出者)编写的开源的回归测试框架,供Java编码人员做单元测试之用,可以从www.junit.org网站上免费获得,本文使用的版本仍然是3.8.1。获得junit3.8.1.zip文件后,解压缩,需要其中的junit.jar文件,将该文件放到特定的文件夹中备用,我放到了我机器的G:/YPJCCK/JUnit/lib文件夹中。
由于我是编码人员,很多工作都工作都在Eclipse、JBuilder这样的IDE中完成,因此对JUnit的学习也是在Eclipse和JBuilder中进行的,而没有做环境变量或是命令行之类的配置。我Eclipse用的是3.1.1加语言包,可以到www.eclipse.org网站上下载;JBuilder用的是JBuilder 2006。
二、创建项目
下面打开Eclipse或JBuilder。
如果使用的是Eclipse,那么在Eclipse打开后,点击菜单“文件”->“新建”->“项目”,打开“新建项目”对话框:
请选中“Java项目”,点击“下一步”,进入“新建Java项目”对话框:
在这个对话框中需要设置项目的名称以及项目所在目录,我为自己的项目起名为JUnitTest,目录为G:/YPJCCK/JUnit/ Eclipse/JUnitTest。由于Eclipse自带了JUnit 3.8.1,因此此时点击“完成”即可。如果想使用自己下载的类库,请点击“下一步”,进入下一窗口。在这个窗口中选择名为“库”的选项卡,然后点击“添 加外部JAR”按钮,将保存于特定文件夹中的junit.jar文件引用进来。
设置好后,点击“完成”。至此,已经在Eclipse中创建了项目。
如果使用的是JBuilder,那么同样有两个选择,一个是使用 JBuilder自带的JUnit 3.8,一个是自己配置类库。如果自己配置类库,请在JBuilder打开后,点击菜单“Tools”->“Configure Libraries”,打开“Configure Libraries”对话框:
点击“New”按钮,打开“New Library Wizard”对话框:
使用“Add”按钮将保存于特定文件夹中的junit.jar文件引用进来,并设置Name,即该类库的名字,我将Name设置为JUnit, Location选择User Home。注意,JBuilder自带了名为JUnit的库,并放在了JBuilder下。设置好后点击“OK”按钮,回到“Configure Libraries”对话框,再点击“OK”按钮,则JUnit类库已经被添加到JBuilder当中。
下面继续,在JBuilder中创建项目。点击菜单“File”->“New Project”,打开“Project Wizard”对话框:
在这个窗口中设置项目名称及存放目录,我的项目名称仍为JUnitTest,路径为G:/YPJCCK/JUnit/JBuilder/JUnitTest。点击“Next”进入下一个窗口:
如果想使用自己下载的类库,请在这个窗口中选择“Required Libraries”选项卡,点击“Add”按钮,将刚才设置的JUnit库引用进来。下面点击“Next”按钮,进入下一个窗口:
在这个窗口中用鼠标点击Encoding下拉列表框,然后按一下“G”键,选中相应选项,此时该项目的字符集就被设置成GBK了。如果做的是国内项目,这绝对是个好习惯。最后点击“Finish”,项目创建完成。
三、编写用于测试的JavaBean
用于测试的JavaBean很简单,名为Book,只有id和name两个属性,这两个属性将分别用于两个用例当中。下面开始编写该JavaBean。
如果使用的是Eclipse,请点击“文件”->“新建”->“类”,打开“新建Java类”对话框,设置包为net.zheng.junit.test,名称为Book,并确保“public static void main(String[] args)”选项没有选中;如果使用的是JBuilder,请点击“File”->“New Class”,打开“Class Wizard”对话框,设置Package为net.zheng.junit.test,Class name为Book,并确保“Generate main method”选项没有选中。设置完成后,点击“OK”,修改代码如下:
package piv.zheng.junit.test;
public class Book {
private String id = null;
private String name = null;
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
至此,用于测试的JavaBean编写完成。
四、编写测试用例
这里只用了一个类进行测试,名为TestBook,该类继承自junit.framework.TestCase类。TestBook类包含两个用例, 分别对应该类的testId和testName方法,即每个方法实现了一个测试用例。注意,在JUnit中, junit.framework.TestCase的子类中每个用来实现测试用例的方法都必须以testXXX的格式来命名,这些方法在运行时会被执行。 此外,TestBook还包括setUp和tearDown这两个方法,前者在每个测试方法开始之前执行,多用来做初始化;后者在每个测试方法完成之后执 行,多用来清理资源。下面开始编写TestBook。
在Eclipse中,创建TestBook类有两种方法:方法一,像前边创建Book类 一样,点击“文件”->“新建”->“类”来创建;方法二,先在“包资源管理器”中选中Book类,然后点击“文件”->“新建”- >“JUnit测试用例”,打开“新建JUint测试用例”窗口:
此时你会发现,很多信息已经被Eclipse自动添加进来了。将名称改为TestBook,选中setUp()、tearDown()和 contructor(),如果想利用Eclipse自动创建测试方法,请点击“下一步”。由于本文会自行编写测试方法,因此请直接点击“完成”。
如果使用的是JBuilder,那么同样有两个方法:一个是点击“File”->“New Class”来创建;一个是确保Book.java文件被打开并选中,然后点击“File”->“New”打开“Object Gallery”对话框:
在左边的树型菜单中选中“Test”,在从右边选择“Test Case”,然后点击“OK”,打开“Test Case Wizard”对话框:
由于已选中Book.java文件,因此对话框中会出现与之相关的信息。由于本文将自行编写测试方法,因此不必进行任何选择,请直接点击“Next”,进入下一窗口:
这个窗口是用来设置测试类的,这里不需要修改,直接点击“Next”进入下一窗口:
这个窗口是用来指定测试类的超类的,这里不需要指定,点击“Next”进入下一窗口:
这个窗口时用来设置测试环境配置的,请将“Test runner”的选项由“JBuilder Test Runner”改为“JUnit SwingUI Test Runner”或“JUnit TextUI Test Runner”,否则无法看到测试效果。这里选择的是后者。其他不必修改,点击“Finish”。
创建TestBook类后,修改代码如下:
package net.zheng.junit.test;
import junit.framework.TestCase;
import junit.framework.Assert;
public class TestBook extends TestCase {
Book book = null;
//建议为测试类创建构造
public TestBook(String name) {
super(name);
}
protected void setUp() throws Exception {
//调用超类的setUp(),以确保测试环境被初始化
super.setUp();
System.out.println("测试开始!");
book = new Book();
System.out.println("book对象被初始化!");
}
protected void tearDown() throws Exception {
System.out.println("book对象将被清理!");
book = null;
System.out.println("测试结束!");
//调用超类的tearDown(),以确保测试环境被清理
super.tearDown();
}
public void testId() {
book.setId("001"); //设置id属性的值为001
//使用Assert查看id属性的值是否为001
Assert.assertEquals("001", book.getId());
System.out.println("id属性被测试!");
}
public void testName() {
book.setName("ASP"); //设置name属性的值为ASP
//使用Assert查看name属性的值是否为JSP,这是个必然出现错误的测试
Assert.assertEquals("JSP", book.getName());
System.out.println("name属性被测试!");
}
}
这 里setUp和tearDown方法没什么好说的,就是执行了对book对象的初始化和清理,不过testId和testName需要说明一下。前者是在 对book的id属性进行测试,首先赋值为”001”,然后使用Assert的assertEquals方法查看id属性中存放的值是否是期待的值,由于 我的期待值也是”001”,所以执行后这个用例应该是成功的;后者则是对book的name属性进行测试,也是首先赋值为”ASP”,然后使用 Assert的assertEquals方法查看其值是否是期待的,由于我特意将期待值设定为根本不可能的”JSP”,因此这个用例执行后会出现一个错 误。但请注意,由于我是特意要让测试出现错误,所以将期待值设定成了不可能的值,如果你是测试人员,请千万不要这么做,否则如果别的地方导致了错误,很容 易给自己造成不必要的麻烦。
下面简单介绍一下上边用到的静态类junit.framework.Assert。该类主要包含8个方法:
1.assertEquals()方法,用来查看对象中存的值是否是期待的值,与字符串比较中使用的equals()方法类似;
2.assertFalse()和assertTrue()方法,用来查看变量是是否为false或true,如果assertFalse()查看的变量的值是false则测试成功,如果是true则失败,assertTrue()与之相反;
3.assertSame()和assertNotSame()方法,用来比较两个对象的引用是否相等和不相等,类似于通过“==”和“!=”比较两个对象;
4.assertNull()和assertNotNull()方法,用来查看对象是否为空和不为空;
5.fail ()方法,意为失败,用来抛出错误。我个人认为有两个用途:首先是在测试驱动开发中,由于测试用例都是在被测试的类之前编写,而写成时又不清楚其正确与 否,此时就可以使用fail方法抛出错误进行模拟;其次是抛出意外的错误,比如要测试的内容是从数据库中读取的数据是否正确,而导致错误的原因却是数据库 连接失败。
五、运行TestBook
编写好TestBook后,就可以运行了。如果用的是Eclipse,那么您可以点击运行按钮旁边的倒三角,选择“运行为”->“1 JUnit测试”,此时运行效果如下图:
在图片的左侧可以看到“JUnit”一栏,而且里边还有一个错误。不过这个错误是预计之内的,如果不想看到,可以将testName()方法中的”JSP”改成”ASP”,此时的运行效果如下图:
此时您会看到,“JUnit”栏中的进度条已不是红色,而是绿色的,这说明已经没有错误了。
如果用的是JBuilder,那么在TestBook类的选项卡上点击鼠标右键,选择“Run Test using “TestBook.java””,测试信息会从Message窗口输出:
六、测试套件
当有多个测试类需要一次性进行测试时,可以使用测试套件来完成这项工作。
在Eclipse中,点击“文件”->“新建”->“其它”,打开“新建”对话框:
在“向导”中选择Java/JUnit/JUnit测试套件,然后点击下一步,进入“信件JUnit测试套件”窗口:
此时会发现,测试类已由Eclipse自动加载进来了。点击“完成”。
如果使用的是JBuilder,请点击“File”->“New”打开“Object Gallery”对话框:
在左边的树型菜单中选中“Test”,在从右边选择“Test Case”,然后点击“OK”,打开“Test Suite Wizard”对话框:
JBuilder会自动将测试类加载进来,请直接点击“Next”,进入下一窗口:
这个窗口是用来设置测试套件的,将Class name改为AllTests。由于这里使用了之前的测试环境配置,直接点击“Finish”即可。如果想另外进行设置,请点击“Next”进入下一窗口:
“Create a runtime configuration”默认没有选中,请选中然后进行设置。最后点击“Finish”。
由 于这里直接使用了Eclipse和JBuilder所创建的代码,因此就不展示了。运行方法与之前运行测试类一样。不过若是对测试环境进行过配置,此时 JBuilder与之前相比会稍有变化,应在快捷菜单中选择“Run Test”下的“Use “AllTests””。
七、更多运行方法
JUnit自身也提供有运行环境。在Eclipse中新建一个带有main()方法的类,我建的类名称为Test,代码如下:
package net.zheng.junit.test;
import junit.framework.*;
public class Test {
public static void main(String[] args) {
//使用TestSuite组装测试类
TestSuite ts = new TestSuite();
ts.addTestSuite(TestBook.class);
//textui,命令行方式
junit.textui.TestRunner.run(ts);
//swingui,Swing方式
//junit.swingui.TestRunner.run(ts.getClass());
//awtui,AWT方式
//junit.awtui.TestRunner.run(ts.getClass());
}
}
其 中TestSuite是用来组织测试类的,通过其addTestSuite()方法将测试类添加到ts对象中,凡是添加到ts中的测试类都将在 junit.textui.TestRunner.run()时被执行。如果您创建了之前的测试套件,应该会看到类似的代码。此外,您也可以在定义ts对 象时利用其构造函数将测试类添加给ts对象,例如:
TestSuite ts = new TestSuite(TestBook.class);
这 并不会影响到后续使用addTestSuite()方法。再有,JUnit提供了三种运行方式,junit.textui.TestRunner是命令行 方式的,junit.swingui.TestRunner和junit.awtui.TestRunner是可视化方式的,后两个这里已经注释掉了,如 果您想查看效果,可以将注释去掉。
如果您在使用JBuilder,也请建立一个Test类。编写好后,在Test类的选项卡上点击鼠标右键,在调出的快捷菜单中点击“Run using defaults”,稍等片刻,就会看到运行效果了。
八、小结
其实JUnit上手很容易,远比想象的要简单的多,但我觉得如何编写测试类是很需要经验的,因为许多时候,测试一个用例,但涉及到可能不止一个类;而有 些时候,一个类可能是做为工具使用,里边涉及很多内容,那么测试时是否还是只编写一个测试类呢?关于这个话题,我想应该是仁者见仁、智者见智的,其实这才 是测试的难题所在。