上一篇内容中我们讲到伪对象，并写了一个伪对象，如果阅读文章的你刚刚手写完伪对象，那么我得告诉你，以后你都不需要再手写伪对象了（不得不说，手写伪对象至少能够加深对隔离框架的理解）。
何为隔离框架？
一个能够在运行时新建和配置伪对象的可重用的类库，它让开发者不用为了伪对象而编写重复的代码。
即：隔离框架可以替我们动态的生成需要的伪对象，节省很多精力。
选择隔离框架
目前市面上有很多隔离框架，可以根据团队情况选择，这里推荐Moq，主要基于以下原因：
- 强类型：不支持使用字符串来设置期望
- 不再需要学习录制/播放，只需要构建你自己的Mock，设置好你的期望，调用它，然后有选择地验证它们即可
- 不用去学习Mock、Stub之间的理论差异了
- 可以对接口和类进行Mock
- 重载期望：可以在全局设置时给Mock方法设置缺省的期望，在测试方法中可以根据需要对它进行重载。
- 它的学习曲线极低，大多数情况下，你甚至无须阅读文档。
- 免费开源
- ...
（如果之前没有了解过隔离框架，以上2、3点可暂时不予理会）
Moq使用
先来了解一下使用Moq的一般套路，定义以下接口：
public interface ITextReader
{
void BeginRead();
string Read();
void EndRead();
}
定义一个ITextReader的业务方：
public static bool IsValidHtml(ITextReader textReader)
{
var htmlString = textReader.Read();
return htmlString.Contains("html");
}
IsValidHtml方法依赖ITextReader接口来读取字符串，并判断字符串是否是合法html。
使用Moq来隔离ITextReader会多简单呢？
[TestMethod]
public void IsValidHtml_EmptyString_returnFalse()
{
//Arrange
//新建一个ITextReader的Mock对象，其Object属性即为我们需要的伪对象
var textReaderMock = new Mock<ITextReader>();
//对伪对象的方法进行mock
//当调用ITextReader接口的Read()方法时，将返回Empty字符串
textReaderMock.Setup(x => x.Read()).Returns(string.Empty);
//Action
//将伪对象注入到被测试方法中
var result = Document.IsValidHtml(textReaderMock.Object);
//Assert
Assert.IsFalse(result);
}
简单吧(●'◡'●)
接下来我们了解一下Moq提供的API
Setup+Return
请参见上面的例子Setup+Callback
当指定方法被调用时，可以收到一个回调函数，方法调用的参数将作为回调函数的参数传递。请看例子：
//被依赖的第三方接口
public interface IPaint
{
void AddElement(int element);
bool CouldBeSelected();
event Action<int, int> SelectionChanged;
}
//IPaint接口的业务方
private readonly IPaint _paint;
public Document(IPaint paint)
{
_paint = paint;
}
public void AddElements(IEnumerable<int> elements)
{
foreach (var i in elements.ToList())
{
_paint.AddElement(i);
}
}
//AddElements的单元测试方法
[TestMethod]
public void AddElements_MultiElements_ShouldCallAddElementsMultiTimes()
{
var paintMock = new Mock<IPaint>();
var input = new List<int>()
{
0,1,2,3,4
};
var expected = new List<int>();
//当调用IPaint接口的AddElement方法，且参数是任意int时，出发回掉函数
paintMock.Setup(x => x.AddElement(It.IsAny<int>())).Callback<int>(i =>
{
expected.Add(i);
});
var document = new Document(paintMock.Object);
document.AddElements(input);
CollectionAssert.AreEqual(input, expected);
}
- SetupSequence
设置对方法对连续调用的响应：
[TestMethod]
public void GetPaintCouldBeSelected_CallTwoTimes_ReturnTrueAndFalse()
{
var paintMock = new Mock<IPaint>();
//连续调用CouldBeSelected方法时，第一次返回true，第二次返回false
paintMock.SetupSequence(x => x.CouldBeSelected()).Returns(true).Returns(false);
var document = new Document(paintMock.Object);
var result = document.GetPaintCouldBeSelected();
Assert.IsTrue(result);
result = document.GetPaintCouldBeSelected();
Assert.IsFalse(result);
}
- Verify+Times
对一个方法调用次数进行验证：
[TestMethod]
public void AddElements_SingleElement_ShouldCallAddElement()
{
var paintMock = new Mock<IPaint>();
//将以任意int作为参数的AddElement方法的调用进行标记，在调用paintMock.Verify方法时对AddElement方法是否经过调用进行验证
paintMock.Setup(x => x.AddElement(It.IsAny<int>())).Verifiable();
//----------
//做了一些事情，比如调用了IPaint的AddElement方法
//----------
var document = new Document(paintMock.Object);
document.AddElements(new List<int>() { 1, 2, 3 });
//验证AddElement是否经过调用
paintMock.Verify();
}
当需要对调用次数做限制时，也可以使用另一种方式：
[TestMethod]
public void AddElements_SingleElement_ShouldCallAddElement()
{
var paintMock = new Mock<IPaint>();
paintMock.Verify(x => x.AddElement(It.IsAny<int>()), Times.Between(1, 3, Range.Inclusive));
//----------
//做了一些事情，比如调用了IPaint的AddElement方法
//----------
var document = new Document(paintMock.Object);
document.AddElements(new List<int>() { 1, 2, 3 });
//验证AddElement的调用次数是否为1-3
Mock.Verify(paintMock);
}
- It
It用于对参数进行限制，可以指定参数必须是什么类型，必须满足特定的正则，必须处于某个范围等，具体可参见API。
至此，Moq的基本API就完结了，是否很简单呢？
除了上面的部分，Moq还提供了一些功能，但是使用方法都跟上面的类似
Setup+Callbase（调用基类的方法）
SetupGet（获取属性）
SetupSet（设置属性）
...
Moq的限制
Moq的机制是对于Mock的接口，生成一个实现类，这个实现类里的方法都没有具体的实现，而是根据用户的设置直接返回。
由此我们可以得出Moq的限制：
- 必须是可以被继承的对象才能被mock
- 必须是可以被重写的方法才能被mock
2017-3-18 23:36:16
