From 5c9faf7491f32a43eff47995d2947e715245f3ae Mon Sep 17 00:00:00 2001 From: Oliver Drotbohm Date: Sat, 13 Mar 2021 22:38:28 +0100 Subject: [PATCH] A few details about the interface based DDD building blocks model. --- readme.adoc | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/readme.adoc b/readme.adoc index 9154b5f..d507944 100644 --- a/readme.adoc +++ b/readme.adoc @@ -30,7 +30,26 @@ So in a banking domain we don't want `BankAccountEntity`, `CurrencyVO` or even ` Instead, we want `BankAccount`, `Currency` and `Accounts` – like in the example above. Still, we want to express that a given class (or other architectural element) is a special building block; i.e. uses a design pattern. -jMolecules provide a set of standard annotations (and alternatively marker interfaces) for the building blocks known from DDD. +jMolecules provide a set of standard annotations for the building blocks known from DDD. + +=== Using a type based model + +As an alternative to the above mentioned annotations, jMolecules also provides a set of interfaces, largely based on the ideas presented in John Sullivan's series https://scabl.blogspot.com/p/advancing-enterprise-ddd.html["Advancing Enterprise DDD"]. +They allow expressing relationships between the building blocks right within the type system, so that the compiler can help to verify model correctness and the information can also be processed by Java reflection more easily. + +* `Identifier` -- A type to represent types that are supposed to act as identifiers. +* `Identifiable` -- Anything that's exposing an identifier. +* `Entity, ID> extends Identifiable` -- An entity, declaring to which `AggregateRoot` it belongs and which identifier it exposes. +* `AggregateRoot, ID extends Identifier> extends Entity` -- an aggregate root being an `Entity` belonging to itself exposing a dedicated `Identifier` +* `Association, ID extends Identifier> extends Identifiable` -- an explicit association to a target `AggregateRoot`. + +This arrangement gives guidance to modeling and allows to easily verify the following rules, potentially via reflection: + +* Enforced, dedicated identifier types per aggregate to avoid identifiers for different aggregates mixed up. +* `AggregateRoot` must only refer to `Entity` instances that were declared to belong to it. +* ``AggregateRoot``s and ``Entity``s must only refer to other `AggregateRoots` via `Association` instances. + +For automated verification and runtime technology integration see https://github.com/xmolecules/jmolecules-integrations#jmoleculestechnology-integrations[jMolecules Integrations]. === Libraries * link:jmolecules-ddd[`jmolecules-ddd`] -- annotations and interfaces to express DDD building blocks (value objects, entities, aggregate roots etc.) in code.