Seite 3: Fazit: OpenAPI Generator und die Community

Inhaltsverzeichnis

API First ist nun fest in den Lifecycle der Spring-Boot-Anwendung implementiert. Das garantiert technisch, dass die API-Dokumentation zu hundert Prozent exakt und aktuell ist. Es gibt auch im Team keine Missverständnisse mehr, ob etwa ein Parameter entweder ein String mit Y/N oder ein Boolean-Wert ist. Das Team kann jederzeit auf die Dokumentation verweisen und muss sich nicht explizit um das Updaten der Dokumentation kümmern.

Das im Artikel beschriebene ist nur ein kleiner Teil dessen, was der OpenAPI Generator leistet. Das Open-Source-Projekt ist sehr spannend und dynamisch mit großer und aktiver Community. Es bietet eine gute Gelegenheit für Entwicklerinnen und Entwickler, sich an dem sinnvollen Projekt zu beteiligen. Der Sourcecode ist in Java mit Mustache-Templates geschrieben. Auch das Entwickeln neuer Generatoren ist nicht schwierig.

Insgesamt gibt es viele weiße Flächen auf der Landkarte von OpenAPI, die noch zu befüllen sind. Nur als Beispiel: Im oben beschriebenen OpenAPI Generator gibt es einen Datenbank-Schema-Generator für MySQL, aber nicht für PostgreSQL. Es gibt einen Generator für Angular, aber nicht für React. Der Python FastAPI Generator ist noch Beta und unvollständig, Django fehlt völlig. Hier bieten sich schöne Möglichkeiten für Entwicklerinnen und Entwickler, sich das eigene Portfolio mit einem großen Opensource-Projekt zu bereichern. Es braucht circa drei Commits, um in der Liste der Mitentwickelnden zu erscheinen.

(who)