Generation

In diesem Artikel möchte ich veranschaulichen, wie anhand eines JSON Schema eine UI dynamisch generiert werden kann. Diese UI soll dann bei der Zusammenstellung eines Modells dienen, welches wiederum als Basis für die Erstellung eines Request-Objekts herangezogen wird. Damit lässt sich eine dynamische Oberfläche für eine REST-Schnittstelle erstellen, welches mind. JSON unterstützt. Dieser Anwendungsfall ist dann hilfreich, wenn die REST-Schnittstelle eine komplexe Domain-Struktur besitzt und die Mittel von swagger-ui nicht ausreichen.

Dokumentation - es gibt nichts schlimmeres als nicht aktuelle und falsche Dokumentation. Da ist sogar keine Dokumentation besser. Keine Dokumentation ist spätestens dann keine Option, wenn mehrere Teilnehmer existieren und die Software für einen breiten/öffentlichen Nutzerkreis angedacht ist. Hier möchte ich mal aufzeigen, wie einfach Dokumentation sein kann. Spaß kann es sogar auch machen.