Although these examples are demonstrating usage in commands, they are aslo applicable to queries.
Examples are using using MediatR to handle our requests.
If you are unfamiliar with CQRS or MediatR, here are some other relevant posts:
- Organize by Feature
- Thin Controllers with CQRS and MediatR
- Query Objects instead of Repositories
- Mediator Pattern using MediatR and Unity
First let’s take a look at our feature for Changing a Customers Pricing Level. In this example I’ve organized all aspects of this feature into one file. This single file contains our NancyFX Module and Route, Command and Command Handler.
One small piece of validation I would like to add, is validating the CustomerId is not an empty Guid.
When deserialization occurs thru the Bind() method, if the CustomerId is not present in the payload, the CustomerId will be an empty Guid (00000000-0000-0000-0000-000000000000).
The simplest approach is to add the validation to our Handler.
This doesn’t look incredibly horrible, however we are violating SRP and as you develop more complex commands, validating them will start to consume your Handler.
In object-oriented programming, the decorator pattern (also known as Wrapper, an alternative naming shared with the Adapter pattern) is a design pattern that allows behavior to be added to an individual object, either statically or dynamically, without affecting the behavior of other objects from the same class. The decorator pattern is often useful for adhering to the Single Responsibility Principle, as it allows functionality to be divided between classes with unique areas of concern.
The decorator pattern is pretty straight forward, and even if you never knew the term, you likely already used it.
Here is our decorator for wrapping the command handler with our new validation handler.
Now we can extract our validation logic out of our command handler and add it to a validation handler which will be invoked prior to the command handler.
The one piece of the puzzle that I can’t show exactly in this example will be dependent on what container you use. When you create a new instance of MediatR you provide a single and multi instance factory in the constructor. Generally this will be your preferred container. Check out our container docs to see how you register a decorator.
I’d love to hear how you handle command or query validation. Please share in the comments below or on twitter.