参数匹配器可以用于设置返回值和检查接收到的调用。它提供了一种指定一个调用或一组调用的方式,这样可以对所有匹配的调用设置一个返回值,或者检查是否接收到了匹配的调用。
忽略参数
通过使用 Arg.Any<T>() 可以忽略一个T类型的参数。
1 public interface ICalculator 2 { 3 int Add(int a, int b); 4 string Mode { get; set; } 5 } 6 7 [TestMethod] 8 public void Test_ArgumentMatchers_IgnoringArguments() 9 { 10 var calculator = Substitute.For<ICalculator>(); 11 12 calculator.Add(Arg.Any<int>(), 5).Returns(7); 13 14 Assert.AreEqual(7, calculator.Add(42, 5)); 15 Assert.AreEqual(7, calculator.Add(123, 5)); 16 Assert.AreNotEqual(7, calculator.Add(1, 7)); 17 }
在这个例子中,我们设定当任意数与 5 相加时,返回值 7。我们使用 Arg.Any<int>() 来告诉 NSubstitute 忽略第一个参数。
我们也可以通过这种方法来匹配任意的子类型。
1 public interface IFormatter 2 { 3 void Format(object o); 4 } 5 6 [TestMethod] 7 public void Test_ArgumentMatchers_MatchSubTypes() 8 { 9 IFormatter formatter = Substitute.For<IFormatter>(); 10 11 formatter.Format(new object()); 12 formatter.Format("some string"); 13 14 formatter.Received().Format(Arg.Any<object>()); 15 formatter.Received().Format(Arg.Any<string>()); 16 formatter.DidNotReceive().Format(Arg.Any<int>()); 17 }
参数条件匹配
通过使用 Arg.Is<T>(Predicate<T> condition) 来对一个T类型的参数进行条件匹配。
1 [TestMethod] 2 public void Test_ArgumentMatchers_ConditionallyMatching() 3 { 4 var calculator = Substitute.For<ICalculator>(); 5 6 calculator.Add(1, -10); 7 8 // 检查接收到第一个参数为1,第二个参数小于0的调用 9 calculator.Received().Add(1, Arg.Is<int>(x => x < 0)); 10 // 检查接收到第一个参数为1,第二个参数为 -2、-5和-10中的某个数的调用 11 calculator 12 .Received() 13 .Add(1, Arg.Is<int>(x => new[] { -2, -5, -10 }.Contains(x))); 14 // 检查未接收到第一个参数大于10,第二个参数为-10的调用 15 calculator.DidNotReceive().Add(Arg.Is<int>(x => x > 10), -10); 16 }
如果某参数的条件表达式抛出异常,则将假设该参数未被匹配,异常本身会被隐藏。
1 [TestMethod] 2 public void Test_ArgumentMatchers_ConditionallyMatchingThrowException() 3 { 4 IFormatter formatter = Substitute.For<IFormatter>(); 5 6 formatter.Format(Arg.Is<string>(x => x.Length <= 10)).Returns("matched"); 7 8 Assert.AreEqual("matched", formatter.Format("short")); 9 Assert.AreNotEqual("matched", formatter.Format("not matched, too long")); 10 11 // 此处将不会匹配,因为在尝试访问 null 的 Length 属性时会抛出异常, 12 // 而 NSubstitute 会假设其为不匹配并隐藏掉异常。 13 Assert.AreNotEqual("matched", formatter.Format(null)); 14 }
匹配指定的参数
使用 Arg.Is<T>(T value) 可以匹配指定的T类型参数。
1 [TestMethod] 2 public void Test_ArgumentMatchers_MatchingSpecificArgument() 3 { 4 var calculator = Substitute.For<ICalculator>(); 5 6 calculator.Add(0, 42); 7 8 // 这里可能不工作,NSubstitute 在这种情况下无法确定在哪个参数上应用匹配器 9 //calculator.Received().Add(0, Arg.Any<int>()); 10 11 calculator.Received().Add(Arg.Is(0), Arg.Any<int>()); 12 }
通常来讲,这个匹配器不是必须的;大部分情况下,我们可以使用 0 来代替 Arg.Is(0)。然而在某些情况下,NSubstitute 无法解析出那个匹配器应用到了那个参数上(实际上,参数匹配器进行的是模糊匹配;而不是直接解析函数的调用)。在这些情况下会抛出一个 AmbiguousArgumentsException,并且会要求你指定一个或多个额外的参数匹配器。大多数情况下你可能不得不为每个参数显式的使用参数匹配器。
NSubstitute 完全手册
- (一)入门基础
- (二)创建替代实例
- (三)设置返回值
- (四)为特定参数设置返回值
- (五)为任意参数设置返回值
- (六)使用函数设置返回值
- (七)设置多个返回值
- (八)替换返回值
- (九)检查接收到的调用
- (十)清理已收到的调用
- (十一)参数匹配器
- (十二)使用回调函数和WhenDo语法
- (十三)抛出异常
- (十四)引发事件
- (十五)自动递归模拟
- (十六)设置out和ref参数
- (十七)参数匹配器上的操作
- (十八)检查调用顺序
本文转自匠心十年博客园博客,原文链接:http://www.cnblogs.com/gaochundong/archive/2013/05/22/nsubstitute_argument_matchers.html,如需转载请自行联系原作者