我们在SpringBoot中想集成Swagger3.0,一般不选择原生的Maven坐标,而是选择 springdoc-openapi-ui的Maven坐标,它可以很好的和Spring或SpringBoot项目集成;这个坐标也被Spring社区广泛支持和认可,并被认为是集成Swagger UI和OpenAPI规范的一个优秀选择。下面将直接介绍使用。 1:引入Maven依赖 <!--导入SpringBoot集成Open API...
-- lookup parent from repository --></parent><modelVersion>4.0.0</modelVersion><artifactId>test-swagger3-with-springboot3</artifactId><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><arti...
http://localhost:port/swagger-ui/index.html 和2版本地址不同:http://localhost:port/swagger-ui.html spring boot 2.6.x 版本配置 如果是spring boot 2.6.x集成了swagger,会出现异常信息: Failed to start bean 'documentationPluginsBootstrapper'; org.springframework.context.ApplicationContextException:Failed ...
在项目 config 包下创建 SwaggerConfig.java 类,并编写代码如下: package XXX.XXX.XXX.config;import io.swagger.v3.oas.models.OpenAPI;import io.swagger.v3.oas.models.info.Info;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;@Configurationpublic ...
首先我们创建一个 Spring Boot 项目,引入 Swagger3 依赖,如下: <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> 以前在 Swagger2 的时代,这个依赖我们需要引入两个,现在就只需要这一个即可。
因此,集成工作变得更加的简便了,必要工作只有两个,添加swagger3的starter依赖包,在springboot主程序类添加@EnableOpenApi开关注解。 2. 导入依赖 <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> ...
如果需要携带token进行访问接口,swagger配置类加如下代码: 参考:点击跳转 /** * 默认的安全上引用 */privateList<SecurityReference>defaultAuth(){AuthorizationScopeauthorizationScope=newAuthorizationScope("global","accessEverything");AuthorizationScope[]authorizationScopes=newAuthorizationScope[1];authorizationScopes[...
2. 编写Swagger配置类 如果pom中还引用了spring-boot-starter-web,一定要在配置类上增加@EnableWebMvc注解。 @EnableOpenApi是Swagger3.0的注解,默认已经开启,可选。 文档类型选择OAS_30,表示用swagger3.0。 通过enable参数配置来控制swagger的开关,在生产环境中,swagger功能不需要开启。
3. 4. 5. 配置 application.yaml spring: # mvc这部分解决swagger3在新版本Springboot中无法展示的问题 mvc: pathmatch: matching-strategy: ANT_PATH_MATCHER 1. 2. 3. 4. 5. java实现配置类 @Configuration @EnableOpenApi public class SwaggerConfig { ...