什么是桩

  桩,或称桩代码,是指用来代替关联代码或者未实现代码的代码。如果函数B用B1来代替,那么,B称为原函数,B1称为桩函数。打桩是编写或生成桩代码。

  打桩的目的

  打桩的目的主要有:隔离、补齐、控制。

  隔离是指将测试任务从产品项目中分离出来,使之能够独立编译、链接,并独立运行。隔离的基本方法是打桩,将测试任务之外的,并且与测试任务相关的代码,用桩来代替,从而实现分离测试任务。例如函数A调用了函数B,函数B又调用了函数C和D,如果函数B用桩来代替,函数A可以完全割断与函数C和D的关系。

  补齐是指用桩来代替未实现的代码,例如,函数A调用了函数B,而函数B由其他程序员编写,且未实现,那么,可以用桩来代替函数B,使函数A能够运行并测试。补齐在并行开发中很常用。

  控制是指在测试时,人为设定相关代码的行为,使之符合测试需求。例如:

externint B();

int A()
{
      int ret = B();
      if(ret == 0)
           ;//do something
    elseif(ret == 1)
           ;//do something
    else
           ;//do something

      return ret;
}

  如果函数B返回随机数,或者返回网络状态,或者返回环境温度,等等,则当调用其实际代码时,函数A很难测试,这时可以用桩函数B1来代替B,使其返回测试所需要的数据。

  一个桩函数,可能既具有控制功能,又具有隔离或补齐功能。

  编写桩

  一般来说,桩函数要具有与原函数完全一致的原形,仅仅是实现不同,这样测试代码才能正确链接到桩函数。

  用于实现隔离和补齐的桩函数一般比较简单,只需把原函数的声明拷过来,加一个空的实现,能通过编译链接行了。

  比较复杂的是实现控制功能的桩函数,要根据测试的需要,输出合适的数据,下面是一个示例:

  //获取环境温度。温度由出参pTemperature输出,返回值表示获取温度是否成功,如果成功,则返回1,否则返回0。

int GetTemperature(int* pTemperature)
{
      if(caseNameIs("failed"))
           return 0;

      if(caseNameIs("ok-23"))
      {
           *pTemperature = 23;
           return 1;
      }

      if(caseNameIs("ok-25"))
      {
           *pTemperature = 25;
           return 1;
      }

      if(caseNameIs("ok-28"))
      {
           *pTemperature = 28;
           return 1;
      }

      return 0;
}

  其中,caseNameIs()是由测试工具提供的API,用于判断用例的名称。代码根据用例名称来决定输出数据。