To use it, simply implement the IConvertEvents interface and hookup the EventConverter when Wiring up the store.
Implemented an event converting IPipelineHook
What if the interface IConvertEvents<,> is implemented explicitly?
Thanks for noticing!
I will add support for getting explicitly implemented methods as well.
I'll submit a new Pull request in about 7 hours or so. Or something.
An implementation of an event conversion mechanism as a IPipelineHook
Deleted old EventConverter
You'll probably want have the Convert function use a while loop internally because it's possible that you want to convert eventA to eventB and then eventB to eventC. It would also be really nice to have a constructor overloads so that those who wanted to use explicit registration instead of reflection-based wireup could do so (as per the project goals found in the readme). Lastly, I noticed the IConvertEvents interface was .NET 4.0-specific. I'm still supporting .NET 3.5 for this release (which should be the last one). Any particular reason for the in/out covariant/contravariant parameters on the interface?
The looping thing is a great idea. I will implement it.
I was thinking about the explicit registration thing this morning and it should indeed be allowed. Assembly scanning is not a very nice way to do it. Also, I am thinking about if it should make it into its own thing in the Wireup but I better leave the decision about that to you.
The in/out covariant/contravariant thing is just a alt-enter Resharper reflex consequence. My brain had no part in that at all. It has no function whatsoever and I'll remove it.
The only other thought I had was about the location of the conversion. In the back of my mind, I always pictured conversion as something a serialization wrapper would take care of. In other words, I've been thinking we could accomplish the same thing from the serializer level. I'm still back and forth on this one though and a pipeline hook is definitely a place where it could work, but at that point, the ordering of the pipeline hooks may become important.
You have a point. The sooner the better.
Still, the interface IConvertEvents<,> is pretty much what we want, right?
How about promoting the conversion to its own thing?
The default behavior is no conversion.
you can choose something like .UsingEventConversion().AutoScan() for automatic scanning of converters, like I have done now.
You can also choose something like .UsingEventConversion().WithConverters.FromAssemblyContainingType(typeof(MyConverter)). Here I think we can improve the API, but you get the idea.
Then for the implementation, the conversion will not be a IPipelineHook but occur just before the pipeline hooks executes, in OptimisticEventStore.GetFrom(..). Line #65 or so. OptimisticEventStore will get the converters injected.
I think that might be the best place. Regardless, this way the functionality is kept internal so that compability is kept even though the serializer wrapper idea of yours materializes and gets implemented.
Added recursion for upconversion of events in multiple steps
Changed the implementation from being a IPipelineHook to being its ow…
Fixed a possible nullref
Here is another suggestion. Forgive my commit frenzy. I evidently suck at git.
In this commit, the Event conversion has become its own thing and is configurable from the Wireup. I don't know what you think about me poking around in the API, but as this is a suggestion I took the liberty in doing so.
Have a look and tell me what you think.
Okay, here's what I'd like to do. I think making the IConvertCommits is a great interface and it should definitely have it's own interface like you have done. After looking at the issues and different storage engines, I determined that wrapping it up in the serializer is absolutely the wrong place, so it's good we didn't go down that road. However, I believe that wrapping things up in a "pipeline hook" is the right place. I'm trying to keep the primary EventStore objects as clean and uncluttered as possible which is one of the reasons I took the dispatcher and put it into a pipeline hook.
One other big one is that I'd like to move all reflection and type/assembly scanning into the wireup and out of the constructor. Ideally the converter which just be using a Dictionary<Type, Func<TIn, TOut>> and however those were discovered or registered is a wireup issue.
Ok, that sounds great!
I'll turn it back into a IPipelineHook and try to figure out a useful API for the Wireup. I'll also move all scanning things to the wireup. I might commit something tonight.
Implemented the event upconverter as a IPipelineHook that is register…
…ed explicitly using Wireup
Added prevention for creation of multiple converters with the same so…
Removed failing event converter so that the tests works
Here we go! This version should do it!
The default behaviour now is that there are no event conversion. To enable it, you have to explicitly use the Wireup. There are three ways to do it.
The simplest way is to use .UsingEventUpconversion() which makes the Wireup scan all assemblies for converters.
The second alternative is to use .WithConvertersFrom(params Assembly) which only scans the supplied assemblies.
The final alternative is to use .WithConvertersFromAssemblyContaining(params Type) which scans all assemblies containing the supplied types.
The event converter pipeline hook will use the converters found from scanning and convert events when they are retrieved from the underlying persistence. This will take place before any other pipeline hook registered executes.
The event converter convert specific events recursively which means that an event of type Event1 will be converted to Event2 and then to Event3 and so forth. This recursion will continue until there is no converter found.
Event converters are created by implementing the IConvertEvents<TSource, TTarget> interface. The event converter chooses which converter to use based on TSource.
Feel free to trash the Wireup API as you see fit.
Let me know what you think.