spring restdocs

    最近不知道怎么了，我和一个同事疯狂了迷恋上了spring的一些工具型框架，不为人所知但是功能也很强大，今天就记录一下对springrestdocs的研究记录。

   rest-docs翻译一下restful风格的文档，这么说跟swagger很像喽？后来我才发现太小看swagger了，作为一个功能性框架springrestdocs的原理没什么亮点，它的功能是生成接口文档，那么springrestdocs跟swagger有什么区别呢？

1. swagger是在线文档（传说也可以生成离线的），springrestdocs是离线文档
2. swagger是自动生成的，springrestdocs是手动生成的
3. swagger是不可以修改文档格式样式的，springrestdocs是可以修改的（毕竟离线后生成的是个html）
4. swagger是对业务代码中有入侵性的，springrestdocs是不需要修改业务代码的

所以，总体来讲没有swagger好用，但有其优点，对代码没有入侵性，代码里不需要做任何修改这一点甩apidoc几条街，可以自定义文档的格式有好有坏吧，个人还是偏好swagger一点