Skip to main content

Unit Testing Workflow Code Activities - Part 1

When I first started looking into Windows Workflow one of the first things that I liked about it was how it separated responsibilities. The workflow was responsible for handling the procedural logic with all it's conditional statements, etc. Whilst individual code activities could be written to handle the business logic processing; created in small easily re-usable components. To try and realise my original perception this series of blog posts will cover the unit testing of bespoke code activities; broken down into:

  • Part One: Unit testing a code activity with a (generic) cast return type (this post)
  • Part Two: Unit testing a code activity that assigns it's (multiple) output to "OutArguments" (Not yet written)

So to make a start consider the following really basic code activity; it expects an InArgument<string> of "Input" and returns a string containing the processed output; in this case a reverse copy of the value held in "Input".

namespace ExampleCode.Workflow
{
using System.Activities;
using System.Linq;
 
public class StringReverse : CodeActivity<string>
{
public InArgument<string> Input { get; set; }
 
protected override string Execute(CodeActivityContext context)
{
var input = this.Input.Get(context);
return string.IsNullOrWhiteSpace(input)
? input
: new string(Enumerable.Range(1, input.Length).Select(i => input[input.Length - i]).ToArray());
}
}
}

This code should have been extremely easy to unit test, apart from two immediate problems.

  1. The protected method "Execute" is not exposed to the calling code; making it impossible to call directly.
  2. I have no idea what is required to set up a "CodeActivityContext" or how to go about doing it - as a concrete implementation it's not possible to mock.
I don't really want to create a public method I can call directly without having to worry about the "context" as this is creating code for testing sake; something that is never a good idea. Just for completeness this could be implemented as follows, but I really wouldn't recommend it!

protected override string Execute(CodeActivityContext context)
{
return this.Process( this.Input.Get(context));
}
 
public string Process(string input)
{
return string.IsNullOrWhiteSpace(input)
? input
: new string(Enumerable.Range(1, input.Length).Select(i => input[input.Length - i]).ToArray());
}

So if we don't want to create new code and expose protected functionality purely for testing, what can we do? the answer lies in the unit test itself. Checking the prototypes for the "Invoke" method of the static class WorkflowInvoker class highlights that it takes either an instance of Activity or an instance of Activity<TResult>; it's important to remember that even a complex XAML workflow is contained within a single Sequence or Flow activity, which both inherit from Activity! Checking the return value of the "Invoke" method further highlights that we should get back the return value of the code activity instance. This means our unit test can simply be:

namespace ExampleCode.Workflow.Tests
{
using System.Activities;
using Microsoft.VisualStudio.TestTools.UnitTesting;
 
[TestClass]
public class StringReverseTests
{
[TestMethod]
public void TestMethod1()
{
var output = WorkflowInvoker.Invoke(new StringReverse { Input = new InArgument<string>("123") });
Assert.AreEqual("321", output);
}
}
}

It could be argued that it's not ideal because we really haven't isolated the code we want to test, but this solution doesn't require any test only changes to the code activity. It's also extremely easy to set up and call - given that I think it's an acceptable risk. No matter what logic is contained within the code activity, the only additional complexity in this instance is the number of input arguments. Things like external dependencies (Inversion of Control) and multiple output arguments will be covered in future posts.

Comments

Popular posts from this blog

Mocking HttpCookieCollection in HttpRequestBase

When unit testing ASP.NET MVC2 projects the issue of injecting HttpContext is quickly encountered.  There seem to be many different ways / recommendations for mocking HttpContextBase to improve the testability of controllers and their actions.  My investigations into that will probably be a separate blog post in the near future but for now I want to cover something that had me stuck for longer than it probably should have.  That is how to mock non abstract/interfaced classes within HttpRequestBase and HttpResponseBase – namely the HttpCookieCollection class.   The code sample below illustrates how it can be used within a mocked instance of HttpRequestBase.  Cookies can be added / modified within the unit test code prior to being passed into the code being tested.   After it’s been called, using a combination of MOQ’s Verify and NUnit’s Assert it is possible to check how many times the collection is accessed (but you have to include the set up calls) and that the relevant cookies have …

Injecting HttpContextBase into an MVC Controller

It is a shame that when the ASP.NET MVC framework was released they did not think to build IoC support into the infrastructure. All the major components of the MVC engine appear to magically inherit instances of HttpContext and it’s related objects – which can cause no end of problems if you are trying to utilise Unit Testing and IoC. Reading around various articles on the subject just to get around this one problem requires the implementation of several different concepts and you are still left with a work around. The code below, along with the other links referenced in this article is my stab at resolving the issue. There’s probably nothing new here, but it does attempt to relate all the information needed to do this for Castle Windsor. The overview is that all controllers will need to inherit from a base controller, which takes an instance of HttpContext into it’s constructor. It then overrides the property HttpContext in the main controller class, supplying it’s own version…

Problem installing AWS CLI

It never feels like a good start when you're trying to start out with something and the install fails with an obscure error! I was just trying to install the Amazon CLI following the instructions at https://aws.amazon.com/cli/ and ran into the following error when running 'pip install awscli': Collecting awscli Could not find a version that satisfies the requirement awscli (from versions: ) No matching distribution found for awscli I appeared to have a correct version of Python installed (v2.7) and checking "PIP -v" indicated that 9.0.1 was installed. That all seemed to tick the required boxes but digging around a little more I did see that some people had had issues with various versions of PIP so I found / ran the following to upgrade to the latest vesion: curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py This installed v9.0.3 of PIP which burst into life when I re-ran 'pip install awscli' and everything seems to be ok. Like…