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

举报
红目香薰 发表于 2022/05/28 17:12:27 2022/05/28
【摘要】 ​ ​编辑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、控制器controlle...

 编辑

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层


配套源码(初学者可下载有用):https://download.csdn.net/download/feng8403000/85483308

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

    <!--swagger-->
    <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger2</artifactId>
      <version>2.7.0</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger-ui</artifactId>
      <version>2.7.0</version>
    </dependency>

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】】

下载地址:https://download.csdn.net/download/feng8403000/85483175

解压位置:

编辑

4、spring-mvc.xml配置文件

<!--添加swagger配置-->
<bean class="com.item.swagger.SwaggerConfig"/>
<mvc:resources mapping="/swagger/**" location="/WEB-INF/swagger/"/>

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注解】

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。