Description of EventSourcing, with code examples. Lists a number of possible usecases for EventSourcing

1. EventSourcing applied
Rickard Öberg, Jayway
Date

2. Agenda
✤ Domänmodeller och data
✤ Vad är EventSourcing
✤ Kodexempel
✤ Användning av EventSourcing

3. Domänmodeller och data

4. Snapshots
ORM

5. Klient
Snapshots
ORM

6. Klient
Servicefacade
Snapshots
ORM

7. Klient
Servicefacade
Snapshots
ORM

8. Klient
Servicefacade
Domänmodell
Snapshots
ORM

9. Klient
Servicefacade
Domänmodell
Snapshots
ORM

10. Klient
Servicefacade
Domänmodell
Snapshots
Datalagring
ORM

11. Klient
Servicefacade
Domänmodell
Snapshots
Datalagring
ORM

12. 3-i-1
✤ Tre typer av data:
✤ Flaggor och status
✤ Fritext
✤ Rapportstöd

13. Ändring av projektionen?
✤ “Spara vem som gjorde vad och när”
✤ “Ändra riktning på associationen”
✤ “Lägg till beräkning”
✤ “Fritextsökning!”

14. Vad är EventSourcing

16. Klient
Servicefacade
Domänmodell
Kommandon
Events
Eventlagring

17. Kodexempel

18. void setDescription(String newDescription)
{
description().set(newDescription);
}

19. void changeDescription(String newDescription)
{
if (... description is ok ...)
changedDescription(newDescription);
}
@DomainEvent
void changedDescription(String newDescription)
{
description().set(newDescription);
}

20. UnitOfWork uow = unitOfWorkFactory.newUnitOfWork( UsecaseBuilder.newUsecase( "Change
description" ));
uow.metaInfo().set( administratorPrincipal );
TestEntity entity = uow.newEntity( TestEntity.class );
entity.changedDescription( "New description" );
uow.complete();

21. public interface UnitOfWorkDomainEventsValue
extends ValueComposite
{
// Version of the application that created these events
Property<String> version();
// Usecase name
Property<String> usecase();
// When the event occurred
Property<Long> timestamp();
// Who performed the event. Taken from CurrentUser service.
@Optional
Property<String> user();
// List of events for this transaction
@UseDefaults
Property<List<DomainEventValue>> events();
}

22. public interface DomainEventValue
extends ValueComposite
{
// Type of the entity being invoked
Property<String> entityType();
// Id of the entity that generated the event
Property<String> entityId();
// Name of method/event
Property<String> name();
// Method parameters as JSON
Property<String> parameters();
}

23. EventSource source = ...
source.events( 0, Long.MAX_VALUE ).transferTo( Transforms.map( new
Function<UnitOfWorkDomainEventsValue, String>()
{
public String map( UnitOfWorkDomainEventsValue unitOfWorkDomainEventsValue )
{
return unitOfWorkDomainEventsValue.toJSON();
}
}, Outputs.systemOut()));

24. {"events":[{"entityId":"1da7e923-f9b2-4588-9967-
cb29e18098be-0","entityType":"org.qi4j.library.eventsourcing.domain.DomainEventTest
$TestEntity","name":"changedDescription","parameters":"{"param0":"New description
"}"}],"timestamp":1295860519645,"usecase":"Change
description","user":"administrator","version":"1.0"}

25. Användning av EventSourcing

26. Separat rapportmodell
Server
Atom Consumer Rapportdatabas
Consumer Rapportdatabas

27. Multipel persistens
Server Lucene Neo4j
Atom Consumer Consumer

28. Application Events
Server
Atom
Consumer “SentEmailEvent” SendEmailService

29. Replikering
Master Slave Slave
Atom
Staging

30. Backup
✤ Ta snapshot backup varje natt
✤ Ta kontinuerlig backup av events via replikering
✤ Vid restore: ta tillbaka snapshot och gör replay på events

31. Audit log / debugging
✤ Kan se alla operationer som gjorts, av vem, och när
✤ Juridiskt användbart
✤ Debugging av modellen
✤ Vilka funktioner används mest? Minst?

32. Q&A
✤ rickard.oberg@jayway.com
✤ qi4j.org
✤ qi4j-library-eventsourcing
✤ qi4j-library-eventsourcing-jdbm
✤ qi4j-library-eventsourcing-rest