Как сгенерировать документацию и клиентский код для RAML?

Я новичок, работаю над проектом, в котором они хотят использовать RAML для определения API. Я получил p0lugin RAML-JAX-RS для Eclipse. Благодаря этому я смог создать файл RAML из существующей службы REST. Я также смог сгенерировать классы интерфейса REST. Там есть флажок с опцией «Создать клиентский прокси-код». Но он вообще не генерирует никакого клиентского кода. Генерируются только интерфейсы сервера REST.

Я попытался найти способ создания клиентских классов и файлов документации. (Я предполагаю, что он может делать это в виде HTML-файлов или около того.) Я видел некоторый код плагина maven для генерации клиентского кода, но я не понимаю, как это работает. Кто-нибудь знает, как их генерировать? Либо из Eclipse, либо из командной строки, либо с Maven. Желательно через Maven.


person Mark Boon    schedule 15.08.2016    source источник


Ответы (1)


Я обнаружил, что лучший вариант на данный момент

https://github.com/mulesoft-labs/raml-java-client-generator

Я бы предпочел генератор, совместимый с RAML 1.0, но, похоже, его не существует.

Мы обнаруживаем, что в RAML 1.0 необходимы некоторые изменения, чтобы он правильно анализировался, например, удаление типов перед примерами и т. д.

person Karl Henselin    schedule 04.01.2018