WF4.0进行单元测试

本文通过举例说明在WF4.0中如何进行单元测试。

1、简单的WF4.0活动测试

    如果是一个简单的WF4.0活动，是那种没有带BookMark，也不是messaging活动，也不是长时间运行的活动。使用WorkflowInvoker进行单元测试将非常的方便。

   下面，我们以一种情况为例子：流程中只包含了两个加数相加的操作，然后就将结果返回。流程如下图所示：

最简单的方法是通过Workflow Invoker进行测试。

[TestMethod] 
public void  ShouldAddGoodSum() 
{ 
var output  =  WorkflowInvoker.Invoke( new  GoodSum() {x = 1 , y = 2 }); 

Assert.AreEqual( 3 , output[ " sum " ]); 
}

如果这个测试通过，就是说这个流程的输出参数集合中包含一个 Int32的sum参数，值等于3。有下面几种情况可能需要我们进行测试

1、没有名为sum这个输出参数

2、有一个sum输出参数，但是类型不是Int32

3、有一个sum输出参数，类型也是Int32，但是值不是我们期待的（3）。

这样我们能清楚流程哪出了问题。我们修改一下流程，将输出的参数sum改成Sum。在VB中，没有什么问题，但是在C#中sum！=Sum。通过上面测试代码你会得到下面的错误提示。

但是异常信息提示的太简单，我们不知道到底是那个参数出现了问题。有更好的办法吗？有，使用WorklowTestHelper。

使用WorklowTestHelper进行单元测试

1、下载WorkflowTestHelper

2、添加WorkflowTestHelper引用

3、使用WorkflowTestHelper表达式

我们将测试代码改成：

代码

[TestMethod] 
public void  ShouldAddGoodSumAssertOutArgument() 
{ 
var output  =  WorkflowInvoker.Invoke( new  GoodSum() { x  = 1 , y  = 2  }); 

AssertOutArgument.AreEqual(output,  " sum " ,  3 ); 
}

 

 

再看下出现的异常信息。信息更加明确了。

AssertOutArgument.AreEqual failed. Output does not contain an argument named <sum>.

如果类型错误，例如我们将流程中的sum修改成string。

对于Assert.AreEqual我们得到下面错误提示：

Assert.AreEqual failed. Expected:<3 (System.Int32)>. Actual:<3 (System.String)>.

使用AssertOutArgument，将会得到更确切的错误信息：

AssertOutArgument.AreEqual failed. Wrong type for OutArgument <sum>. Expected Type: <System.Int32>. Actual Type: <System.String>.

2、对带有BookMark的流程进行测试

什么是BookMark？如果你有使用WF4.0开发过，就应该知道BookMark在WF中的地位。简单的说：如果你的流程需要数据，这些参数可能来自用户输入，可能来自宿主环境，BookMark是用来暂停流程，等待响应的。下面是一个书签活动的代码：

代码

public sealed class  ReadLine : NativeActivity < string >  
{ 
private  BookmarkCallback _readCompleteCallback; 

[RequiredArgument] 
public  InArgument < string >  BookmarkName {  get ;  set ; } 

protected override bool  CanInduceIdle 
{ 
get  {  return true ; } 
} 

public  BookmarkCallback ReadCompleteCallback 
{ 
get  {  return  _readCompleteCallback  ??  (_readCompleteCallback  = new  BookmarkCallback(OnReadComplete)); } 
} 

protected override void  Execute(NativeActivityContext context) 
{ 
//  Inform the host that this activity needs data and wait for the callback 
context.CreateBookmark(BookmarkName.Get(context), ReadCompleteCallback); 
} 

private void  OnReadComplete(NativeActivityContext context, Bookmark bookmark,  object  state) 
{ 
//  Store the value returned by the host 
context.SetValue(Result, state  as string ); 
} 
}

 下面我在流程中使用这个活动，用来等待用户的输入。

对于这个流程，如果你使用WorkflowInvoker，你的应用程序将会一直被挂起。所以你不得不使用WorkflowApplication，以及在你应用程序中处理这些BookMark。

如何测试这个流程。

测试这个流程将非常棘手。使用WorkflowTestHelper类库中的类将会方便很多。这个类就是WorkflowApplicationTest<T>.。这个类可以方便的创建和管理WorkflowApplication。使用非常简单的代码就可以处理好流程的所有的事件和结果。测试代码如下：

代码

[TestMethod] 
public void  ShouldOutputGreeting() 
{ 
//  Arrange 
const string  expectedFirstName  = " Test " ; 
const string  expectedLastName  = " User " ; 
var expectedGreeting  = string .Format( " Hello {0} {1} " , expectedFirstName, expectedLastName); 
var sut  =  WorkflowApplicationTest.Create( new  TestReadLine()); 

//  Act 

//  Run the workflow 
sut.TestActivity(); 

//  Wait for the first idle event - prompt for First Name 
//  will return false if the activity does not go idle within the 
//  timeout (default 1 sec) 
Assert.IsTrue(sut.WaitForIdleEvent()); 

//  Should have a bookmark named "FirstName" 
Assert.IsTrue(sut.Bookmarks.Contains( " FirstName " )); 

Assert.AreEqual(BookmarkResumptionResult.Success, 
sut.TestWorkflowApplication.ResumeBookmark( " FirstName " , expectedFirstName)); 

//  Wait for the second idle event - prompt for Last Name 
Assert.IsTrue(sut.WaitForIdleEvent()); 

//  Should have a bookmark named "LastName" 
Assert.IsTrue(sut.Bookmarks.Contains( " LastName " )); 

Assert.AreEqual(BookmarkResumptionResult.Success, 
sut.TestWorkflowApplication.ResumeBookmark( " LastName " , expectedLastName)); 

//  Wait for the workflow to complete 
Assert.IsTrue(sut.WaitForCompletedEvent()); 

//  Assert 
//  WorkflowApplicationTest.TextLines returns an array of strings 
//  that contains strings written by the WriteLine activity 
Assert.AreEqual( 4 , sut.TextLines.Length); 
Assert.AreEqual(expectedGreeting, sut.TextLines[ 2 ]); 
}

3、测试WorkflowService

测试例子：

定义一个扩展类，用来存储数据和计算平均数：

1  public class  AverageExtension
2  {
3  private static readonly  List < int >  Numbers  = new  List < int > ();
4 
5  public static void  Reset()
6  {
7  Numbers.Clear();
8  }
9 
10  public void  StoreNumber( int  num)
11  {
12  Numbers.Add(num);
13  }
14 
15  public double  GetAverage()
16  {
17  return  Numbers.Average();
18  }
19  }

定义一个活动使用此扩展类，在这个自定义的活动中，重写CacheMetadata方法，实现当服务中没有此扩展就添加此扩展。

代码

public sealed class  GetAverage : CodeActivity < string >
{
public  InArgument < int >  Number {  get ;  set ; }


protected override void  CacheMetadata(CodeActivityMetadata metadata)
{
//  This activity requires the average extension
metadata.RequireExtension( typeof  (AverageExtension));

//  This lambda will create one if it is not already added
metadata.AddDefaultExtensionProvider(()  => new  AverageExtension());

base .CacheMetadata(metadata);
}

protected override string  Execute(CodeActivityContext context)
{
//  Get the average extension
var average  =  context.GetExtension < AverageExtension > ();

if  (average  == null )
throw new  InvalidOperationException( " Cannot access AverageExtension " );

var number  =  Number.Get(context);

//  Store this number
average.StoreNumber(number);

return string .Format( " Stored {0}, Average:{1} " , number, average.GetAverage());
}
}

工作流服务如下：

如何测试：

1、添加WorkflowTestHelper引用

2、配置测试环境

3、为WorkflowService添加DeploymentItem属性标签。

4、使用WorkflowServiceTestHost宿主测试程序，代码如下：

代码

private readonly  Binding _binding  = new  NetNamedPipeBinding(); 

/// <summary>  
///  The endpoint address to be used by the test host 
/// </summary>
private readonly  EndpointAddress _serviceAddress  = new  EndpointAddress( " net.pipe://localhost/TestService " ); 


/// <summary>  
///  Tests the GetAverage Activity by invoking it in a WorkflowService multiple times 
/// </summary>
[TestMethod()] 
[DeploymentItem( " Service1.xamlx " )] 
public void  ShouldInvokeAverageExtension() 
{ 
const string  expected1  = " Stored 33, Average:33 " ; 
const string  expected2  = " Stored 44, Average:38.5 " ; 
const string  expected3  = " Stored 55, Average:44 " ; 

string  result1; 
string  result2; 
string  result3; 

//  Self-Host Service1.xamlx using Named Pipes 
using  (var testHost  =  WorkflowServiceTestHost.Open( " Service1.xamlx " , _serviceAddress.Uri)) 
{ 
//  Use the generated proxy with named pipes 
var proxy  = new  ServiceClient(_binding, _serviceAddress); 

try  
{ 
result1  =  proxy.GetData( 33 ); 
result2  =  proxy.GetData( 44 ); 
result3  =  proxy.GetData( 55 ); 
proxy.Close(); 
} 
catch  (Exception) 
{ 
proxy.Abort(); 
throw ; 
} 

Assert.AreEqual(expected1, result1); 
Assert.AreEqual(expected2, result2); 
Assert.AreEqual(expected3, result3); 
} 
} 

 总结：这篇文章是对WF4.0单元测试的一个简单介绍。WorklowTestHelper是一个MS的老外为WF4.0单元测试写的一个类库。测试类库和测试的例子http://code.msdn.microsoft.com/wfth/中都有下载。

本文转自麒麟博客园博客，原文链接：http://www.cnblogs.com/zhuqil/archive/2010/10/09/how-to-unit-test-in-wf4.html，如需转载请自行联系原作者