{"id":1755,"date":"2025-10-03T07:42:02","date_gmt":"2025-10-03T05:42:02","guid":{"rendered":"https:\/\/www.vintrospektiv.de\/?p=1755"},"modified":"2025-10-03T07:42:02","modified_gmt":"2025-10-03T05:42:02","slug":"tipps-zu-plantuml","status":"publish","type":"post","link":"https:\/\/www.vintrospektiv.de\/index.php\/2025\/10\/tipps-zu-plantuml\/","title":{"rendered":"Tipps zu PlantUML"},"content":{"rendered":"\n

Der zweite der angek\u00fcndigten<\/a> Artikel hat streng genommen auf diesen Seiten nicht viel verloren: Der einzige Bezug zu Spielen ist, dass sie programmiert werden m\u00fcssen und dass man vor dem eigentlichen Programmieren meist eine gewisse Planung vornimmt.<\/p>\n\n\n\n

Ein Teil dieser Planung findet in Form von UML (Unified Modeling Language) statt \u2013 auch wenn ein Freund mir vor einiger Zeit versicherte, dass UML in seinem Umfeld keine Rolle mehr spielt. Man kann mit dieser Symbolsprache verschiedene Aspekte der Programmierung visualisieren, von den ersten Entw\u00fcrfen \u00fcber Abl\u00e4ufe und Zust\u00e4nde bis hin zu den Klassen in einem Projekt (die wohl auch den h\u00e4ufigsten Anwendungsfall darstellen).<\/p>\n\n\n\n

PlantUML ist ein Tool f\u00fcr die Umsetzung von UML. W\u00e4hrend die meisten g\u00e4ngigen UML-Modellierungsumgebungen auf grafischen Bausteinen aufbauen, wird in PlantUML direkt in einer Textsprache gearbeitet, die erst als Zusatzschritt in die grafische Endform umgewandelt wird. Trotzdem ist PlantUML gerade wegen der Klarheit und damit verbundenen geringen Fehleranf\u00e4lligkeit, aber auch wegen der relativen Vollst\u00e4ndigkeit der UML-Implementierung zu Recht beliebt.<\/p>\n\n\n\n

Dieser Artikel ist im Rahmen des Moduls “Software Engineering 2” entstanden, in dem ich ihn als Hilfe f\u00fcr aktuelle und k\u00fcnftige Mitstudierende schrieb.<\/p>\n\n\n\n

Software Engineering: Tipps zu PlantUML<\/h2>\n\n\n\n

Miron Schmidt, Sommersemester 2025<\/p>\n\n\n\n

PlantUML funktioniert normalerweise sehr fl\u00fcssig, es gibt aber ein paar \u00e4rgerliche Probleme, die sehr viel Zeit kosten k\u00f6nnen. Die Verteilung der Entit\u00e4ten im Diagramm kann PlantUML \u00fcberfordern, vor allem in Verbindung mit Paketen oder komplexen Assoziationen. (Ich fasse hier alle Arten von Dingen, die miteinander in Bezug gesetzt werden k\u00f6nnen, als Entit\u00e4ten zusammen, da es ja verschiedene UML-Diagramme gibt, in denen nicht nur Klassen vorkommen k\u00f6nnen.)<\/p>\n\n\n\n

Hier sind ein paar Tipps, mit denen man den Frust im Zaum halten kann, wenn PlantUML nicht so will wie man selbst.<\/p>\n\n\n\n

Zuerst ein allgemeiner Hinweis: Die Form<\/em> einer Verbindung (mit\/ohne Pfeil, Vererbung, gestrichelt usw.) ist beim Auftreten von Schwierigkeiten unerheblich. Es geht nur um das Bilden von Pfaden zwischen den Entit\u00e4ten, das problematisch sein kann \u2013 daher spielt die Richtung<\/em>, also die Seite(n), an der bzw. denen der Pfeil sitzt, sehr wohl eine Rolle. Wenn Entit\u00e4ten, die miteinander in Bezug gesetzt werden m\u00fcssen, aus organisatorischen Gr\u00fcnden weit auseinanderliegen, schlimmstenfalls mehrmals in einem Diagramm, ist es ebenfalls schwieriger, sinnvolle Verbindungen zu finden, als wenn sie geordnet nebeneinander zu finden sind.<\/p>\n\n\n\n

Mit Paketen kommt PlantUML etwa prinzipiell gut zurecht, wenn die Pfade aber kompliziert sind, werden einzelne Entit\u00e4ten mitunter falsch paketiert.<\/p>\n\n\n\n

Ein Beispiel: Dieser Code \u2013<\/p>\n\n\n\n

class Eingang\nEingang <-> Flur\npackage Haus {\n  class Wohnzimmer\n  Wohnzimmer <-> Flur\n  Wohnzimmer <-- Kueche\n  class Kueche\n  Kueche <-> Flur\n  class Flur\n  class Schlafzimmer\n  Schlafzimmer <-> Flur\n}\npackage Garten {\n  class Hundehuette\n  Hundehuette <-> Terrasse\n  Hundehuette <-> Eingang\n  class Terrasse\n  Terrasse <-> Flur\n}<\/code><\/pre>\n\n\n\n
\u2013 f\u00fchrt zu diesem Diagramm:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Man beachte, dass die Klasse Flur<\/em> in der Darstellung aus dem Paket Haus<\/em> herausgezogen wurde. (Die T\u00fcr zwischen K\u00fcche und Wohnzimmer ist in dieser Demonstration \u00fcbrigens eine Klappt\u00fcr, die nur aus der K\u00fcche ins Wohnzimmer durchlaufen werden kann.)<\/p>\n\n\n\n
Der wichtigste Tipp ist daher: Alle Assoziationen sollten ans Ende der Datei gestellt werden. PlantUML ist besser darin, sie auf diese Weise nacheinander zu ber\u00fccksichtigen, als wenn sie nahe bei den Entit\u00e4ten platziert werden (was f\u00fcr menschliche Augen allerdings strukturierter wirkt).<\/p>\n\n\n\n
Das Beispiel sieht nun so aus:<\/p>\n\n\n\n
class Eingang\npackage Haus {\n  class Wohnzimmer\n  class Kueche\n  class Flur\n  class Schlafzimmer\n}\npackage Garten {\n  class Hundehuette\n  class Terrasse\n}\nEingang <-> Flur\nWohnzimmer <-> Flur\nWohnzimmer <-- Kueche\nKueche <-> Flur\nSchlafzimmer <-> Flur\nHundehuette <-> Terrasse\nHundehuette <-> Eingang\nTerrasse <-> Flur<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die Pakete stimmen jetzt, aber die Assoziationen, die im ersten Versuch schon sehr wirr aussahen, sind eher noch un\u00fcbersichtlicher als vorher.<\/p>\n\n\n\n
Entit\u00e4ten, die von PlantUML an eine ung\u00fcstige Stelle gesetzt werden, und Assoziationen zwischen den Entit\u00e4ten k\u00f6nnen im Code von Hand verschoben werden. Manchmal finden sich dann bessere Verbindungen als vorher. (Die Logik dahinter ist nicht sofort eing\u00e4ngig, aber durch Ausprobieren erahnt man nach und nach Regeln.)<\/p>\n\n\n\n
Nach einigem Schieben (vor allem zu beachten: die umgedrehte Assoziation zwischen K\u00fcche und Wohnzimmer) kommen wir zu folgendem Code und dem daraus resultierenden Diagramm, mit dem wir uns absolut zufrieden geben k\u00f6nnen:<\/p>\n\n\n\n
class Eingang\npackage Haus {\nclass Flur\nclass Wohnzimmer\nclass Schlafzimmer\nclass Kueche\n}\npackage Garten {\nclass Terrasse\nclass Hundehuette\n}\nFlur <-> Eingang\nFlur <-> Terrasse\nFlur <-> Wohnzimmer\nKueche --> Wohnzimmer\nKueche <-> Flur\nSchlafzimmer <-> Flur\nHundehuette <-> Terrasse\nHundehuette <-> Eingang<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Hoffentlich klar ist: Eine Anpassung der fachlichen Ausarbeitung (Assoziationen, Pakete) sollte nur als allerletzter Ausweg in Betracht gezogen werden. Normalerweise reichen die zuvor genannten Tipps aus, um das Diagramm zu reparieren.<\/p>\n\n\n\n
Und damit w\u00fcnsche ich viel Spa\u00df beim eigenen Ausprobieren dieser Hinweise! Der Beispielcode eignet sich \u00fcbrigens gut zum Experimentieren, da ja schon einige \u00c4nderungen mit ihren Ergebnissen vorgef\u00fchrt wurden.<\/p>\n","protected":false},"excerpt":{"rendered":"
Der zweite der angek\u00fcndigten Artikel hat streng genommen auf diesen Seiten nicht viel verloren: Der einzige Bezug zu Spielen ist, dass sie programmiert werden m\u00fcssen und dass man vor dem eigentlichen Programmieren meist eine gewisse Planung vornimmt. Ein Teil dieser Planung findet in Form von UML (Unified Modeling Language) statt \u2013 auch wenn ein Freund […]<\/p>\n","protected":false},"author":1,"featured_media":1761,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"pgc_sgb_lightbox_settings":"","footnotes":""},"categories":[16],"tags":[],"class_list":["post-1755","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-introspektiv"],"_links":{"self":[{"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/posts\/1755","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/comments?post=1755"}],"version-history":[{"count":2,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/posts\/1755\/revisions"}],"predecessor-version":[{"id":1760,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/posts\/1755\/revisions\/1760"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/media\/1761"}],"wp:attachment":[{"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/media?parent=1755"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/categories?post=1755"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.vintrospektiv.de\/index.php\/wp-json\/wp\/v2\/tags?post=1755"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}