使用 Moq 测试.NET Core 应用 -- Mock 方法
第一篇文章, 关于Mock的概念介绍: https://www.cnblogs.com/cgzl/p/9294431.html
本文介绍使用Moq来Mock方法.
使用的代码: https://github.com/solenovex/Moq4-Tutorial-Code 里面的 02 Before 部分.
Mock 对象
紧接着上文中的例子. 上一篇文章, 我在单元测试的时候, 把依赖项设为null:
然后便出现了NullReferenceException, 导致测试无法正常运行.
首先应该做的是在TransferApproval的构造函数里判断参数是否为null, 如果为null的话应该抛出ArgumentNullException:
这是更恰当的异常.
这样的话, 在测试的时候, 抛出的就是ArgumentNullException了, 它可以更恰当的表达程序出现的问题:
现在我们可以使用mock版本的依赖项来代替null了:
上面的代码首先使用Moq创建了一个mock版本的IPhysicalExamination的实例.
而由于Moq对依赖项进行了包装, 所以要获得实际的mock依赖项, 我们需要使用mockExamination.Object属性. 而这个属性的类型就是IPhysicalExamination.
另外一个测试方法我也这么改一下, 然乎重新Build. Run All Tests:
还是红色的, 但现在是测试没通过, 并不是抛出异常.
测试没通过的意思就是期待值和实际返回值不符.
让我们来调试一下这个测试, 我在TransferApproval类里面设置一个端点, 查看一下这个mock依赖项的方法返回值:
然后调试测试:
跑到断点
可以看到这个Mock版本依赖项的IsHealthy()方法的返回值是false.
我并没有对这个Mock版本的IPhysicalExamination的IsHealthy()方法设定返回值, 正因为如此, 它才会返回它方法返回类型的默认值, 它的返回类型是bool, 而bool的默认值是false, 所以现在IsHealthy()方法在没有设定的情况下的返回值就是false.
It类
而PhysicalExamination这个具体的实现类由于各种原因导致还没有实现, 为了让它不妨碍我们的单元测试, 我先设定让它在无论传进什么参数的情况下都会返回true.
从业务上来讲就是假设所有转会球员都可以通过体检:
那么现在所有的测试都应该可以通过了:
这里用到了It这个类, 在Moq里, It这个类是用来做参数匹配的, it 就是"它"的意思, 它就代表需要被匹配的参数.
It.IsAny<T>(), 它表示传递给方法的参数的类型只要是T就可以, 值是任意的. 只要满足了这个条件, 那么方法的返回值就是后边Returns()方法里设定的值.
Moq 关于It类的文档: http://www.nudoq.org/#!/Packages/Moq/Moq/It
它有下面几种用法:
- Is<TValue>(Expression<Func<TValue, Boolean>>)
- IsAny<TValue>()
- IsIn<TValue>(IEnumerable<TValue>)
- IsInRange<TValue>(TValue, TValue, Range)
- IsNotIn<TValue>(IEnumerable<TValue>)
- IsNotNull<TValue>()
- IsRegex(string)
我认为通过方法名就可以知道这些方法的用途.
下面我修改一下该测试方法, 使用It其它几个方法:
其测试结果仍然是通过的.
严谨(Strict) vs 宽松(Loose) Mock
Moq里面有Strict(严谨)和Loose(宽松) mock对象的概念, 当然也有很多人不喜欢这个概念.
在当前的测试方法里, TransferApproval依赖于Mock<IPhysicalExamination>, 并调用其IsHealthy()方法.
如果不对IsHealthy()方法进行任何设定的情况下, 方法会返回bool的默认值false, 这种就是loose(宽松) Mock.
在创建Mock对象的时候, 还可选传递一个MockBehavior这个参数.
MockBehavior是一个枚举, 它有三个值:
- MockBehavior.Strict, 如果mock对象上的方法没有被预先设置好, 那么测试中调用该方法的时候就会抛出异常.
- MockBehavior.Loose, 即使方法没有被预先设置, 调用它的时候也不会抛出异常. 它会返回该方法返回类型的默认值.
- MockBehavior.Default, 它代表MockBehavior.Loose.
如果上例使用Strict Mock, 那么将会抛出Exception:
下面我把一个测试改为Strict Mock, 并取消了对IsHealthy()方法的设置:
而测试时会抛出MockException:
在对方法进行设置后, 测试就会通过:
可以感觉到:
Loose Mock, 可以少写一些设定代码, 可以返回默认值, 不易让测试中断
Strict Mock, 需要写跟多的设定代码, 每个被调用的方法都需要进行设定, 所以也更容易让测试中断.
Moq的建议是: 大多数情况下应该使用Loose Mock, 只有特殊需要的时候才去使用Strict Mock.
out参数
修改一下TransferApproval类的转会审批方法:
这次使用的是带有out参数的IsHealthy()方法.
建立一个测试方法, 并设定这个带有out参数的方法:
很简单, 测试会通过:
完成的代码在: https://github.com/solenovex/Moq4-Tutorial-Code 02 After
未完待续....
