springboot集成swagger的pom依赖
2021/8/7 23:06:52
本文主要是介绍springboot集成swagger的pom依赖,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
pom依赖加入以下内容
//版本一致做个属性 <properties> <swagger.version>2.6.1</swagger.version> </properties> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>${swagger.version}</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>${swagger.version}</version> </dependency>
Swagger配置类SwaggerConfig内容
import io.swagger.annotations.Api; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; 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 @ComponentScan(basePackages = "com.example.demo.controller")//配置扫描的基础包 public class SwaggerConfig { @Bean //作为bean纳入spring容器 public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .paths(PathSelectors.any()) .apis(RequestHandlerSelectors.withClassAnnotation(Api.class)) .build(); } private ApiInfo apiInfo(){ return new ApiInfoBuilder() .title("API接口文档") .description("API接口文档,及相关接口的说明") .version("1.0.0") .build(); } }
在每个方法上添加@ApiOperation,如下
@RestController @RequestMapping("/api/v1/user") @EnableSwagger2 @Api public class UserController { @Autowired private UserService userService; BindingResult bindingResult; @ApiOperation(value = "登陆") @PostMapping("/login") public Result login(@RequestBody @Valid User user, BindingResult errors){ List<FieldError> fieldErrors = errors.getFieldErrors(); if(!fieldErrors.isEmpty()){ System.out.println(fieldErrors.get(0).getDefaultMessage()); return Result.resultError(fieldErrors.get(0).getDefaultMessage(),100); } return userService.login(user.getUsername(), user.getPassword()); } }
运行Application,访问地址http://localhost:port/swagger-ui.html即可
界面风格如下
可更换版本号界面风格会发生变化,前段时间看到一个比较好用的版风格如下
如需要用此则只需更换springfox-swagger-ui为
<dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>swagger-bootstrap-ui</artifactId> <version>1.9.6</version> </dependency>
注意这个的版本访问地址使用http://localhost:port/doc.html#
这篇关于springboot集成swagger的pom依赖的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-06-26结对编程到底难不难?答案在这里
- 2024-06-19《2023版Java工程师》课程升级公告
- 2024-06-15matplotlib作图不显示3D图,怎么办?
- 2024-06-1503-Loki 日志监控
- 2024-06-1504-让LLM理解知识 -Prompt
- 2024-06-05做软件测试需要懂代码吗?
- 2024-06-0514-ShardingSphere的分布式主键实现
- 2024-06-03为什么以及如何要进行架构设计权衡?
- 2024-05-31全网首发第二弹!软考2024年5月《软件设计师》真题+解析+答案!(11-20题)
- 2024-05-31全网首发!软考2024年5月《软件设计师》真题+解析+答案!(21-30题)