broadway / event-store-mongodb

Event store implementation using MongoDB

Broadway

Broadway is a project providing infrastructure and testing helpers for creating CQRS and event sourced applications. Broadway tries hard to not get in your way. The project contains several loosely coupled components that can be used together to provide a full CQRS\ES experience.

About

Read the blog post about this repository at:

• http://labs.qandidate.com/blog/2014/08/26/broadway-our-cqrs-es-framework-open-sourced/

Installation

$ composer require broadway/broadway

Documentation

You can find detailed documentation of the Broadway bundle on broadway.github.io/broadway.

Feel free to join #qandidate on freenode with questions and remarks!

Acknowledgements

The broadway project is heavily inspired by other open source project such as AggregateSource, Axon Framework and Ncqrs.

We also like to thank Benjamin, Marijn and Mathias for the conversations we had along the way that helped us shape the broadway project. In particular Marijn for giving us access to his in-house developed CQRS framework.

License

MIT, see LICENSE.

event-store-mongodb's Issues

Remove extraneous broadway namespace mapping

The extra Broadway\\ namespace mapping can be removed if the autoloading is correctly setup.

New release?

There's a bugfix (missing void returntype) waiting to be released. Is there any issue holding that release back? Can I help?

Namespace of test cases is incorrect

Currently the namespace of the test cases (Broadway\\EventStore\\Mongo\\) are different from the library's namespace (Broadway\\EventStore\\MongoDB\\). These should be the the same.

MongoDBEventStore::append is not strictly compatible with EventStore::append due to missing return type

Declaration of Broadway\EventStore\MongoDB\MongoDBEventStore::append($id, Broadway\Domain\DomainEventStream $eventStream) must be compatible with Broadway\EventStore\EventStore::append($id, Broadway\Domain\DomainEventStream $eventStream): void in .../vendor/broadway/event-store-mongodb/src/MongoDBEventStore.php on line 23

Missing serializer services in example setup

The services reference broadway.serializer.payload and broadway.serializer.metadata which aren't defined. For simplicity reasons, I'd just do this:

services:
    broadway.event_store.mongodb_client:
        class: MongoDB\Client
        arguments:
            - 'mongodb://%mongodb_host%:%mongodb_port%'

    broadway.event_store.mongodb_collection:
        class: MongoDB\Collection
        factory:
            - '@broadway.event_store.mongodb_client'
            - 'selectCollection'
        arguments:
            - '%mongodb_database%'
            - 'events'

    broadway.serializer:
        class: Broadway\Serializer\ReflectionSerializer

    broadway.event_store.mongodb:
        class: Broadway\EventStore\MongoDB\MongoDBEventStore
        arguments:
            - '@broadway.event_store.mongodb_collection'
            - '@broadway.serializer'
            - '@broadway.serializer'

• This formats argument lists on separate lines (better readability, IMHO).
• It adds a serializer.
• It uses the serializer for both payload and metadata.