Moq，就是Mock you。读音可以读成Mock~you。是Mock框架的一种。用于测试中的Mock测试。Mock是模拟的意思。Mock是模拟对象的一种技术。
测试方法
// 准备 Mock IFoo 接口 var mock = new Mock<IFoo>(); // 配置准备模拟的方法，当调用接口中的 DoSomething 方法，并传递参数 "bing" 的时候，返回 true mock.Setup(foo => foo.DoSomething("ping")).Returns(true); // 方法的参数中使用了 out 参数 // out arguments var outString = "ack"; // 当调用 TryParse 方法的时候，out 参数返回 "ack", 方法返回 true, lazy evaluated mock.Setup(foo => foo.TryParse("ping", out outString)).Returns(true); // ref 参数 var instance = new Bar(); // 仅仅在使用 ref 调用的时候，才会匹配下面的测试 mock.Setup(foo => foo.Submit(ref instance)).Returns(true); // 当方法返回值得时候，还可以访问返回的值 // 这里可以使用多个参数 mock.Setup(x => x.DoSomething(It.IsAny<string>())) .Returns((string s) => s.ToLower()); // 在被调用的时候抛出异常 mock.Setup(foo => foo.DoSomething("reset")).Throws<InvalidOperationException>(); mock.Setup(foo => foo.DoSomething("")).Throws(new ArgumentException("command"); // 延迟计算返回的结果 mock.Setup(foo => foo.GetCount()).Returns(() => count); // 在每一次调用的时候，返回不同的值 var mock = new Mock<IFoo>(); var calls = 0; mock.Setup(foo => foo.GetCountThing()) .Returns(() => calls) .Callback(() => calls++); // 第一次调用返回 0， 下一次是 1， 依次类推 Console.WriteLine(mock.Object.GetCountThing());
匹配参数
// 任意值 mock.Setup(foo => foo.DoSomething(It.IsAny<string>())).Returns(true); // 提供的值必须匹配一个函数, lazy evaluated mock.Setup(foo => foo.Add(It.Is<int>(i => i % 2 == 0))).Returns(true); // 匹配一个范围 mock.Setup(foo => foo.Add(It.IsInRange<int>(0, 10, Range.Inclusive))).Returns(true); // 匹配正则表达式 mock.Setup(x => x.DoSomething(It.IsRegex("[a-d]+", RegexOptions.IgnoreCase))).Returns("foo");
属性
// 普通属性 mock.Setup(foo => foo.Name).Returns("bar"); // 多层的属性 mock.Setup(foo => foo.Bar.Baz.Name).Returns("baz"); // 期望设置属性的值为 "foo" mock.SetupSet(foo => foo.Name = "foo"); // 或者直接验证赋值 mock.VerifySet(foo => foo.Name = "foo");
设置属性，以便自动跟踪它的值
// 开始 "tracking" 属性的 sets/gets mock.SetupProperty(f => f.Name); // 提供一个默认的值 mock.SetupProperty(f => f.Name, "foo"); // 现在，你可以: IFoo foo = mock.Object; // 保存的值 Assert.Equal("foo", foo.Name); // 重新设置一个值 foo.Name = "bar"; Assert.Equal("bar", foo.Name);
还可以准备所有的属性
mock.SetupAllProperties();
事件
// 抛出一个事件 mock.Raise(m => m.FooEvent += null, new FooEventArgs(fooValue)); // 多层的后代中的事件 mock.Raise(m => m.Child.First.FooEvent += null, new FooEventArgs(fooValue)); // 当 Submit 方法被调用的时候，抛出一个事件 mock.Setup(foo => foo.Submit()).Raises(f => f.Sent += null, EventArgs.Empty); // 抛出异常将会触发对象底层的行为 // 你可能需要在后面进行断言处理 // 抛出一个自定义的事件 public delegate void MyEventHandler(int i, bool b); public interface IFoo { event MyEventHandler MyEvent; } var mock = new Mock<IFoo>(); ... // 传递自定义的事件参数 mock.Raise(foo => foo.MyEvent += null, 25, true);
回调
var mock = new Mock<IFoo>(); mock.Setup(foo => foo.Execute("ping")) .Returns(true) .Callback(() => calls++); // 使用调用的参数 mock.Setup(foo => foo.Execute(It.IsAny<string>())) .Returns(true) .Callback((string s) => calls.Add(s)); // 使用泛型语法 mock.Setup(foo => foo.Execute(It.IsAny<string>())) .Returns(true) .Callback<string>(s => calls.Add(s)); // 使用多个参数 mock.Setup(foo => foo.Execute(It.IsAny<int>(), It.IsAny<string>())) .Returns(true) .Callback<int, string>((i, s) => calls.Add(s)); // 调用之前和之后的回调 mock.Setup(foo => foo.Execute("ping")) .Callback(() => Console.WriteLine("Before returns")) .Returns(true) .Callback(() => Console.WriteLine("After returns"));
验证
mock.Verify(foo => foo.Execute("ping")); // 在验证失败的时候，提供自定义的错误提示信息 mock.Verify(foo => foo.Execute("ping"), "When doing operation X, the service should be pinged always"); // 从没有被调用的方法 mock.Verify(foo => foo.Execute("ping"), Times.Never()); // 至少调用过一次 mock.Verify(foo => foo.Execute("ping"), Times.AtLeastOnce()); mock.VerifyGet(foo => foo.Name); // 验证对属性的赋值. mock.VerifySet(foo => foo.Name); // 验证对于属性设置特定的值 mock.VerifySet(foo => foo.Name ="foo"); // 验证匹配的参数 mock.VerifySet(foo => foo.Value = It.IsInRange(1, 5, Range.Inclusive));
自定义 Mock 行为