服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

jbuilder2005单元测试之创建测试固件

  在测试用例中通过setup()、teardown()创建测试固件,只能使这个测试固件在单个测试用例的不同测试方法中共用,如果有多个测试用例都需要使用相同的测试固件,就需要将测试固件抽取到一个独立的类中。jbuilder提供了3个预定义的测试固件类,它们分别是:

  ?jdbc测试固件(jdbc fixture):用于获取数据库连接的测试固件,用户仅需要通过设置一些数据库信息,就可以用方便的方法获取数据连接。

  ?jndi 测试固件(jndi fixture):用于模拟从jdni环境中获取对象的测试固件。

  ?比较测试固件(comparision fixture):将测试输出到外部文件中,以便第二次测试时进行比较。

  ?自定义测试固件(custom fixture):用户自定义的测试固件。

  如果对junit的框架结构非常了解,也许这些jbuilder扩展的测试固件对你来说意义并不大,它们无非是构建一些常见的测试环境罢了,你完全可以自己编写。在本节里,我们介绍两个测试固件。

  jdbc测试固件

  如果你的工程中已经有一个获取数据连接的公共类,你也有必要构建一个jdbc测试固件,因为jdbc测试固件不但可以直接通过创建测试用例的向导直接指定,此外,jdbc测试固件还提供了许多面向测试的方法。

  为了创建jdbc测试固件,我们先创建一个jdatastore的数据库,其数据文件位于<chapter25工程目录>/db/hr.jds,这个数据库的用户名和密码是:sysdba/123456。hr.jds数据库中有一张employee的表,其结构如下所示:

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。employee表的数据

  employee有3个字段,分别是id、name和age,分别是string、string和int类型,并按上图所示填入3条记录。

  为了演示jdbc测试固件的具体使用,我们设计两个业务类:employee和employeedao,尔后用jdbc测试固件为测试employeedao提供数据连接。这两个类的代码如下:

  代码清单 错误!文档中没有指定样式的文字。employee.java类

1. package chapter25.db;
2. public class employee
3. {
4.  private string id;
5.  private string name;
6.  private int age;
7.  public employee(string id, string name, int age) {
8.   this.id = id;
9.   this.name = name;
10.  this.age = age;
11.  }
12.  public string getid() {
13.   return id;
14.  }
15.  public string getname() {
16.   return name;
17.  }
18.  public int getage() {
19.   return age;
20.  }
21.  public boolean equals(object o) {
22.   if (o instanceof employee) {
23.    employee e1 = (employee) o;
24.    return id.equals(e1.getid()) && name.equals(e1.getname()) &&age == e1.getage();
25.   } else {
26.    return false;
27.   }
28.  }
29. }

  employee类用于描述employee表的一条记录,该类访问数据库的employeedao代码如下所示:

  代码清单 错误!文档中没有指定样式的文字。employeedao.java类

1. package chapter25.db;
2. import java.sql.*;
3. public class employeedao
4. {
5.  private connection conn;
6.  public employeedao(connection conn) {
7.   this.conn = conn;
8.  }
9.  public employee findbyid(string id) throws sqlexception
10.  {
11.   string sqlstr = "select * from employee where id ='"+id+"'";
12.   statement stat = conn.createstatement();
13.   resultset rs = stat.executequery(sqlstr);
14.   if (rs.next()) {
15.    return new employee(id,rs.getstring("name"),rs.getint("age"));
16.   }else{
17.    return null;
18.   }
19.  }
20. }

  为了节省篇幅,我们仅提供一个访问数据库的访问方法:findbyid(),即通过id查找employee对象。

  下面,我们利用jbuilder向导创建一个jdbc测试固件:

  1. file->new...->test->在test页中,双击jdbc fixture图标,启动创建向导,其对话框如下所示:

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。指定jdbc测试固件类名

  在class name中为jdbc测试固件指定类名:hrjdbcfixture,接受其他的默认设置,按next到下一步。

  2.设置连接数据库的信息。

  在这步里,jbuilder提供了大部分数据库驱动程序的选择和连接信息设置,其对话框如下所示:

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。指定数据库连接信息

  ?driver:选择borland.databstore.jdbc.datastoredriver类。jdbc测试固件提供了对大多数数据库的支持。其中下拉框中暂不可用的数据库驱动器类显示为红色,你可以通过配置工程扩展类库使它们可用。

  ?url:点击其后的…按钮,弹出create url for datastore对话框,如下图所示:

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。构造datastore数据连接url的对话框

  该对话框的设置内容会随着数据库类型的不同而变化。对于jdatastore数据库,该对话框提供了两个选项,如果数据库文件放在本机上时用第一个设置项,否则用第二个设置项。我们选择第一种选项,点击其后的…按钮,导航到<chapter25工程目录>/db/hr.jds并选择之,按ok返回向导主对话框窗口。

  ?user name:sysdba。

  ?password:123456。

  按对话框下的test connection测试连接,应该会返回一个success信息报告连接测试成功。按finish创建jdbc 测试固件,其代码如下所示:

  代码清单 错误!文档中没有指定样式的文字。hrjdbcfixture.java

1. package fixture;
2. import java.sql.*;
3. import java.io.*;
4. import com.borland.jbuilder.unittest.jdbcfixture;
5. public class hrjdbcfixture
6. extends jdbcfixture
7. {
8.  public hrjdbcfixture(object obj) {
9.   super();
10.  super.seturl("jdbc:borland:dslocal:d:/jtjb2005/chapter25/db/hr.jds");
11.  super.setdriver("com.borland.datastore.jdbc.datastoredriver");
12.  super.setusername("sysdba");
13.  super.setpassword("123456");

14. }
15.
16. public void setup() {
17.  super.setup();
18. }
19.
20. public void teardown() {
21.   super.teardown();
22.  }
23. }

  jdbc测试固件承继了com.borland.jbuilder.unittest.jdbcfixture,这个类的重要方法包括:

  ?dumpresultset():将一个resultset导到一个writer中,该方法接受两个参数,一个是resultset另一个是writer。

  ?getconnection():获取一个数据连接。

  ?runsqlbuffer():执行缓存于stringbuffer对象中的sql语句。

  ?runsqlfile():执行保存在文件中的sql语句,通过入参指定sql文件的地址。

  ?setdriver():设置jdbc驱动器。

  ?seturl():设置数据连接的url。

  ?setusername():设置用户名。

  ?setpassword():设置密码。

  提示:

  通过向导创建jdatastore的jdbc测试固件,虽然可以直接在对话框中选择com.borland.datastore.jdbc.datastoredriver驱动器,但运行这个jdbc测试固件时,jbuilder却报这样的错误信息:java.lang.classnotfoundexception: com.borland.datastore.jdbc.datastoredriver。原来是jbuilder通过向导创建jdbc测试固件时,并没有直接将驱动器类加载到工程类库中,所以你需要手工通过project->project properties...->paths中,将jbuilder类库中名为jdatastore类库项加到工程类库中。

  由于employee表的数据可能会随着测试的进行不断更改,这样在测试时测试规则就很难制定,因为规则的制定必须基于一个假设的环境。举个例子,我们现在要测试findbyid()方法,就必须知道employee表中有哪些数据,所以在测试开始时就必须创建好一些特定的数据。由于jdbc固件可以执行保存在外部文件中的sql,所以我们创建一个insert.sql文件,将其放置在<chapter25工程目录>/db/insert.sql下,文件的内容如下:

delete from employee;insert into employee values('0004','大山',23);insert into employee values('0005','英华',30);insert into employee values('0006','柯明',31);

  运行这个sql语句时,先清空employee表中的数据,然后再插入3条特定的记录。下面,我们来创建应用jdbc测试固件的testemployeedao测试用例类。

  1.在编辑器中激活employeedao。

  2.file->new...->test->双击test case图标启动创建测试用例的向导,在向导第1、2步为employeedao的创建一个名为testemployeedao的测试用例,这个测试用例对employeedao的findbyid()方法进行功能测试。

  3.在向导的第3步选择测试固件,在向导对话框中我们前面创建的hrjdbcfixture已经出现在列表中。你也可以通过对话框的add...和remove选择不同的测试固件。

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。选择测试固件

  按finish直接创建testemployeedao的测试用例,其代码如下所示:

  代码清单 错误!文档中没有指定样式的文字。testemployeedao.java,向导创建的测试用例类

1. package chapter25.db;
2. import junit.framework.*;
3. import fixture.*;
4. import java.sql.*;
5. public class testemployeedao extends testcase {
6.  private employeedao employeedao = null;
7.  hrjdbcfixture hrjdbcfixture;
8.  protected void setup() throws exception {
9.   super.setup();
10.  /**@todo verify the constructors*/
11.  employeedao = new employeedao(null);
12.  hrjdbcfixture = new hrjdbcfixture(this);
13.  hrjdbcfixture.setup();

14. }
15.
16. protected void teardown() throws exception {
17.  employeedao = null;
18.  hrjdbcfixture.teardown();
19.  hrjdbcfixture = null;

20.  super.teardown();
21. }
22.
23. public void testfindbyid() throws sqlexception {
24.  string id = "";
25.  employee expectedreturn = null;
26.  employee actualreturn = employeedao.findbyid(id);
27.  assertequals("return value", expectedreturn, actualreturn);
28.  /**@todo fill in the test code*/
29. }
30. }

  测试用例在setup()方法中实例化hrjdbcfixture对象,并调用其setup()方法初始化环境。只有jdbc测试固件的setup()方法执行后(第13),才可调用jdbc测试固件的其他方法,如getconnection()等,所以jdbc测试固件的setup()是其初始化方法。下面我们对这个testemployeedao进行改造,改造的代码如下粗体代码所示:

  代码清单 错误!文档中没有指定样式的文字。改造后的testemployeedao类

1. …
2. public class testemployeedao extends testcase {
3.  …
4.  protected void setup() throws exception {
5.   super.setup();
6.   hrjdbcfixture = new hrjdbcfixture(this);

7.   hrjdbcfixture.setup();
8.   employeedao = new employeedao(hrjdbcfixture.getconnection());
9.   hrjdbcfixture.runsqlfile("d:/jtjb2005/chapter25/db/insert.sql",true);

10. }
11. …
12. public void testfindbyid() throws sqlexception {
13.  employee expectemp = new employee("0004","大山",23);
14.  employee realemp = employeedao.findbyid("0004");
15.  assertnotnull(realemp);
16.  assertequals(expectemp,realemp);

17. }
18. }

  因为jdbc测试固件需要在setup()方法调用后,其他方法才可用,所以在testemployeedao的setup()方法中,我们将employeedao的实例化方法移到后面,以便实例化employeedao时可以通过hrjdbcfixture.getconnection()获取数据连接(第8行)。在第9行,执行insert.sql文件,清除表中原来的数据并插入3行测试数据。

  在第13~14行,通过employeedao的findbyid()方法查找返回id为0004的employee对象,在第15~16行设定两个测试规则。

  运行这个带jdbc测试固件的测试用例,hrjbdcfixture测试固件先准备好测试环境,然后再执行testemployeedao的testfindbyid()测试方法。

  比较测试固件

  比较固件用于记录下当前的测试记录,以便和下一次的输出比较。比较固件类继承于com.borland.jbuilder.unittest.testrecorder,而testrecorder类继承java.io.writer。所以如果在测试时,需要用writer输出信息就可以考虑使用比较固件了,它提供了许多易用的输出信息的方法。你可以通过向导来创建比较固件。

  testrecorder共有 4个记录模式的常量,它们分别是:

  ?update:比较固件将当前输出信息和已存在的信息文件相比较,如果文件没有存在则新创建一个文件,记录输出信息。

  ?compare:比较固件将当前输出的信息和已经存在的信息比较。

  ?record:比较固件记录当前输出的信息,如果原来已经有输出文件存在,覆盖之。

  ?off:关闭比较固件的功能。

  注意:

  在创建记录文件后,假设你更改了测试用例或测试套件,需要重新初始化这个输出文件:将testrecorder的输出模式设置为record,创建文件后再将其调整为update。输出的数据文件是二进制文件,放在和源程序文件相同的目录下且和测试用例类同名。

  下面是测试固件常用的方法,介绍如下:

  ?boolean print(string s)

  用testrecorder打印一个字符串,如果模式为record,且这个字符串和原来记录的不一致,则返回false。你可以设定这样的测试规则:

asserttrue(recorder.print(result.tostring())

  ?boolean println(string s)

  和print()相似,只不过添加一个换行。

  ?boolean compareobject(object o)

  调用传入对象的equals()方法和用前面用recordobject()记录的对象进行比较。

  ?boolean recordobject()

  记录一个对象,以便后面调用compareobject()方法进行比较。

  下面,我们创建一个比较固件,并应用这个比较固件为employee类创建一个测试用例。

  1.file->new...->test->在test页中,双击comparision fixture图标启动创建比较固件类的向导,其对话框如下所示:

jbuilder2005单元测试之创建测试固件
图 错误!文档中没有指定样式的文字。指定比较固件名及属性

  ?class name:测试固件类名,接受默认的comparisionfixture1。

  ?echo output to console:测试固件将信息同时输出到测试运行器的控制台上。

  ?verbose output:测试固件将输出详细的信息。

  此外,save comparision data in this directory指定比较输出信息文件的存放位置,可以通过其后的…按钮更改,这里我们接受默认的设置。按ok直接创建比较固件类,你代码如下所示:

  代码清单 错误!文档中没有指定样式的文字。?15 comparisonfixture1.java,向导创建的测试固件类

1. package fixture;
2. import com.borland.jbuilder.unittest.testrecorder;
3. public class comparisonfixture1 extends testrecorder
4. {
5.
6.  public comparisonfixture1(object obj) {
7.   super();
8.   super.setmode(update);
9.   super.setverbose(true);
10.  super.setecho(true);
11.  string filename = super.constructfilename("d:/jtjb2005/chapter25/test",obj);
12.  super.setoutputfile(filename);
13. }
14.
15. public void setup() {
16. }
17.
18. public void teardown() {
19. }
20. }

  第8行将模式设置为update,而第9,10行对输出属性作设置。第11~12行指定输出文件的目录。

  2.创建testemployee测试用例类。

  file->new...->test->在test页,双击test case图标启动创建测试用例向导,为employee类和构造函数创建testemployee测试用例类。在向导的第1步,你将看到如下的对话框:

jbuilder2005单元测试之创建测试固件
  图 错误!文档中没有指定样式的文字。选择测试employee类的构造函数

  点击next一直到向导的第3步:

       jbuilder2005单元测试之创建测试固件

  列表中列出了工程的所有的测试固件,选择hrjdbcfixture,点击remove删除这个固件,只留下comparisionfixture1的固件,点击finish直接创建testemployee测试用例类的代码框架,在代码框架基础上利用比较固件对employee进行测试,其最终代码如下所示:

  代码清单 错误!文档中没有指定样式的文字。应用比较固件的测试用例

1. package chapter25.db;
2.
3. import junit.framework.*;
4. import fixture.*;
5.
6. public class testemployee extends testcase {
7. private employee employee = null;
8. comparisonfixture1 comparisonfixture1;
9.
10.  protected void setup() throws exception {
11.   super.setup();
12.   employee = new employee("0004", "王五", 23);
13.   comparisonfixture1 = new comparisonfixture1(this);
14.   comparisonfixture1.setup();
15.  }
16.
17.  protected void teardown() throws exception {
18.   employee = null;
19.   comparisonfixture1.teardown();
20.   comparisonfixture1 = null;
21.   super.teardown();
22.  }
23.
24.  public void testemployee() {
25.   string id = "0004";
26.   string name = "王五";
27.   int age = 23;
28.   comparisonfixture1.print(employee.getid());
29.   comparisonfixture1.recordobject(employee);
30.   employee = new employee(id, name, age);
31.   asserttrue(comparisonfixture1.print(employee.getid()));
32.   asserttrue(comparisonfixture1.compareobject(employee));

33.  }
34. }

  在第12行实例化一个employee对象,在第28行保持并打印出原employee对象的id值,在第31行进行比较;第29行记录原employee对象,在第31行进行两对象的比较。

  运行testemployee类,在测试运行器的测试输出标签页中,你将可以看到输出的信息,在测试用例所在的文件夹下将创建一个无后缀名的输出文件employee。

扫描关注微信公众号