swagger 注释方式编写接口文档

介绍

　　swagger用注解的方式生成接口文档，减少工作量

使用

　　首先需要引入jar

　　

 <!-- 引入swagger2 -->
        <dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>1.8.0.RELEASE</version>
        </dependency>

　　

　　然后在controller中引入注解

　　

@Api(value ="/login" ,tags={"登录注册"})

　　在方法上也引入注解

　　

　　　　

 @ApiOperation("用户登录")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "tel",value="手机号",required = true),
            @ApiImplicitParam(name = "password",value="密码",required = true)
    })

效果

　　通过访问本地　http://localhost:9004/swagger-ui.html#/ 既可以看到生成的接口文档的效果