上一章区分了下stub
,和mock
这一章我们的确要开始讲moq
的api了
Setup
系列
Setup
系列的函数用于伪造特定方法
的返回值。当然这个方法
也会包含属性
的方法
Setup
:伪造方法
setup
伪造方法返回值的格式为伪对象
.Setup(fake=>fake.方法名)
.Returns(返回值)
这里用moq
官方文档中的接口为例
public interface IFoo
{
Bar Bar { get; set; }
string Name { get; set; }
int Value { get; set; }
bool DoSomething(string value);
bool DoSomething(int number, string value);
string DoSomethingStringy(string value);
bool TryParse(string value, out string outputValue);
bool Submit(ref Bar bar);
int GetCount();
bool Add(int value);
}
public class Bar
{
public virtual Baz Baz { get; set; }
public virtual bool Submit() { return false; }
}
public class Baz
{
public virtual string Name { get; set; }
}
我期望IFoo
的GetCount
方法返回值为3.那么就可以写
var fakeFoo = new Mock<IFoo>();
fakeFoo.Setup(fake => fake.GetCount()).Returns(3);
或者我期望DoSomething
方法传入"fitness"
是返回"slim"
,那么我可以写
fakeFoo.Setup(fake => fake.DoSomething("fitness")).Returns("slim");
很简单是不是,不过现实的程序中可不止这些。
例如我们有时候会期望返回值和输入参数有关,例如DoSomething
方法传入"fitness"
是返回"fitness makes me slim"
,那么可以用如下写法
fakeFoo.Setup(fake => fake.DoSomething("fitness")).Returns((string value)=>value+"makes me slim");
那有同学说了,我不能只"fitness"
啊,我还可以"swimming","running"
,那怎么办呢?
么事啊,把这些输入情况也伪造了
fakeFoo.Setup(fake => fake.DoSomething("swimming")).Returns((string value)=>value+"makes me slim");
fakeFoo.Setup(fake => fake.DoSomething("running")).Returns((string value)=>value+"makes me slim");
有人觉得这么写太累,因为三个运动的Returns
部分的内容是一样的。OK呀,我们可以使用参数匹配It.IsAny<string>()
,是任意字符串输入都被伪造
fakeFoo.Setup(fake => fake.DoSomething(It.IsAny<string>())).Returns((string value)=>value+"makes me slim");
那还有人喜欢啥都不做,啥都不做肯定不会"slim"
,那这里我们要返回一个ArgumentException("you must do something to make you slim")
。OK呀,不过这里我们不能用Return
,这里我们引入一个新格式,抛出异常
setup
伪造方法抛出异常的格式为伪对象
.Setup(fake=>fake.方法名)
.Throws(异常对象)
或者伪对象
.Setup(fake=>fake.方法名)
.Throws<T exception>
因此就可以写成
fakeFoo.Setup(fake => fake.DoSomething("")).Throws(new ArgumentException("you must do something to make you slim"));
此外我们还常常遇到连续调用同一方法,返回值不同的情况,例如第一次"fitness"
是返回"fitness makes me slim x1"
,第二次就会返回"fitness makes me slim x2"
,
这时我们就需要另外一个函数CallBack
,CallBack
可以让你在方法调用的时候执行一个回调函数。
对于上面的情况我们就可以写成
int count=1;
fakeFoo.Setup(fake => fake.DoSomething("fitness"))
.Returns((string value)=>$"{value} {results} x{count}")
.CallBack(()=>count++);
OK以上就是Moq
伪造方法的基本用法,总结一下
//伪造无参数方法
fakeFoo.Setup(fake => fake.GetCount()).Returns(3);
//伪造指定参数方法
fakeFoo.Setup(fake => fake.DoSomething("fitness")).Returns("slim");
//伪造方法返回值和参数相关
fakeFoo.Setup(fake => fake.DoSomething("fitness")).Returns((string value)=>value+"makes me slim");
//伪造方法参数匹配
fakeFoo.Setup(fake => fake.DoSomething(It.IsAny<string>())).Returns((string value)=>value+"makes me slim");
//伪造方法抛出异常
fakeFoo.Setup(fake => fake.DoSomething("")).Throws(new ArgumentException("you must do something to make you slim"));
//伪造方法回调
fakeFoo.Setup(fake => fake.DoSomething("fitness"))
.Returns((string value)=>$"{value} {results} x{count}")
.CallBack(()=>count++);
本文会经常更新,请阅读原文: https://dotnet-campus.github.io//post/Moq%E5%9F%BA%E7%A1%80-%E4%B8%89.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 腾霄 (包含链接: https://dotnet-campus.github.io/ ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 。