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

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

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

  ·JNDI 测试固件(JNDI Fixture):用于模拟从JDNI环境中获取对象的测试固件。

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

  ·自定义测试固件(Custom Fixture):用户自定义的测试固件。

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

  JDBC测试固件

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

  为了创建JDBC测试固件,我们先创建一个JDataStore的数据库,其数据文件位于/db/hr.jds,这个数据库的用户名和密码是:sysdba/123456。hr.jds数据库中有一张EMPLOYEE的表,其结构如下所示:

  图 错误!文档中没有指定样式的文字。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图标,启动创建向导,其对话框如下所示:

  图 错误!文档中没有指定样式的文字。指定JDBC测试固件类名

    在Class name中为JDBC测试固件指定类名:HrJdbcFixture,接受其他的默认设置,按Next到下一步。

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

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



  图 错误!文档中没有指定样式的文字。指定数据库连接信息

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

  ·URL:点击其后的…按钮,弹出Create URL for DataStore对话框,如下图所示:

  图 错误!文档中没有指定样式的文字。构造DataStore数据连接URL的对话框

  该对话框的设置内容会随着数据库类型的不同而变化。对于JDataStore数据库,该对话框提供了两个选项,如果数据库文件放在本机上时用第一个设置项,否则用第二个设置项。我们选择第一种选项,点击其后的…按钮,导航到/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文件,将其放置在/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选择不同的测试固件。


  图 错误!文档中没有指定样式的文字。选择测试固件

  按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图标启动创建比较固件类的向导,其对话框如下所示:

  图 错误!文档中没有指定样式的文字。指定比较固件名及属性

  ·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步,你将看到如下的对话框:

  图 错误!文档中没有指定样式的文字。选择测试Employee类的构造函数

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

  列表中列出了工程的所有的测试固件,选择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。