SpringBoot集成Swagger

Swagger简介

    世界上最流行的API工具Swagger是世界上最大的框架API开发工具的API规范(OAS),使整个API开发生命周期,从设计、文档、测试和部署。Swagger官网:https://swagger.io/。
1、什么是Swagger?
  Swagger是一组围绕OpenAPI规范构建的开源工具,可帮助设计、构建、记录和使用REST API。
2、什么是OpenAPI?
  OpenAPI规范就是REST API的API描述格式。OpenAPI文件允许描述整个API包括:
/user 每个端点(GET/users,POST/users)上的可用端点和操作
操作参数每个输入和输出
认证方式
联系信息、许可证、及其它信息

API规范可以用YAML或JSON编写,这种格式对于人们和机器都是易于学习和可读的。

Swagger集成SpringBoot

可以去springboot官网:http://projects.spring.io/spring-boot/下载一个简易的spring boot的项目也可以自己创建。
1、pom.xml文件添加Maven依赖。
<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.7.0</version>
</dependency>
<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.7.0</version>
</dependency>
2、添加SwaggerConfig配置
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
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
public class SwaggerConfig {

	 @Bean
	    public Docket createRestApi() {
		 return new Docket(DocumentationType.SWAGGER_2)
			     .pathMapping("/")
			     .select()
                 .apis(RequestHandlerSelectors.basePackage("暴露接口地址的包路径"))
			     .paths(PathSelectors.any())
                 .build()
                 .apiInfo(testApiInfo());
	    }

	 private ApiInfo testApiInfo() {
	        return new ApiInfoBuilder()
	            .title("springboot利用swagger构建api文档")//标题
	            .description("详细描述")//详细描述
	            .version("1.0")//版本
	            .termsOfServiceUrl("NO terms of service")
	            .contact("nice")//作者
	            .license("The Apache License, Version 2.0")
	            .licenseUrl("http://www.apache.org/licenses/LICENSE-2.0.html")
	            .build();
	    }
}
3、需要暴露的接口代码作为参考
import com.rqbao.comm.model.User;
import com.rqbao.service.UserService;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;


@RestController
@RequestMapping(value = "/user")
public class SwaggerController {

    @Autowired
    UserService userService;

    @ApiOperation(value = "查询用户",notes = "根据UserId对象查询")
    @ApiImplicitParam(name = "userId",value = "id", required = true,dataType = "Long",paramType = "path")
    @RequestMapping(method = RequestMethod.GET , value = "{id}")
    public User findById(@PathVariable("id") Long id){
        return userService.findById(id);
    }

    @ApiOperation(value = "添加用户",notes = "根据User对象添加")
    @ApiImplicitParam(name = "user", value = "user", required = true, dataType = "User")
    @RequestMapping(method = RequestMethod.GET , value = "add")
    public User insert(){
        User user = new User();
        user.setUserName("nice");
        user.setJob("java");
        return userService.insert(user);
    }

}
4、访问http://localhost:9001/swagger-ui.html,效果如下。swagger会将接口以WEB形式展现给我们并且提供测试及API文档。(9001可根据自己端口更改)


  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 5
    评论
要在Spring Boot集成Swagger,你需要做以下几个步骤: 1. 首先,确保你使用的是Spring Boot 2.5.x及之前的版本。因为从Spring Boot 2.6.x开始,Swagger已经从Spring Boot中移除了。 2. 在你的Spring Boot应用中添加Swagger的依赖。在pom.xml文件中,添加以下依赖: ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> ``` 3. 在启动类上添加`@EnableSwagger2`注解。这个注解会启用Swagger的功能。你可以将这个注解直接添加到你的Spring Boot启动类上,或者创建一个单独的配置类,在配置类中添加这个注解。 4. 配置Swagger的相关属性。你可以在`application.properties`或`application.yml`文件中添加以下配置: ```yaml springfox.documentation.swagger.v2.path=/swagger springfox.documentation.swagger.ui.enabled=true ``` 这些配置将指定Swagger的路径和UI的启用状态。 5. 编写API文档。在你的控制器类中,使用Swagger的注解来描述你的API接口。例如,你可以使用`@Api`注解来给你的控制器类添加一个API的描述,<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* *2* *3* [SpringBoot教程(十六) | SpringBoot集成swagger(全网最全)](https://blog.csdn.net/lsqingfeng/article/details/123678701)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v92^chatsearchT3_1"}}] [.reference_item style="max-width: 100%"] [ .reference_list ]

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值