https://github.com/fuinorg/ddd-4-java
Base classes for Domain Driven Design (DDD) with Java
https://github.com/fuinorg/ddd-4-java
Last synced: 3 months ago
JSON representation
Base classes for Domain Driven Design (DDD) with Java
- Host: GitHub
- URL: https://github.com/fuinorg/ddd-4-java
- Owner: fuinorg
- License: lgpl-3.0
- Created: 2014-03-28T12:21:59.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2026-01-26T21:53:42.000Z (6 months ago)
- Last Synced: 2026-02-19T04:37:02.512Z (5 months ago)
- Language: Java
- Size: 1020 KB
- Stars: 86
- Watchers: 6
- Forks: 18
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - DDD4Java
README
# ddd-4-java
# Domain Driven Design for Java
Base classes for Domain Driven Design (DDD) with Java.
[](https://github.com/fuinorg/ddd-4-java/actions/workflows/maven.yml)
[](https://sonarcloud.io/dashboard?id=org.fuin.ddd4j%3Addd-4-java)
[](https://maven-badges.herokuapp.com/maven-central/org.fuin/ddd-4-java/)
[](https://www.gnu.org/licenses/lgpl.html)
[](https://openjdk.java.net/projects/jdk/17/)
## Versions
- [0.7.0](release-notes.md#070) New Jackson module
- [0.6.0](release-notes.md#060) **Incompatible new module structure**
- 0.5.x (or later) = **Java 17** with new **jakarta** namespace
- 0.3.x/0.4.x = **Java 11** before namespace change from 'javax' to 'jakarta'
- 0.2.1 = **Java 8**
## Documentation
You can find the [documentation](https://app.gitbook.com/@fuinorg/s/ddd-4-java/) of the project
at [gitbook](https://app.gitbook.com/@fuinorg/spaces/) (*Work in progress* - Just started!).
## Presentation
http://de.slideshare.net/michael-schnell/ddd-4java/ (Rather old - The git book above is a bit more up-to-date)
## Example
See [ddd-cqrs-4-java-example](https://github.com/fuinorg/ddd-cqrs-4-java-example) for example microservices using the
classes of this library.
## Additional information
### EncryptedData
For example the [GDPR](https://gdpr.eu/) data protection rules requires to "delete" personal data on request. This can
be done by encrypting the personal data in the event with a secret key. When the user is deleted, you can simply throw
away that key, and it is no longer possible to access the personal data in the stored events.
The [EncryptedData](src/main/java/org/fuin/ddd4j/ddd/EncryptedData.java) class provides a basic structure with the
relevant information to encrypt/decrypt such personal data in events.
Here is an example of an event with "personal-data" of
type [EncryptedData](src/main/java/org/fuin/ddd4j/ddd/EncryptedData.java):
```json
{
"event-id": "518efad9-fb09-419e-acb6-50f1bc0c1e3e",
"event-timestamp": "2022-01-22T09:04:18.811501046+01:00[Europe/Luxembourg]",
"entity-id-path": "USER 5c09fc35-11e8-49d0-87ef-47c1d2738998",
"personal-data": {
"key-id": "secret/user/5c09fc35-11e8-49d0-87ef-47c1d2738998",
"key-version": "1",
"content-type": "application/json; encoding=UTF-8; version=1",
"data-type": "PersonalData",
"encrypted-data": "gK1UpxAwislfXCcB3yAPo83uxCPxdIJsf1x64lWckEi21oZiwIjHudEoeJge7KksfougPkHKl08/1ZW/iU7tqnVF8uv5a3Fh79lHPcHBkePhCOzoDnIh05IfVA2IrTQ6"
}
}
```
### EncryptedDataService
The [EncryptedDataService](src/main/java/org/fuin/ddd4j/ddd/EncryptedDataService.java) interface defines for
encrypting/decrypting [EncryptedData](src/main/java/org/fuin/ddd4j/ddd/EncryptedData.java) and handling versioned secret
keys.
There are two implementations that can be used for tests:
- [InMemoryCryptoService](https://github.com/fuinorg/ddd-cqrs-unit/blob/master/src/main/java/org/fuin/dddcqrsunit/InMemoryCryptoService.java)
for simple in-memory unit tests
- [VaultCryptoService](https://github.com/fuinorg/ddd-cqrs-unit/blob/master/src/main/java/org/fuin/dddcqrsunit/VaultCryptoService.java)
for unit tests with the HashiCorp Vault [Transit Secrets Engine](https://www.vaultproject.io/docs/secrets/transit)
## Snapshots
Snapshots can be found on
the [OSS Sonatype Snapshots Repository](http://oss.sonatype.org/content/repositories/snapshots/org/fuin "Snapshot Repository").
Add the following to
your [.m2/settings.xml](http://maven.apache.org/ref/3.2.1/maven-settings/settings.html "Reference configuration") to
enable snapshots in your Maven build:
```xml
sonatype.oss.snapshots
Sonatype OSS Snapshot Repository
https://oss.sonatype.org/content/repositories/snapshots
false
true
```