Spring+SpringMVC+Mybatis（开发必备技能）03、swagger(api接口开发必备,view视图略过)

Spring+SpringMVC+Mybatis（开发必备技能）

03、swagger(api接口开发必备,view视图略过)

目录

​​1、maven包·这里一定要用2.7.0，高版本对SSM兼容性忒差​​

​​2、swagger配置文件【com.item.swagger】​​

​​3、配置【webapp下【WEB-INF/swagger】】​​

​​4、spring-mvc.xml配置文件​​

​​5、控制器controller层​​

​

1、maven包·这里一定要用2.7.0，高版本对SSM兼容性忒差

    
    
      io.springfox
      springfox-swagger2
      2.7.0
    
    
    
      io.springfox
      springfox-swagger-ui
      2.7.0
    

2、swagger配置文件【com.item.swagger】

package com.item.swagger;

import io.swagger.annotations.ApiOperation;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
@EnableWebMvc
public class SwaggerConfig {

    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("红目香薰")
                .select()
                //扫描指定包中的swagger注解
                .apis(RequestHandlerSelectors.basePackage("com.item.controller"))
                //扫描所有有注解的api，用这种方式更灵活
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("swagger API文档")
                .description("测试接口文档")
                .version("1.0")
                .build();
    }
}

3、配置【webapp下【WEB-INF/swagger】】

​

解压位置：

4、spring-mvc.xml配置文件

5、控制器controller层

@Api("用户基本操作/接口|视图")
//返回api必须使用
@ResponseBody
@ApiOperation(value = "用作获取所有信息",notes = "查询所有",response = List.class)

测试控制器类:

package com.item.controller;

import com.item.model.Users;
import com.item.service.UsersService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

import java.util.List;
@Api(value = "用户接口")
@Controller
@CrossOrigin
@RequestMapping("/Users")
public class UsersController {
    @Autowired
    private UsersService usersService;

    @GetMapping("/GetInfoApi")
    @ResponseBody
    @ApiOperation(value = "查询所有",notes = "查询所有",httpMethod = "get")
    public Object GetInfoApi(){
        List<Users> list=usersService.GetInfo();
        System.out.println(list);
        return list;
    }
}

访问路径：【​​http://localhost:8080/swagger-ui.html​​】

显示效果：

打开之后点击【Try it out!】 

 可以看到访问效果。

这个是api的，要加上【@ResponseBody注解】