Overview

Axon-Guice is an integration module between Google Guice and Axon Framework.

Axon Framework is a lightweight and powerful CQRS framework for Java. It has rich documentation and clean codebase. Integration module is built for 2.0 framework version.

CQRS approach motivation

"A single model cannot be appropriate for reporting, searching, and transactional behaviors." – Greg Young

"Every method should either be a command that performs an action, or a query that returns data to the caller, but not both." - Bertrand Meyer

Theory can be found here: * http://www.amazon.com/Implementing-Domain-Driven-Design-Vaughn-Vernon/dp/0321834577 * http://martinfowler.com/bliki/CQRS.html * http://en.wikipedia.org/wiki/Command–query_separation * http://www.slideshare.net/pjvdsande/rethink-your-architecture-with-cqrs * http://www.slideshare.net/pjvdsande/introduction-to-cqrs * http://www.udidahan.com/2009/12/09/clarified-cqrs/ * http://codebetter.com/gregyoung/2010/02/13/cqrs-and-event-sourcing/ * http://prezi.com/pvfwd4xscqxy/command-query-responsibility-segregation-evolution-of-the-layered-architecture/ * http://abdullin.com/journal/2010/10/22/top-10-reasons-to-do-cqrs-in-a-pdf.html * Exploring CQRS book from Microsoft

All reference documentation related to Axon Framework is here.

Project features

• Full support of 1-8 and 10 of original Axon Framework documentation parts (all parts except Spring integration);
• Highly customizable API;
• Ability to inject all major Axon Framework components: CommandBus, EventBus, CommandGateway, UnitOfWork, Repository;
• Option to perform components auto-discovery or specify all of them manually;
• Significant test coverage.

Quickstart

1. Read Axon manual - all Axon features is available with this project

2. Install a Axon-Guice module: // auto-discovery of all CQRS/Axon components install(new AxonGuiceModule("com.mycomp.domain"));

3. Define your Aggregate Roots, Entities, Commands/Events, Command/Event Handlers, Domain Services, Query Services, Sagas and so on

4. Override specific parts of AxonGuiceModule to meet your production requirements - for example you can use MongoEventStore instead of default FileSystemEventStore.

Mavenize

Artifact is available in the Central Maven repository: <dependency> <groupId>com.google.code.axon-guice</groupId> <artifactId>axon-guice</artifactId> <version>1.0.0</version> </dependency>