SpringMVC整合Swagger

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 运行后效果,要注意访问地址

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值