JavaWeb——swagger使用

一、引言

 

 在日常工作中，开发人员经常会遇到写接口文档的工作，一般都是word文档，带来书写麻烦、维护麻烦的问题，比如改了源代码忘了更新文档、解释不明确带来歧义、无法在线尝试等等。swagger就是为了解决这些问题而产生的。

 swagger可以独立程序以外书写，也可以嵌入在程序里面，程序写完文档就有了，本文使用的是后者。之前写过vs中写过C#的wagger，本篇是java版的。

 

 

 

二、使用教程

 

1、添加jar依赖

 我使用的是maven，如果没使用请手动下载撒==

 

		<!-- swagger -->
		<dependency>
			<groupId>com.mangofactory</groupId>
			<artifactId>swagger-springmvc</artifactId>
			<version>1.0.2</version>
		</dependency>

 

 

2、新建SwaggerConfig类

 

/**
 * 项目名称：apidoc
 *
 * @description:
 * @author Wind-spg
 * @create_time：2015年2月10日 上午10:27:51
 * @