jdk 17、springboot3
依赖配置:就此一个依赖即可
<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.5.0</version></dependency>
Swagger2->Swagger3注解
-
@Api→@Tag -
@ApiIgnore→@Parameter(hidden = true)or@Operation(hidden = true)or@Hidden -
@ApiImplicitParam→@Parameter -
@ApiImplicitParams→@Parameters -
@ApiModel→@Schema -
@ApiModelProperty(hidden = true)→@Schema(accessMode = READ_ONLY) -
@ApiModelProperty→@Schema -
@ApiOperation(value = "foo", notes = "bar")→@Operation(summary = "foo", description = "bar") -
@ApiParam→@Parameter -
@ApiResponse(code = 404, message = "foo")→@ApiResponse(responseCode = "404", description = "foo")
添加Swagger配置类
import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class SwaggerConfig {@Beanpublic OpenAPI springShopOpenAPI() {return new OpenAPI().info(new Info().title("SpringShop API").description("Spring shop sample application").version("v0.0.1").license(new License().name("Apache 2.0").url("http://springdoc.org"))).externalDocs(new ExternalDocumentation().description("SpringShop Wiki Documentation").url("https://springshop.wiki.github.org/docs"));}}