如何在VS2013中进行Boost单元测试

  对于如何在VS2013中进行Boost单元测试,这方面资料太少。自己也因此走了不少弯路。下文将会阐述一下如何在VS2013中进行Boost单元测试。

  在开始Boost单元测试之前,我们需要先安装VS2013插件Boost Unit Test Adapter (Update 3) 以及编译Boost库。Boost Unit Test Adapte可以在VS2013中的“工具->扩展与更新”中找到并安装。对于Boost Unit Test Adapter所支持的Boost库版本请参考网页。我选择的是版本号为1.55.0的Boost库(可以在其官网下载得到)。在编译Boost库的时候,可以参考教程博文。我选择的是完全编译(bjam --toolset=msvc-12.0 --build-type=complete)。

  下文以几个步骤来阐述:

   1. 新建解决方案及工程

  接下来,我们新建一个BoostUnitTest解决方案,然后在该方案下添加(鼠标右击解决方案新建项目)两个项目。第一个项目是空的“WIN32”项目“Tested”,另一个是“Boost Unit Test Project”项目(新建项目->模板->Visual C++->Test下)“BoostUnitTest”。如下图:

  如何在VS2013中进行Boost单元测试

   2. 在被测试工程中添加文件

  在Tested工程中添加一个头文件tested.h及源文件tested.cpp. 具体代码如下

 #include <iostream>

 using namespace std;

 class Tested
{
public: Tested();
virtual ~Tested();
int add(const int a, const int b); private: };

tested.h

 #include "tested.h"

 Tested::Tested()
{ } Tested::~Tested()
{ } int Tested::add(const int a, const int b)
{
return a + b;
}

tested.cpp

  在这里,我们并不需要新建一个main函数对这个类tested进行测试(因为我们已经有单元测试了),但一个程序默认是需要main函数的,所以在需要在Tested项目属性中进行这样的设置(“配置类型”改为“动态库(.dll)”见下图):

  如何在VS2013中进行Boost单元测试

  接着,“生成”该工程,产生tested.obj文件。

   3. 配置Boost单元测试工程

  新建的Boost单元测试工程中有两个源文件“BoostUnitTestSample.cpp”及“BoostUnitTest.cpp”(还有stdafx.h、stdafx.cpp、targetver.h),前一个文件是样例,可以不要,后一个文件可以当作我们的单元测试源文件。

  先对该工程进行配置:

  1)添加“平台工具集”为"Visual Studio 2013 (v120)",见下图:

  如何在VS2013中进行Boost单元测试

  2)添加包含Boost库的根目录(在我电脑上是D:\boots_1_55_0),见下图:

  如何在VS2013中进行Boost单元测试

  3)添加Boost库目录及待测试工程的.obj文件所在目录,见下图:

  如何在VS2013中进行Boost单元测试

  4)添加“附加依赖项”“tested.obj”,见下图:

  如何在VS2013中进行Boost单元测试

   4. 进行Boost单元测试

  注:我们在这时只进行简单的单元测试,更加复杂的测试请参考文章最后给出的链接。  

  在BoostUnitTest工程中的文件“BoostUnitTest.cpp”(也可新建)添加如下代码:

 #define BOOST_TEST_MODULE Tested_Module                                // 主测试套件,一个测试项目中只能有一个主测试套件

 #include "stdafx.h"
#include "D:\VSProject\BoostUnitTest\BoostUnitTest\Tested\tested.h" // 待测工程头文件 struct Tested_Fixture // 测试夹具
{
Tested_Fixture()
{
BOOST_TEST_MESSAGE("setup fixture");
tmpTested = new Tested();
}
~Tested_Fixture()
{
BOOST_TEST_MESSAGE("teardown fixture");
delete tmpTested;
}
Tested * tmpTested;
}; BOOST_FIXTURE_TEST_SUITE(Tested_test, Tested_Fixture) // 测试套件 BOOST_AUTO_TEST_CASE( Tested_Method_add_Test) // 测试用例
{
// TODO: Your test code here
BOOST_WARN(tmpTested->add(, ) == ); // WARN型预言检测
BOOST_CHECK(tmpTested->add(, ) == ); // CHECK型预言检测
BOOST_REQUIRE(tmpTested->add(, ) == ); // REQUIRE型预言检测
} BOOST_AUTO_TEST_SUITE_END()

  点击“生成->生成解决方案”(预先打开“测试->窗口->测试资源管理器”)可以看到在“测试资源管理器”中出现了“BoostUnitTest”这个单元测试用例,如下图:

  注:如果电脑安装有杀毒软件(如360),“生成解决方案”的时候可能会提示:error LNK1104: 无法打开文件“...\BoostUnitTest\Debug\Tested.dll"。这是因为杀毒软件拦截了单元测试工程对被测试工程.dll文件的访问。比较简单的方法是将杀毒软件关闭就OK了。

  如何在VS2013中进行Boost单元测试

  点击“全部运行”,可以看到该测试用例变绿,说明测试通过,如下图:

  如何在VS2013中进行Boost单元测试

  如果我们将“BoostUnitTest.cpp”中的第13行改成:

BOOST_CHECK(tmpTested->add(, ) == );

  单元测试运行结果是不通过,如下图:

  如何在VS2013中进行Boost单元测试

  至此,如何进行一个简单的Boost单元测试的过程就完成了。

  // 添加于2014.10.18 ---------------------------------------------------------------------------

  现在,我在之前程序的基础上又添加了一点异常测试,相关的源代码如下:

 #include <iostream>

 using namespace std;

 class Tested
{
public: Tested();
virtual ~Tested();
int add(const int a, const int b);
void testException(); private: };

tested.h

 #include "tested.h"

 Tested::Tested()
{ } Tested::~Tested()
{ } int Tested::add(const int a, const int b)
{
return a + b;
} void Tested::testException()
{
throw logic_error("my throw"); // 抛出一个逻辑错误异常
}

tested.cpp

 #define BOOST_TEST_MODULE Tested_Module                                // 主测试套件,一个测试项目中只能有一个主测试套件

 #include "stdafx.h"
#include "D:\VSProject\BoostUnitTest\BoostUnitTest\Tested\tested.h" // 待测工程头文件 struct Tested_Fixture // 测试夹具
{
Tested_Fixture()
{
BOOST_TEST_MESSAGE("setup fixture");
tmpTested = new Tested();
}
~Tested_Fixture()
{
BOOST_TEST_MESSAGE("teardown fixture");
delete tmpTested;
}
Tested * tmpTested;
}; BOOST_FIXTURE_TEST_SUITE(Tested_test, Tested_Fixture) // 测试套件 BOOST_AUTO_TEST_CASE(Tested_Method_add_Test) // 测试用例
{
// TODO: Your test code here
BOOST_WARN(tmpTested->add(, ) == ); // WARN型预言检测
BOOST_CHECK(tmpTested->add(, ) == ); // CHECK型预言检测
BOOST_REQUIRE(tmpTested->add(, ) == ); // REQUIRE型预言检测 } BOOST_AUTO_TEST_CASE(Tested_Method_testException_Test) // 测试用例
{
// TODO: Your test code here
BOOST_REQUIRE_NO_THROW(tmpTested->testException()); // 验证是否无异常抛出,是则为真
BOOST_REQUIRE_THROW(tmpTested->testException(), logic_error); // 验证抛出的是否是logic_error异常
BOOST_REQUIRE_THROW(tmpTested->testException(), runtime_error); // 验证抛出的是否是runtime_error异常 } BOOST_AUTO_TEST_SUITE_END()

BoostUnitTest.cpp

  很显示,程序的运行结果如下:

 BOOST_REQUIRE_NO_THROW(tmpTested->testException());              // 测试不通过
BOOST_REQUIRE_THROW(tmpTested->testException(), logic_error); // 测试通过
BOOST_REQUIRE_THROW(tmpTested->testException(), runtime_error); // 测试不通过

  如果要进行更复杂的测试,可以参考官方文档

  还有一些个人觉得比较好的参考资料:

  Boost Test Library 中文手册

  DeveloperWorks的“了解Boost单元测试框架”;

  博文“单元测试分享”;

  博文“Boost学习总结(C++)”;

  博文“面向C++的测试驱动开发”。

  连载“单元测试实践的主要问题与解决”。

上一篇:python 学习笔记_2 模拟socket编程 服务端、客户端通信(参考核心编程2代码实现)


下一篇:1613. For Fans of Statistics(STL)