Skip to content

A port of Edument AB's CQRS sample app to JavaScript

Notifications You must be signed in to change notification settings

blrobin2/cqrs-cafe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CQRS Cafe

An exercise in applying CQRS concepts written in C# to a JavaScript platform. The foundational code is in the lib/ folder, and can probably be ported to it's own NPM package at some point. In addition to what was in the original library, I added a GUID generator, an Extendable Error so you can use it as a base Error class, and a Type Checker for class instatiation.

Why?

Why Use This?

There's no real world application for this, as you'd probably just use Redux. But for people like me who came from the OOP world, seeing these concepts acted out using objects can help make explicit that separation of commands and queries.

Why React?

The only reason the view layer with React and React Router is because I find it easy to scaffold things out fast in it, but there's nothing about the library itself that requires it.

Why Not TypeScript?

I initially tried to write this in TypeScript, but I found the limitations of generics not living in the runtime code made for a lot of redudancy. When I embraced the flexibility of JavaScript, I was able to get a lot done. I created a Type Checker for your DTOs, Commands, and Events, and provided example usage in OpenTab and PlaceOrder commands.

Why In Memory Storage and Not X?

I wanted this to be easily run in the browser, without having to worry about setting up a server or anything. If you wanted to, you could write an Event Store that ties to an API or to your preferred SQL/NoSQL persistence layer and initialize it in the Domain instead of the provided Event Store.

How it works

The index.js initializes the React stuff, Domain.js initializes the MessageDispatcher, EventStore, Aggregates, and Queries.

The EventStore holds all of the events that have happened in the system, organized by Aggregate ID. Because the provided one is in memory, it will lose all events with a screen refresh.

The Message Dispatcher consumes Aggregates and Queries, passing commands to the Aggregates set up to consume them. The Aggregate takes the command, inspects it with the domain constraints, throwing errors if the command is not consumable, and triggering events if it is. The Aggregates and Queries listen for these events and have appliers for their event on how to update themselves.

In the Aggregate, it looks for methods prepended with 'apply' for applying Events that happen in the system, and methods prepended with 'handle' for handling Commands that are dispatched.

In queries, it looks at the 'iSubscribeTo' property to determine which Events about which it should notify the query, and methods prepended with 'apply' for applying Events that happen in the system.

The queries are bound to the Domain so that we only initialize them once and they can hold the most recent state as a result of the events.

How to use

  • To play: npm run watch
  • To test npm test
  • To build: npm run build

Acknowledgements

About

A port of Edument AB's CQRS sample app to JavaScript

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published