HttpDoc 是一个基于Java标准doc注释构建的代码零侵入的HTTPRESTfulAPI在线阅览文档及测试界面框架。
JSON-Editor: httpdoc-ui TextArea: httpdoc-ui-v1
功能特性
基础功能无需为配合HttpDoc框架而多写一句代码，甚至连doc注释都不必写，即可拥有项目的API文档和测试界面。
遵循 RFC2616HTTP/1.1 规范，适配主流后台WEB框架。
拓展多个JavaDoc注释标签，满足不同的文档阅览及在线测试需求。
一键生成SDK，支持多个平台，让前后台以及跨平台对接变得更简单。
WEB服务器无关，同时支持SprigBoot命令方式启动。
支持MaveGradle或JAR包依赖。
环境依赖JDK1.7+
集成步骤Mave引入依赖
<project> <!-- 设置 jitpack.io 仓库 --> <repositories> <repository> <id>jitpack.io</id> <url>https://www.jitpack.io</url> </repository> </repositories> <depedecies> <!-- 添加 HttpDoc 依赖 --> <depedecy> <groupId>com.github.core-lib.httpdoc</groupId> <artifactId>httpdoc-sprig-mvc</artifactId> <versio>v1.5.3</versio> </depedecy> <!-- 添加JDK的tools.jar依赖用于解析源码注释，采用这种方式部署到Tomcat时需要往Tomcat的lib目录增加该tools.jar --> <depedecy> <groupId>com.su</groupId> <artifactId>tools</artifactId> <versio>1.8</versio> <scope>system</scope> <systemPath>${ev.JAVA_HOME}/lib/tools.jar</systemPath> </depedecy> <!-- 当然还有很多种方式来依赖tools.jar，例如上传到自己的私服或从别的仓库中依赖进来 --> </depedecies></project>配置插件
<!-- 由于框架基于源码注释解析来实现，所以保留源码是基础，如果只想要在线测试而没有文档阅览的需求，可不必添加该插件。--><!-- 如果项目是多模块项目，需要被解析的源码类分散在多模块中，则其他模块也需要配置该插件，或在父项目的pom.xml中配置该插件。--><plugi> <groupId>org.apache.mave.plugis</groupId> <artifactId>mave-resources-plugi</artifactId> <versio>3.1.0</versio> <cofiguratio> <ecodig>UTF-8</ecodig> </cofiguratio> <executios> <executio> <id>copy-src</id> <phase>process-sources</phase> <goals> <goal>copy-resources</goal> </goals> <cofiguratio> <outputDirectory>${project.build.directory}/classes</outputDirectory> <resources> <resource> <directory>${basedir}/src/mai/java</directory> </resource> </resources> </cofiguratio> </executio> </executios></plugi>配置参数
SprigMVC
<web-app> <servlet> <servlet-ame>httpdoc</servlet-ame> <servlet-class>io.httpdoc.web.HttpdocServletSupport</servlet-class> <iit-param> <param-ame>httpdoc</param-ame> <param-value>项目名称</param-value> </iit-param> <iit-param> <param-ame>versio</param-ame> <param-value>项目版本</param-value> </iit-param> <iit-param> <param-ame>descriptio</param-ame> <param-value> <![CDATA[ 项目描述(可以内嵌HTML标签) ]]> </param-value> </iit-param> <iit-param> <param-ame>dateFormat</param-ame> <param-value>yyyy-MM-dd HH
评论