1:Swagger介绍
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是
使客户端和文件系统
作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允
许API来始终保持同步。Swagger 让部署
管理和使用功能强大的API从未如此简单。
2:SpringMvc整合Swagger
2.1加载Swagger相关jar
<dependency>
<groupId>com.mangofactory</groupId>
<artifactId>swagger-springmvc</artifactId>
</dependency>
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
</dependency>
2.2前台配置
我们需要下载swagger的相关页面文件,https://github.com/swagger-api/swagger-ui 下载后把dist内容拷贝到项目中
2.3:springmvc文件中配置
2.4:配置上图中的com.mutualaid.swagger 中的swagger2文件
package com.mutualaid.swagger;
import com.mangofactory.swagger.configuration.SpringSwaggerConfig;
import com.mangofactory.swagger.models.dto.ApiInfo;
import com.mangofactory.swagger.plugin.EnableSwagger;
import com.mangofactory.swagger.plugin.SwaggerSpringMvcPlugin;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
/**
*
* <p>Title:</p>
* <p>Description:</p>
* @author Mr.Cheng
* @date 2017年2月18日 下午1:32:52
*/
@Configuration
@EnableSwagger
@EnableWebMvc
public class SwaggerConfig {
private SpringSwaggerConfig springSwaggerConfig;
/**
* Required to autowire SpringSwaggerConfig
*/
@Autowired
public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig)
{
this.springSwaggerConfig = springSwaggerConfig;
}
/**
* Every SwaggerSpringMvcPlugin bean is picked up by the swagger-mvc
* framework - allowing for multiple swagger groups i.e. same code base
* multiple swagger resource listings.
*/
@Bean
public SwaggerSpringMvcPlugin customImplementation()
{
return new SwaggerSpringMvcPlugin(this.springSwaggerConfig)
.apiInfo(apiInfo())
.includePatterns(".*");
}
private ApiInfo apiInfo()
{
ApiInfo apiInfo = new ApiInfo(
"Contexts",
"notes",
"开发者: Mr.Cheng",
"1234567@qq.com",
"MIT License",
"/LICENSE");
return apiInfo;
}
}
2.5修改index.html中的url文件路径
2.6:在相应的类上加上注解
@ApiOperation(value="添加活动页面",notes="跳转到活动页面",httpMethod="GET")
其他注解,请查阅swagger手册
2.7 运行后效果,要注意访问地址