如何使用MOQ进行单元测试

使用MOQ来伪装和隔离被依赖对象，从而提高被测对象的测试效果。

 

安装

通过http://code.google.com/p/moq可以下载MOQ的最新版本。在SSL项目中，我们使用的是MOQ 3.1.416.3版本。在SCM中项目目录下的Lib目录下有该工具的二进制版本。直接在单元测试项目中引用即可。

 

准备工作

如果你需要测试项目中的Internal成员，你需要在AssemblyInfo.cs中添加如下的Attribute:

#if DEBUG
[assembly: InternalsVisibleTo("DynamicProxyGenAssembly2,PublicKey=00240000048000009400000006020000002400005253" +
"41310004000001000100c547cac37abd99c8db225ef2f6c8a3602f3b3606cc9891605d02baa56104f4cfc0734aa39b93bf7852f7d9266" +
"654753cc297e7d2edfe0bac1cdcf9f717241550e0a7b191195b7667bb4f64bcb8e2121380fd1d9d46ad2d92d2d15605093924cceaf74c" +
"4861eff62abf69b9291ed0a340e113be11e6a7d3113e92484cf7045cc7")]
#endif

 

开始测试

一个单元测试的一般流程：

 

一般情况下，一个单元测试应该被分割为如下四个步骤：

• 准备
  • 搭建环境
  • 构造被测对象
  • 初始化被测对象
  • 构造Mock对象
  • 初始化Mock对象
  • 连接被测对象和依赖项
• 声明期待
  • 配置Mock（Mock<T>.Setup）对象以声明该Mock对象期待被怎样调用。
• 执行测试
  • 调用被测对象的方法，完成测试步骤
• 校验测试结果
  • 调用校验方法（Mock<T>.VerifyAll)对Mock对象上的期待动作进行校验。
  • 使用Assert方法对被测对象的状态进行校验。

 

一个单元测试的例子：

[TestMethod]
public void TestNavigationSyncWithSelection()
{
    // 测试如果修改Selection，那么NavigationService.MoveCurrentTo方法应该被调用。
    // 1. 准备
    // 1.1 搭建环境
    var c = new ServiceContainer();
    var dataManager = new SpreadSheetDataManager(32, 8);
    // 1.2 构造被测对象
    var selectionService = new SelectionService();
    // 1.3 初始化被测对象

    // 1.4 构造Mock对象
    var mockNavigationService = new Mock<INavigationService>();
    // 1.5 初始化和配置Mock对象
    c.AddService(mockNavigationService);
    mockNavigationService.Setup(s => s.CanMoveCurrentTo(It.IsAny<CellPosition>()))
        .Returns(true);

    // 1.6 连接被测对象和依赖项
    c.AddService<ISelectionService>(selectionService); // 这里隐式的将SelectionService和NavigationService连接在一起了。因为他们都被放到了一个容器里面。
    (selectionService as IService).Attach(c, dataManager);

    // 2. 声明期待
    mockNavigationService.Setup(s => s.MoveCurrentTo(new CellPosition(0, 1))); // navigationService的MoveCurrentTo方法期待被调用，并且参数为【0，1】。

    // 3. 执行测试
    selectionService.Select(new CellRange(0, 1, 2, 2));

    // 4. 校验
    // 4.1 校验Mock对象期待的动作被正确的调用了。
    mockNavigationService.VerifyAll();
    // 4.2 校验被测对象的状态。
    Assert.AreEqual(new CellRange(0, 1, 2, 2), selectionService.CurrentSelection);
}

 

推荐的单元测试写法

目前的单元测试中，往往准备工作很复杂，反而真正测试的工作比较简单。就像上面的例子中，准备的代码写了8行，其它真正测试所关心的代码却只有4行。这是一个非常不舒服的状态。但是，我也没有找到更好的方式来解决这个问题。只能说在架构上让各个模块的依赖尽可能的小，从而减少准备工作的量。

 

另一方面，通过在代码中适当的增加几行注释，可以很好的帮助阅读的人找到重点。我觉的如果整个团队都采用一致的编码习惯，阅读效率会提高很多。如下是上面的例子去除了多余的注释后的版本。

 

[TestMethod]
public void TestNavigationSyncWithSelection()
{
    // 测试如果修改Selection，那么NavigationService.MoveCurrentTo方法应该被调用。  << 简要的注释描述测试的重点，很多时候“人话”还是简练很多

    // Prepare
    var c = new ServiceContainer();
    var dataManager = new SpreadSheetDataManager(32, 8);

    var selectionService = new SelectionService();

    var mockNavigationService = new Mock<INavigationService>();
    c.AddService(mockNavigationService);
    mockNavigationService.Setup(s => s.CanMoveCurrentTo(It.IsAny<CellPosition>()))
        .Returns(true);

    c.AddService<ISelectionService>(selectionService);
    (selectionService as IService).Attach(c, dataManager);

    // Expect
    mockNavigationService.Setup(s => s.MoveCurrentTo(new CellPosition(0, 1)));

    // Act
    selectionService.Select(new CellRange(0, 1, 2, 2));

    // Verity
    mockNavigationService.VerifyAll();
    Assert.AreEqual(new CellRange(0, 1, 2, 2), selectionService.CurrentSelection);
}

 

 

扩展阅读：Mocks Aren't Stubs