we're working on a multi-module project based on Spring MVC and REST. We need to document somehow all REST URLs which are accessible in the application.
I wonder, is there a tool (preferably a maven plugin), that could automatically document all controllers? For example, produce a (sorted) list of all mapped paths (taken from @RequestMapping annotations etc.) and interlink them with the JavaDoc documentation of method and classes.
If there is no such tool, would anybody be interested in something like that, if we decide to write it? I suppose it wouldn't be so hard to write, since this information is somehow already produced by the DispatcherServlet (at least what I've seen in a log output).