用JustMock测试你的应用程序
本主题将指导您通过几个简单的步骤来使用Telerik®JustMock轻松测试您的应用程序。您将理解一个简单的原理，称为Arrange / Act / Assert，并熟悉框架中的核心方法和属性，这些方法和属性在最常见的测试场景中使用
为了说明下一个例子中JustMock的用法，我们将使用一个样本仓库(warehouse)和一个依赖订单对象(Order)。仓库持有不同产品的库存。订单包含产品和数量。
仓库界面和订单类看起来像这样：
publicdelegatevoidProductRemoveEventHandler(string productName,int quantity);
publicinterfaceIwarehouse
{
eventProductRemoveEventHandlerProductRemoved;
stringManager{get;set;}
boolHasInventory(string productName,int quantity);
voidRemove(string productName,int quantity);
}
publicclassOrder
{
publicOrder(string productName,int quantity)
{
this.ProductName= productName;
this.Quantity= quantity;
}
publicstringProductName{get;privateset;}
publicintQuantity{get;privateset;}
publicboolIsFilled{get;privateset;}
publicvoidFill(Iwarehouse warehouse)
{
if(warehouse.HasInventory(this.ProductName,this.Quantity))
{
warehouse.Remove(this.ProductName,this.Quantity);
}
}
publicvirtualstringReceipt(DateTime orderDate)
{
returnstring.Format("Ordered {0} {1} on{2}",this.Quantity,this.ProductName, orderDate.ToString("d"));
}
}
方法
DoInstead
DoInstead当您想要通过用自定义操作替换方法来更改方法的行为时，可以使用该方法。我们用上面的例子来说明如何使用DoInstead。
[TestMethod]
publicvoidDoInstead_TestMethod()
{
//Arrange
var warehouse =Mock.Create<Iwarehouse>();
var order =newOrder("Camera",2);
bool called =false;
Mock.Arrange(()=> warehouse.HasInventory("Camera",2)).DoInstead(()=> called =true);
//Act
order.Fill(warehouse);
//Assert
Assert.IsTrue(called);
}
简单的说 - 我们安排，当仓库的HasInventory方法调用参数“camera”和2，我们将执行行动“ （）=>called=true ”，而不是调用实际的方法。
CallOriginal
在某些情况下，您可能希望在调用原始方法实现时使用特定的值调用该方法，并使用其他值调用模拟。为此，您可以使用该CallOriginal方法。
[TestMethod]
publicvoidCallOriginal_TestMethod()
{
//Arrange
var order =Mock.Create<Order>(Behavior.CallOriginal,"Camera",2);
Mock.Arrange(()=> order.Receipt(DateTime.Today)).CallOriginal();
Mock.Arrange(()=> order.Receipt(Arg.Matches<DateTime>(d => d >DateTime.Today))).Returns("InvalidDateTime");
//Act
var callWithToday =order.Receipt(DateTime.Today);
var callWithDifferentDay = order.Receipt(DateTime.Today.AddDays(1));
//Assert
Assert.AreEqual("Ordered 2 Camera on "+DateTime.Today.ToString("d"), callWithToday);
Assert.AreEqual("Invalid DateTime", callWithDifferentDay);
}
在这个例子中，我们安排当order.Receipt用参数调用DateTime.Today方法时，应该调用原来的方法实现。但是，一旦晚于日期调用相同的方法，DateTime.Today我们将返回“Invalid DateTime”。
throws
在Throws当你想抛出一个异常特定方法调用方法时使用。在下面的例子中，我们抛出一个无效的操作异常，试图调用仓库。删除零个数量。
[TestMethod]
[ExpectedException(typeof(InvalidOperationException))]
publicvoidThrows_TestMethod()
{
//Arrange
var order =newOrder("Camera",0);
var warehouse =Mock.Create<Iwarehouse>();
//Set up that the ware house has inventory of any products with any quantities.
Mock.Arrange(()=> warehouse.HasInventory(Arg.IsAny<string>(),Arg.IsAny<int>())).Returns(true);
//Set up that call to warehouse.Remove with zero quantity is invalid and throwsan exception.
Mock.Arrange(()=> warehouse.Remove(Arg.IsAny<string>(),Arg.Matches<int>(x => x ==0)))
.Throws(newInvalidOperationException());
//Act
order.Fill(warehouse);
}
在这种情况下，我们使用ExpectedException属性Microsoft.VisualStudio.TestTools.UnitTesting来验证类型InvalidOperationException的异常是否被抛出。
Machers
匹配器让你忽略传递实际值作为模拟中使用的参数。相反，它们给你传递一个满足参数类型或期望值范围的表达式的可能性。例如，如果方法接受字符串作为第一个参数，则不需要传递特定的字符串，如“Camera”，而是可以使用Arg.IsAny<string>()。
JustMock支持三种类型的匹配器：
1. Arg.IsAny<[Type]>();
2. Arg.IsInRange([FromValue : int], [ToValue : int],[RangeKind])
3. Arg.Matches(Expression> expression)
我们来看看它们的详细用法。
Arg.IsAny（）;
我们已经在上面的一个例子中使用了这个匹配器。
Mock.Arrange(()=> warehouse.HasInventory(Arg.IsAny<string>(),Arg.IsAny<int>())).Returns(true);
这个匹配器指定当HasInventory任何字符串作为第一个参数调用方法，任何int作为第二个参数时，它应该返回true。
Arg.IsInRange（int from，int to,RangeKind range）
IsInRange匹配器让我们安排一个预期值范围的调用。通过RangeKind论证，我们可以指定给定的范围是包含还是排除其边界。
对于范围从0到5的参数值，将返回以下内容true：
Mock.Arrange(()=> foo.Echo(Arg.IsInRange(0,5,RangeKind.Inclusive))).Returns(true);
Arg.Matches (Expression> expression)
这是最灵活的匹配器，它允许你指定你自己的匹配表达式。我们用一个简单的例子来说明：
Mock.Arrange(()=> foo.Echo(Arg.Matches<int>( x => x <10)).Returns(true);
属性
在上面的例子中，我们只模拟方法，但是你也可以用同样的方法来模拟属性。
[TestMethod]
publicvoidMockingProperties_TestMethod()
{
//Arrange
var warehouse =Mock.Create<Iwarehouse>();
Mock.Arrange(()=> warehouse.Manager).Returns("John");
string manager =string.Empty;
//Act
manager = warehouse.Manager;
//Assert
Assert.AreEqual("John", manager);
}
另外，还可以给属性赋值
[TestMethod]
[ExpectedException(typeof(StrictMockException))]
publicvoidMockingProperties_PropertySet_TestMethod()
{
//Arrange
var warehouse =Mock.Create<Iwarehouse>(Behavior.Strict);
Mock.ArrangeSet(()=> warehouse.Manager="John");
//Act
warehouse.Manager="Scott";
}
在安排步骤中，我们设置仓库经理只能设置为“John”。但是在行动步骤中，我们将经理设置为“Scott”。这抛出了一个模拟异常。请记住，这只会在您使用StrictBehavior创建模拟时才起作用。
另一个常用的技巧是断言将属性设置为特定值会引发异常。我们来安排一下
[TestMethod]
[ExpectedException(typeof(ArgumentException))]
publicvoidMockingProperties_PropertySet_Throws_TestMethod()
{
//Arrange
var warehouse =Mock.Create<Iwarehouse>();
Mock.ArrangeSet(()=> warehouse.Manager="John").Throws<ArgumentException>();
//Act
//that's ok
warehouse.Manager="Scott";
//but that would throw an ArgumentException
warehouse.Manager="John";
}
在这里，我们使用Throws上面讨论的方法来表明如果warehouse.Manager设置为“John”，则应抛出异常。
活动
该方法Raises允许您在调用方法时引发事件并传递特定的事件参数。回到我们的仓库示例，我们可能想要在调用ProductRemoved该Remove方法时引发事件。
[TestMethod]
publicvoidRaisingAnEvent_TestMethod()
{
//Arrange
var warehouse =Mock.Create<Iwarehouse>();
Mock.Arrange(()=> warehouse.Remove(Arg.IsAny<string>(),Arg.IsInRange(int.MinValue,int.MaxValue,RangeKind.Exclusive)))
.Raises(()=> warehouse.ProductRemoved+=null,"Camera",2);
string productName =string.Empty;
int quantity =0;
warehouse.ProductRemoved+=(p, q)=>{ productName = p; quantity =q;};
//Act
warehouse.Remove(Arg.AnyString,Arg.AnyInt);
//Assert
Assert.AreEqual("Camera", productName);
Assert.AreEqual(2, quantity);
}
在安排步骤中，我们设置一旦仓库的Remove方法被调用，我们将ProductRemoved用参数“Camera”和2 来提升调用事件。
项目GitHub地址：https://github.com/liuzhenyulive/JustMockDemo
参考文献：http://docs.telerik.com/devtools/justmock/getting-started/quick-start#testing-your-application-with-justmock
