springmvc轻松整合springfox

springfox介绍

Springfox的前身是swagger-springmvc,是一个开源的API doc框架，能够将咱们的Controller的方法以文档的形式展示。

1.引入springfox依赖jar包

<!-- springfox -->
			<dependency>
				<groupId>io.springfox</groupId>
				<artifactId>springfox-swagger2</artifactId>
				<version>2.0.2</version>
			</dependency>
			<dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-annotations</artifactId>
				<version>2.4.4</version>
			</dependency>
			<dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-core</artifactId>
				<version>2.4.4</version>
			</dependency>
            <dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-databind</artifactId>
				<version>${jackson.version}</version>
			</dependency>

2.自定义swagger 

SwaggerConfig.java

/**
 * The type Swagger config.
 */

import org.springframework.web.servlet.config.annotation.EnableWebMvc;

import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * The type Swagger config.
 *
 * @author weiyonghua
 */
@EnableWebMvc
@EnableSwagger2
public class SwaggerConfig {

}

3.spring容器加载 applicationContext.xml

<!--springfox swagger-->
    <bean class="com.chuyan.common.swagger.SwaggerConfig"/>

4.https://github.com/swagger-api/swagger-ui.git 下载swagger-ui中的dist文件夹引入项目。

5.修改swagger-ui项目中的index.html文件url地址 

6.项目访问地址 http://localhost:8080/${project.name}/swagger/index.html

7.swagger注解使用参考https://my.oschina.net/zzuqiang/blog/793606