Abstract

Der Artikel erläutert die REST-API Dokumentation mittels RAML. Einführend wird ein kurzer Überblick gegeben welche vergleichenbaren Tools auf dem Mark existieren dann werden die Feature von RAML an Spezifikations- und Kodebeispielen dargestellt.

Description

Das Konzept ist super allein die Umsetzung scheint für eine Java Maven Integration noch nicht voll geeignet zu sein. Für jUnit Tests scheint es bereits einsetzbar zu sein aber die Generierung der HTML Dokumentation basiert auf npm und ist damit erst ab Java8 lauffähig (falls nashorn mit dem verwendeten node-js kompatible ist).

Links and resources

Tags