moq 的常用使用方法

顾俊哲

2023-12-01

测试方法

1 // 准备 Mock IFoo 接口
2 var mock = new Mock < IFoo > ();
3 // 配置准备模拟的方法，当调用接口中的 DoSomething 方法，并传递参数 "bing" 的时候，返回 true
4 mock.Setup(foo => foo.DoSomething( " ping " )).Returns( true );
5
6 // 方法的参数中使用了 out 参数
7 // out arguments
8 var outString = " ack " ;
9 // 当调用 TryParse 方法的时候，out 参数返回 "ack", 方法返回 true, lazy evaluated
10 mock.Setup(foo => foo.TryParse( " ping " , out outString)).Returns( true );
11
12 // ref 参数
13 var instance = new Bar();
14 // 仅仅在使用 ref 调用的时候，才会匹配下面的测试
15 mock.Setup(foo => foo.Submit( ref instance)).Returns( true );
16
17 // 当方法返回值得时候，还可以访问返回的值
18 // 这里可以使用多个参数
19 mock.Setup(x => x.DoSomething(It.IsAny < string > ()))
20                  .Returns(( string s) => s.ToLower());
21
22 // 在被调用的时候抛出异常
23 mock.Setup(foo => foo.DoSomething( " reset " )).Throws < InvalidOperationException > ();
24 mock.Setup(foo => foo.DoSomething( "" )).Throws( new ArgumentException( " command " );
25
26 // 延迟计算返回的结果
27 mock.Setup(foo => foo.GetCount()).Returns(() => count);
28
29 // 在每一次调用的时候，返回不同的值
30 var mock = new Mock < IFoo > ();
31 var calls = 0 ;
32 mock.Setup(foo => foo.GetCountThing())
33      .Returns(() => calls)
34      .Callback(() => calls ++ );
35
36 // 第一次调用返回 0，下一次是 1，依次类推
37 Console.WriteLine(mock.Object.GetCountThing());

匹配参数

1 // 任意值
2 mock.Setup(foo => foo.DoSomething(It.IsAny < string > ())).Returns( true );
3
4 // 提供的值必须匹配一个函数, lazy evaluated
5 mock.Setup(foo => foo.Add(It.Is < int > (i => i % 2 == 0 ))).Returns( true );
6
7 // 匹配一个范围
8 mock.Setup(foo => foo.Add(It.IsInRange < int > ( 0 , 10 , Range.Inclusive))).Returns( true );
9
10 // 匹配正则表达式
11 mock.Setup(x => x.DoSomething(It.IsRegex( " [a-d]+ " , RegexOptions.IgnoreCase))).Returns( " foo " );

属性

1 // 普通属性
2 mock.Setup(foo => foo.Name).Returns( " bar " );
3
4 // 多层的属性
5 mock.Setup(foo => foo.Bar.Baz.Name).Returns( " baz " );
6
7 // 期望设置属性的值为 "foo"
8 mock.SetupSet(foo => foo.Name = " foo " );
9
10 // 或者直接验证赋值
11 mock.VerifySet(foo => foo.Name = " foo " );

设置属性，以便自动跟踪它的值

1 // 开始 "tracking" 属性的 sets/gets
2 mock.SetupProperty(f => f.Name);
3
4 // 提供一个默认的值
5 mock.SetupProperty(f => f.Name, " foo " );
6
7 // 现在，你可以:
8 IFoo foo = mock.Object;
9
10 // 保存的值
11 Assert.Equal( " foo " , foo.Name);
12
13 // 重新设置一个值
14 foo.Name = " bar " ;
15 Assert.Equal( " bar " , foo.Name);

还可以准备所有的属性

mock.SetupAllProperties();

事件

1 // 抛出一个事件
2 mock.Raise(m => m.FooEvent += null , new FooEventArgs(fooValue));
3
4 // 多层的后代中的事件
5 mock.Raise(m => m.Child.First.FooEvent += null , new FooEventArgs(fooValue));
6
7 // 当 Submit 方法被调用的时候，抛出一个事件
8 mock.Setup(foo => foo.Submit()).Raises(f => f.Sent += null , EventArgs.Empty);
9
10 // 抛出异常将会触发对象底层的行为
11 // 你可能需要在后面进行断言处理
12
13 // 抛出一个自定义的事件
14 public delegate void MyEventHandler( int i, bool b);
15 public interface IFoo {    event MyEventHandler MyEvent;  }
16 var mock = new Mock < IFoo > ();
17 ...
18
19 // 传递自定义的事件参数
20 mock.Raise(foo => foo.MyEvent += null , 25 , true );

回调

1 var mock = new Mock < IFoo > ();
2 mock.Setup(foo => foo.Execute( " ping " ))
3      .Returns( true )
4      .Callback(() => calls ++ );
5
6 // 使用调用的参数
7 mock.Setup(foo => foo.Execute(It.IsAny < string > ()))
8      .Returns( true )
9      .Callback(( string s) => calls.Add(s));
10
11 // 使用泛型语法
12 mock.Setup(foo => foo.Execute(It.IsAny < string > ()))
13      .Returns( true )
14      .Callback < string > (s => calls.Add(s));
15
16 // 使用多个参数
17 mock.Setup(foo => foo.Execute(It.IsAny < int > (), It.IsAny < string > ()))
18      .Returns( true )
19      .Callback < int , string > ((i, s) => calls.Add(s));
20
21 // 调用之前和之后的回调
22 mock.Setup(foo => foo.Execute( " ping " ))
23      .Callback(() => Console.WriteLine( " Before returns " ))
24      .Returns( true )
25      .Callback(() => Console.WriteLine( " After returns " ));

验证

1 mock.Verify(foo => foo.Execute( " ping " ));
2
3 // 在验证失败的时候，提供自定义的错误提示信息
4 mock.Verify(foo => foo.Execute( " ping " ), " When doing operation X, the service should be pinged always " );
5
6 // 从没有被调用的方法
7 mock.Verify(foo => foo.Execute( " ping " ), Times.Never());
8
9 // 至少调用过一次
10 mock.Verify(foo => foo.Execute( " ping " ), Times.AtLeastOnce());
11 mock.VerifyGet(foo => foo.Name);
12
13 // 验证对属性的赋值.
14 mock.VerifySet(foo => foo.Name);
15
16 // 验证对于属性设置特定的值
17 mock.VerifySet(foo => foo.Name = " foo " );
18
19 // 验证匹配的参数
20 mock.VerifySet(foo => foo.Value = It.IsInRange( 1 , 5 , Range.Inclusive));

自定义 Mock 行为

Mock 的行为分为严格的 Strict 和宽松的 Loose，默认为宽松的。在严格模式下，使用任何没有被指定的行为，都将会抛出异常，宽松模式下，不会抛出任何异常，方法将会返回默认值或者空的数组等等。

var mock = new Mock < IFoo > (MockBehavior.Strict);

如果没有重写基类的实现，默认将不会调用基类，在 Mock Web/Html 控件的是必须的。

var mock = new Mock < IFoo > { CallBase = true };

创造自动递归的 Mock, Mock 对象对于它的任何成员将会返回一个新的 Mock 对象。

var mock = new Mock < IFoo > { DefaultValue = DefaultValue.Mock };

// 默认是 DefaultValue.Empty
// 现在这个属性将会返回一个新的 Mock 对象
IBar value = mock.Object.Bar;

// 可以使用返回的 Mock 对象, 后即对属性的访问返回相同的对象实例
// 这就允许我们可以进行后继的设置
// set further expectations on it if we want
var barMock = Mock.Get(value);
barMock.Setup(b => b.Submit()).Returns( true );

中心化的 Mock 实例创建和管理：你可以在一个地方使用 MockRepository 创建和验证所有的 Mock 对象，设置 MockBehavior, CallBse 和 DefaultValue 约束。

var factory = new MockFactory(MockBehavior.Strict) { DefaultValue = DefaultValue.Mock };

// 创建 Mock 对象
var fooMock = factory.Create < IFoo > ();

// 在创建的时候重写仓库的设置
var barMock = factory.Create < IBar > (MockBehavior.Loose);

// 验证通过仓库创建的对象
factory.Verify();

其它

// 用在测试用例的开始
using Moq.Protected()

// 测试中
var mock = new Mock < CommandBase > (); mock.Protected()
      .Setup < int > ( " Execute " )
      .Returns( 5 );

// 如果用到了参数匹配, 必须使用 ItExpr 来代替 It
// 以后计划改进
mock.Protected()
     .Setup < string > ( " Execute " ,         ItExpr.IsAny < string > ())
     .Returns( true );

高级特性

1 // 从 Mock 实例重新获得 Mock 对象
2 IFoo foo = // get mock instance somehow
3 var fooMock = Mock.Get(foo);
4 fooMock.Setup(f => f.Submit()).Returns( true );
5
6 // 实现多个接口
7 var foo = new Mock < IFoo > ();
8 var disposableFoo = foo.As < IDisposable > ();
9
10 // 现在 IFoo mock 已经实现了接口 IDisposable :) disposableFoo.Setup(df => df.Dispose());
11
12 // 定制匹配
13 mock.Setup(foo => foo.Submit(IsLarge())).Throws < ArgumentException > (); ...
14 public string IsLarge()
15 {
16      return Match < string > .Create(s => ! String.IsNullOrEmpty(s) && s.Length > 100 );
17 }

转载于:https://www.cnblogs.com/qixuejia/p/6215697.html

moq 的常用使用方法

测试方法

匹配参数

属性

事件

回调

验证

自定义 Mock 行为

其它

高级特性

相关阅读

相关文章

相关问答

相关文档