JUG im Juli: Data Contracts & Ausführbare Dokumentation
Am Mittwoch, dem 16. Juli 2025, laden die Java User Group Berlin-Brandenburg und innoQ Deutschland GmbH zu zwei Vorträgen ins Umspannwerk Kreuzberg ein.
Die Vorträge
Data Contracts sind die APIs für Daten (Jochen Christ)
In der Welt des Software-Engineerings wissen wir, wie wichtig explizite, klar dokumentierte und stabile Schnittstellen sind. Wir nutzen dazu OpenAPI oder AsyncAPI mit entsprechendem Tooling. In der Welt der Daten gab es bisher nichts Vergleichbares, aber unangekündigte Schemaänderungen sind leider omnipräsent. Data Contracts haben das Ziel, explizite, klar dokumentierte und stabile Schnittstellen für Daten einzuführen. Wie OpenAPI, aber eben für Daten. Ich stelle den Open-Source-Standard namens Data Contract Specification an einem Beispiel vor und zeige, wie man mit Open-Source-Tools die Daten gegen den Data Contract testen kann. Natürlich mit Live-Coding.
Ausführbare Dokumentation – Architekturregeln festhalten und testen (Falk Sippach)
Es ist kein Mythos, dass eine gute Architekturdokumentation ein Garant für erfolgreiche Softwareprojekte ist. Die Kunst und Herausforderung zugleich ist es jedoch, den Aufwand überschaubar und mit geeigneten Konzepten die Dokumentation lebendig zu halten. Leichtgewichtige Methoden, Vorlagen und Werkzeuge aus dem Docs-as-Code-Umfeld bringen das Dokumentieren näher an den Sourcecode und unterstützen Entwicklungs-Teams bei der Erstellung einer hochwertigen Architekturdokumentation.
Leider veraltet Dokumentation auch sehr schnell. In diesem Vortrag betrachten wir daher, wie wir eine selbst validierende, ausführbare Dokumentation nutzen können, um die Qualitätsansprüche der Softwarearchitektur wiederkehrend zu prüfen und mit Fitness Functions abzusichern. Dazu machen wir Architekturkonzepte im Code sichtbar z. B. mit xMolecules und ContextMapper, binden Software-Analyse-Werkzeuge wie jQAssistant ein bzw. führen regelmäßig programmatische Tests z. B. mit ArchUnit aus für einen kontinuierlichen Abgleich der Soll- und Ist-Strukturen. Ihr könnt diese Ideen in Eure Projekte übertragen, Eure Architekturdokumentation wird dadurch lebendig und Teil Eurer kontinuierlichen Qualitätsmaßnahmen.
Die Redner
Der Treffpunkt
Der Ablauf
Anschließend gibt es die Möglichkeit für Networking und Plausch.
Die Anmeldung
Über eine Voranmeldung zu der Veranstaltung über die Meetup-Gruppe der JUG Berlin-Brandenburg würden wir uns freuen, jedoch ist die Anmeldung nicht zwingend erforderlich. Wir freuen uns auf jeden Teilnehmer.