0

I am new to RAML. I want to auto generate my REST api documentation via RAML from my Spring MVC controllers. I know SpringFox has annotation based support for Swagger to auto generate api docs for spring mvc; Do we have a similar framework to auto generate RAML based api docs from spring controllers?

Thanks, Lina

Improve this question

3 Answers 3

Reset to default
1

I think RAML does note have a framework like SpringFox that generates a swagger from a Spring Controller.

There is a framework that generates a HTTP from a RAML like a swagger-ui.

This the framework: https://github.com/cybertk/grunt-raml2html

Improve this answer
Sign up to request clarification or add additional context in comments.

1 Comment

Seems like you are right. A good graphical comparison is done here mikestowe.com/2014/12/api-spec-comparison-tool.php .... As you can see the framework and build support is weaker in RAML that the Swagger .
1

Another alternative that was open sourced recently is https://github.com/ePages-de/restdocs-raml. It is an extension to Spring REST Docs and generates RAML out of tests for Spring MVC controller.

Improve this answer

Comments

0

You can try the github project springmvc-raml-plugin for maven https://github.com/phoenixnap/springmvc-raml-plugin

The plugin supports Raml 0.8, haven't found anything for RAML 1.0

Improve this answer

1 Comment

This plugin now supports RAML 1.0 and does not support 0.8 anymore.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.