最简单的入门方式就是创建一个测试项目,并将 NSubstitute 引用到其中。可以通过 NuGet 或 OpenWrap 来获取 NSubstitute 包。也可以直接下载 NSubstitute 文件,然后将 NSubstitute.dll 引用到项目中。
然后就可以创建一个新的测试 Fixture(可以选择使用你最喜欢的UT测试框架,本文涉及的示例中我们使用MSTest),开始思考从哪里入手。
首先,添加 using NSubstitute; 到当前的C#代码文件中,有了它我们就可以开始创建替身了。
现在,比如我们有一个非常简单的计算器接口:
1 public interface ICalculator2 {3 int Add(int a, int b);4 string Mode { get; set; }5 event EventHandler PoweringUp;6 }
我们可以让NSubstitute来创建类型实例的替代实例。可以创建诸如 Stub、Mock、Fake、Spy、Test Double 等,但当我们只是想要一个能有一定程度控制的替代实例时,为什么我们要困扰于此呢?
1 [TestMethod]2 public void Test_GetStarted_GetSubstitute()3 {4 ICalculator calculator = Substitute.For<ICalculator>();5 }
现在,我们可以告诉被创建的替代实例,当方法被调用时返回一个值:
1 [TestMethod]2 public void Test_GetStarted_ReturnSpecifiedValue()3 {4 ICalculator calculator = Substitute.For<ICalculator>();5 calculator.Add(1, 2).Returns(3);6 7 int actual = calculator.Add(1, 2);8 Assert.AreEqual<int>(3, actual);9 }
我们可以检查该替代实例是否接收到了一个指定的调用,或者未收到某指定调用:
1 [TestMethod]2 public void Test_GetStarted_ReceivedSpecificCall()3 {4 ICalculator calculator = Substitute.For<ICalculator>();5 calculator.Add(1, 2);6 7 calculator.Received().Add(1, 2);8 calculator.DidNotReceive().Add(5, 7);9 }
如果 Received() 断言失败,NSubstitute 会尝试给出有可能是什么问题:
1 [TestMethod]2 [ExpectedException(typeof(ReceivedCallsException))]3 public void Test_GetStarted_DidNotReceivedSpecificCall()4 {5 ICalculator calculator = Substitute.For<ICalculator>();6 calculator.Add(5, 7);7 8 calculator.Received().Add(1, 2);9 }
Expected to receive a call matching: Add(1, 2) Actually received no matching calls. Received 1 non-matching call (non-matching arguments indicated with '*' characters): Add(*5*, *7*)
我们也可以对属性使用与方法类似的 Retures() 语法,或者继续使用简单的属性 setter 来设置返回值。
1 [TestMethod] 2 public void Test_GetStarted_SetPropertyValue() 3 { 4 ICalculator calculator = Substitute.For<ICalculator>(); 5 6 calculator.Mode.Returns("DEC"); 7 Assert.AreEqual<string>("DEC", calculator.Mode); 8 9 calculator.Mode = "HEX";10 Assert.AreEqual<string>("HEX", calculator.Mode);11 }
NSubstitute 支持参数匹配功能,可以设置参数规则,并断言判断是否接收到参数匹配的调用。
1 [TestMethod] 2 public void Test_GetStarted_MatchArguments() 3 { 4 ICalculator calculator = Substitute.For<ICalculator>(); 5 6 calculator.Add(10, -5); 7 8 calculator.Received().Add(10, Arg.Any<int>()); 9 calculator.Received().Add(10, Arg.Is<int>(x => x < 0));10 }
我们也可以在使用参数匹配功能的同时,传递一个函数给 Returns() ,以此来使替代实例具有更多的功能。
1 [TestMethod] 2 public void Test_GetStarted_PassFuncToReturns() 3 { 4 ICalculator calculator = Substitute.For<ICalculator>(); 5 calculator 6 .Add(Arg.Any<int>(), Arg.Any<int>()) 7 .Returns(x => (int)x[0] + (int)x[1]); 8 9 int actual = calculator.Add(5, 10);10 11 Assert.AreEqual<int>(15, actual);12 }
Returns() 也可通过构造一个返回值序列来指定多个参数。
1 [TestMethod] 2 public void Test_GetStarted_MultipleValues() 3 { 4 ICalculator calculator = Substitute.For<ICalculator>(); 5 calculator.Mode.Returns("HEX", "DEC", "BIN"); 6 7 Assert.AreEqual<string>("HEX", calculator.Mode); 8 Assert.AreEqual<string>("DEC", calculator.Mode); 9 Assert.AreEqual<string>("BIN", calculator.Mode);10 }
最后,我们可以在替代实例上引发事件通知:
1 [TestMethod] 2 public void Test_GetStarted_RaiseEvents() 3 { 4 ICalculator calculator = Substitute.For<ICalculator>(); 5 bool eventWasRaised = false; 6 7 calculator.PoweringUp += (sender, args) => 8 { 9 eventWasRaised = true;10 };11 12 calculator.PoweringUp += Raise.Event();13 14 Assert.IsTrue(eventWasRaised);15 }
基本上这些就是入门 NSubstitute 的全部内容。