java rest api文档生成_Java Restful API 文档生成工具 smart-doc | 软件推介

原标题：Java Restful API 文档生成工具 smart-doc | 软件推介

授权协议：Apache-2.0

开发语言：Java

软件作者：上官胡闹

背景

在当今各种盛行的前后端分离、restful service开发过程中，接口文档是必不 可少的。对于前后端分离的开发中，后端开发需要将接口写好后需要告诉前端工程师接口的请求参数、响应示例等重要信息，而对于对外暴露的restful接口服务，我们提供接口也是需要具备相同的接口文档的。

但是对于后端工程师来讲，写接口文档将变成一个很大的工作量，虽然现在有类似apidoc、swagger这样的主流接口文档生成工具，但是如果实际用过，会发现这些工具不能满足实际需求，这里拿swagger为例，这个工具最大的优点能是提供在线的api文档，但是它天生就有很强的代码侵入性，要得到一个基本满足需求的api接口文档，必须在代码中使用swagger自定义的注解。这其实给开发人员增加学习成本和工作量，并且就算你使用大量的注解，有许多接口还是无法满足。因此不得不去做一次接口文档工具重新启航探索，smart-doc应允而生，用代码去探路，消除繁杂的注解，发现天下没有难写接口文档。

简介

smart-doc是一个java restful api文档生成工具，smart-doc颠覆了传统类似swagger这种大量采用注解侵入来生成文档的实现方法。smart-doc完全基于接口源码分析来生成接口文档，完全做到零注解侵入，你只需要按照java标准注释的写就能得到一个标准的markdown接口文档。如果你已经厌倦了swagger等文档工具的注解和强侵入污染，那请