NSubstitute完全手册（十五）自动递归模拟-阿里云开发者社区

NSubstitute完全手册（十五）自动递归模拟

2017-12-13 1100

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介：

替代实例一旦被设置属性或方法，则将自动返回非NULL值。例如，任何属性或方法如果返回接口、委托或纯虚类*，则将自动的返回替代实例自身。通常这被称为递归模拟技术，而且是非常实用的。比如其可以避免显式地设置每个替代实例，也就意味着更少量的代码。诸如String和Array等类型，默认会返回空值而不是NULL。

*注：一个纯虚类是指一个类，其所有的公有方法和属性都被定义为virtual或abstract，并且其具有一个默认公有或受保护地无参构造函数。

递归模拟

比如说我们有如下类型定义：

1     public interface INumberParser
2     {
3       int[] Parse(string expression);
4     }
5     public interface INumberParserFactory
6     {
7       INumberParser Create(char delimiter);
8     }

我们想配置 INumberParserFactory 来创建一个解析器，该解析器会为一个 expression 返回一定数量的 int 类型的值。我们可以手工创建每个替代实例：

 1     [TestMethod]
 2     public void Test_AutoRecursiveMocks_ManuallyCreateSubstitutes()
 3     {
 4       var factory = Substitute.For<INumberParserFactory>();
 5       var parser = Substitute.For<INumberParser>();
 6       factory.Create(',').Returns(parser);
 7       parser.Parse("an expression").Returns(new int[] { 1, 2, 3 });
 8 
 9       var actual = factory.Create(',').Parse("an expression");
10       CollectionAssert.AreEqual(new int[] { 1, 2, 3 }, actual);
11     }

或者可以应用递归模拟功能，INumberParserFactory.Create() 会自动返回 INumberParser 类型的替代实例。

1     [TestMethod]
2     public void Test_AutoRecursiveMocks_AutomaticallyCreateSubstitutes()
3     {
4       var factory = Substitute.For<INumberParserFactory>();
5       factory.Create(',').Parse("an expression").Returns(new int[] { 1, 2, 3 });
6 
7       var actual = factory.Create(',').Parse("an expression");
8       CollectionAssert.AreEqual(new int[] { 1, 2, 3 }, actual);
9     }

每次当使用相同参数调用一个被递归模拟的属性或方法时，都会返回相同的替代实例。如果使用不同参数调用，则将会返回一个新的替代实例。

 1     [TestMethod]
 2     public void Test_AutoRecursiveMocks_CallRecursivelySubbed()
 3     {
 4       var factory = Substitute.For<INumberParserFactory>();
 5       factory.Create(',').Parse("an expression").Returns(new int[] { 1, 2, 3 });
 6 
 7       var firstCall = factory.Create(',');
 8       var secondCall = factory.Create(',');
 9       var thirdCallWithDiffArg = factory.Create('x');
10 
11       Assert.AreSame(firstCall, secondCall);
12       Assert.AreNotSame(firstCall, thirdCallWithDiffArg);
13     }

注：不会为类创建递归的替代实例，因为创建和使用类可能有潜在的或多余的副作用。因此，有必要显式地创建和返回类的替代实例。

替代链

当需要时，我们可以使用递归模拟来简单地设置替代链，但这并不是一个理想的做法。例如：

 1     public interface IContext
 2     {
 3       IRequest CurrentRequest { get; }
 4     }
 5     public interface IRequest
 6     {
 7       IIdentity Identity { get; }
 8       IIdentity NewIdentity(string name);
 9     }
10     public interface IIdentity
11     {
12       string Name { get; }
13       string[] Roles();
14     }

如果要获取 CurrentRequest 中的 Identity 并返回一个名字，我们可以手工为 IContext、IRequest 和 IIdentity 创建替代品，然后使用 Returns() 将这些替代实例链接到一起。或者我们可以使用为属性和方法自动创建的替代实例。

1     [TestMethod]
2     public void Test_AutoRecursiveMocks_SubstituteChains()
3     {
4       var context = Substitute.For<IContext>();
5       context.CurrentRequest.Identity.Name.Returns("My pet fish Eric");
6       Assert.AreEqual(
7         "My pet fish Eric",
8         context.CurrentRequest.Identity.Name);
9     }

在这里 CurrentReques t是自动返回一个 IRequest 的替代实例，IRequest 替代实例会自动返回一个 IIdentity 替代实例。

注：类似于这种设置很长的替代实例链，一般被认为是代码臭味：我们打破了 Law of Demeter 原则，对象只应该与其直接关系的临近对象打交道，而不与临近对象的临近对象打交道。如果你写的测试用例中没有使用递归模拟，设置的过程可能会明显的变复杂，所以如果要使用递归模式，则需要格外的注意类似的类型耦合。

自动值

当属性或方法返回 String 或 Array 类型的值时，默认会返回空或者非 NULL 值。比如在你仅需要返回一个对象引用，但并不关心其特定的属性时，这个功能可以帮你避免空引用异常。

1     [TestMethod]
2     public void Test_AutoRecursiveMocks_AutoValues()
3     {
4       var identity = Substitute.For<IIdentity>();
5       Assert.AreEqual(string.Empty, identity.Name);
6       Assert.AreEqual(0, identity.Roles().Length);
7     }