Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Well designed query commands and/or specifications

I've been searching for quite some time for a good solution to the problems presented by the typical Repository pattern (growing list of methods for specialized queries, etc.. see: http://ayende.com/blog/3955/repository-is-the-new-singleton).

I really like the idea of using Command queries, particularly through use of the Specification pattern. However, my problem with specification is that it only relates to the criteria of simple selections (basically, the where clause), and does not deal with the other issues of queries, such as joining, grouping, subset selection or projection, etc.. basically, all the extra hoops many queries must go through to get the correct set of data.

(note: I use the term "command" as in the Command pattern, also known as query objects. I'm not talking about command as in command/query separation where there is a distinction made between queries and commands (update, delete, insert))

So I'm looking for alternatives that encapsulate the entire query, but still flexible enough that you're not just swapping spaghetti Repositories for an explosion of command classes.

I've used, for instance Linqspecs, and while I find some value in being able to assign meaningful names to selection criteria, it's just not enough. Perhaps i'm seeking a blended solution that combines multiple approaches.

I am looking for solutions that others may have developed to either address this problem, or address a different problem but still satisfies these requirements. In the linked article, Ayende suggests using the nHibernate context directly, but I feel that largely complicates your business layer because it now also has to contain query information.

I'll be offering a bounty on this, as soon as the waiting period elapses. So please make your solutions bounty worthy, with good explanations and I will select the best solution, and upvote the runners up.

NOTE: I'm looking for something that is ORM based. Doesn't have to be EF or nHibernate explicitly, but those are the most common and would fit the best. If it can be easily adapted to other ORM's that would be a bonus. Linq compatible would also be nice.

UPDATE: I'm really surprised that there aren't many good suggestions here. It seems like people are either totally CQRS, or they're completely in the Repository camp. Most of my apps are not complex enough to warrant CQRS (something with most CQRS advocates readily say that you should not use it for).

UPDATE: There seems to be a little confusion here. I'm not looking for a new data access technology, but rather a reasonably well designed interface between business and data.

Ideally, what i'm looking for is some kind of cross between Query objects, Specification pattern, and repository. As I said above, Specification pattern only deals with the where clause aspect, and not the other aspects of the query, such as joins, sub-selects, etc.. Repositories deal with the whole query, but get out of hand after a while. Query objects also deal with the whole query, but I don't want to simply replace repositories with explosions of query objects.

like image 971
Erik Funkenbusch Avatar asked Jan 20 '13 00:01

Erik Funkenbusch


People also ask

What is query Specification?

A query specification derives a table composed of retrieval results containing columns of selection expressions, by specifying retrieval conditions (table expressions) for a table and items (selection expressions) in which the retrieval results are to be output.

What is CQRS pattern?

CQRS stands for Command and Query Responsibility Segregation, a pattern that separates read and update operations for a data store.

What is a query handler C#?

The query handler takes the query object and returns the result (also wrapped in ValueTask). We could skip this interface, but C# does not allow function without classes, so we'll still have to create the class even if we use just static handlers and pure functions.


2 Answers

Disclaimer: Since there aren't any great answers yet, I decided to post a part from a great blog post I read a while ago, copied almost verbatim. You can find the full blog post here. So here it is:


We can define the following two interfaces:

public interface IQuery<TResult> { }  public interface IQueryHandler<TQuery, TResult> where TQuery : IQuery<TResult> {     TResult Handle(TQuery query); } 

The IQuery<TResult> specifies a message that defines a specific query with the data it returns using the TResult generic type. With the previously defined interface we can define a query message like this:

public class FindUsersBySearchTextQuery : IQuery<User[]> {     public string SearchText { get; set; }     public bool IncludeInactiveUsers { get; set; } } 

This class defines a query operation with two parameters, which will result in an array of User objects. The class that handles this message can be defined as follows:

public class FindUsersBySearchTextQueryHandler     : IQueryHandler<FindUsersBySearchTextQuery, User[]> {     private readonly NorthwindUnitOfWork db;      public FindUsersBySearchTextQueryHandler(NorthwindUnitOfWork db)     {         this.db = db;     }      public User[] Handle(FindUsersBySearchTextQuery query)     {         return db.Users.Where(x => x.Name.Contains(query.SearchText)).ToArray();     } } 

We can now let consumers depend upon the generic IQueryHandler interface:

public class UserController : Controller {     IQueryHandler<FindUsersBySearchTextQuery, User[]> findUsersBySearchTextHandler;      public UserController(         IQueryHandler<FindUsersBySearchTextQuery, User[]> findUsersBySearchTextHandler)     {         this.findUsersBySearchTextHandler = findUsersBySearchTextHandler;     }      public View SearchUsers(string searchString)     {         var query = new FindUsersBySearchTextQuery         {             SearchText = searchString,             IncludeInactiveUsers = false         };          User[] users = this.findUsersBySearchTextHandler.Handle(query);             return View(users);     } } 

Immediately this model gives us a lot of flexibility, because we can now decide what to inject into the UserController. We can inject a completely different implementation, or one that wraps the real implementation, without having to make changes to the UserController (and all other consumers of that interface).

The IQuery<TResult> interface gives us compile-time support when specifying or injecting IQueryHandlers in our code. When we change the FindUsersBySearchTextQuery to return UserInfo[] instead (by implementing IQuery<UserInfo[]>), the UserController will fail to compile, since the generic type constraint on IQueryHandler<TQuery, TResult> won't be able to map FindUsersBySearchTextQuery to User[].

Injecting the IQueryHandler interface into a consumer however, has some less obvious problems that still need to be addressed. The number of dependencies of our consumers might get too big and can lead to constructor over-injection - when a constructor takes too many arguments. The number of queries a class executes can change frequently, which would require constant changes into the number of constructor arguments.

We can fix the problem of having to inject too many IQueryHandlers with an extra layer of abstraction. We create a mediator that sits between the consumers and the query handlers:

public interface IQueryProcessor {     TResult Process<TResult>(IQuery<TResult> query); } 

The IQueryProcessor is a non-generic interface with one generic method. As you can see in the interface definition, the IQueryProcessor depends on the IQuery<TResult> interface. This allows us to have compile time support in our consumers that depend on the IQueryProcessor. Let's rewrite the UserController to use the new IQueryProcessor:

public class UserController : Controller {     private IQueryProcessor queryProcessor;      public UserController(IQueryProcessor queryProcessor)     {         this.queryProcessor = queryProcessor;     }      public View SearchUsers(string searchString)     {         var query = new FindUsersBySearchTextQuery         {             SearchText = searchString,             IncludeInactiveUsers = false         };          // Note how we omit the generic type argument,         // but still have type safety.         User[] users = this.queryProcessor.Process(query);          return this.View(users);     } } 

The UserController now depends on a IQueryProcessor that can handle all of our queries. The UserController's SearchUsers method calls the IQueryProcessor.Process method passing in an initialized query object. Since the FindUsersBySearchTextQuery implements the IQuery<User[]> interface, we can pass it to the generic Execute<TResult>(IQuery<TResult> query) method. Thanks to C# type inference, the compiler is able to determine the generic type and this saves us having to explicitly state the type. The return type of the Process method is also known.

It is now the responsibility of the implementation of the IQueryProcessor to find the right IQueryHandler. This requires some dynamic typing, and optionally the use of a Dependency Injection framework, and can all be done with just a few lines of code:

sealed class QueryProcessor : IQueryProcessor {     private readonly Container container;      public QueryProcessor(Container container)     {         this.container = container;     }      [DebuggerStepThrough]     public TResult Process<TResult>(IQuery<TResult> query)     {         var handlerType = typeof(IQueryHandler<,>)             .MakeGenericType(query.GetType(), typeof(TResult));          dynamic handler = container.GetInstance(handlerType);          return handler.Handle((dynamic)query);     } } 

The QueryProcessor class constructs a specific IQueryHandler<TQuery, TResult> type based on the type of the supplied query instance. This type is used to ask the supplied container class to get an instance of that type. Unfortunately we need to call the Handle method using reflection (by using the C# 4.0 dymamic keyword in this case), because at this point it is impossible to cast the handler instance, since the generic TQuery argument is not available at compile time. However, unless the Handle method is renamed or gets other arguments, this call will never fail and if you want to, it is very easy to write a unit test for this class. Using reflection will give a slight drop, but is nothing to really worry about.


To answer one of your concerns:

So I'm looking for alternatives that encapsulate the entire query, but still flexible enough that you're not just swapping spaghetti Repositories for an explosion of command classes.

A consequence of using this design is that there will be a lot of small classes in the system, but having a lot of small/focused classes (with clear names) is a good thing. This approach is clearly much better then having many overloads with different parameters for the same method in a repository, as you can group those in one query class. So you still get a lot less query classes than methods in a repository.

like image 120
david.s Avatar answered Oct 02 '22 04:10

david.s


My way of dealing with that is actually simplistic and ORM agnostic. My view for a repository is this: The repository's job is to provide the app with the model required for the context, so the app just asks the repo for what it wants but doesn't tell it how to get it.

I supply the repository method with a Criteria (yes, DDD style), which will be used by the repo to create the query (or whatever is required - it may be a webservice request). Joins and groups imho are details of how, not the what and a criteria should be only the base to build a where clause.

Model = the final object or data structure neede by the app.

public class MyCriteria {    public Guid Id {get;set;}    public string Name {get;set;}     //etc  }   public interface Repository   {        MyModel GetModel(Expression<Func<MyCriteria,bool>> criteria);    } 

Probably you can use the ORM criteria (Nhibernate) directly if you want it. The repository implementation should know how to use the Criteria with the underlying storage or DAO.

I don't know your domain and the model requirements but it would be strange if the best way is that the app to build the query itself. The model changes so much that you can't define something stable?

This solution clearly requires some additional code but it doesn't couple the rest of the to an ORM or whatever you're using to access the storage. The repository does its job to act as a facade and IMO it's clean and the 'criteria translation' code is reusable

like image 39
MikeSW Avatar answered Oct 02 '22 03:10

MikeSW