springdoc ui swagger 3更改API描述

Question

我对String和Swagger 3很陌生。如何更改默认的API描述，即Swagger springdoc-openapi-ui swagger 3中的OpenAPI definition

​

​

还有版本，开发者信息..。

我在用

implementation "org.springframework.boot:spring-boot-starter-web:2.6.6"
implementation "org.springdoc:springdoc-openapi-ui:1.6.8"

在搜索中，我只看到它们显示默认的Swagger

Answer 1

只需使用以下注释：

应用程序启动程序类中的(配置类)：

@OpenAPIDefinition(info=@Info(title="Name of project"))

控制器中的

import io.swagger.v3.oas.annotations.*

Calss级别：

@OpenAPIDefinition()

或

@Tag(name = "", description = "")

方法级别:

 @Operation()

 @ApiResponses()

Answer 2

对于我使用的标准版本：

@Bean
    public OpenAPI customOpenAPI() {
        final String locUrl = "http://localhost:8080";
        final String devUrl = "https://.de";
        final String testUrl = "https://.de";
        final String preUrl = "https://.de";
        final String proUrl = "https://.grp";

        return new OpenAPI().addServersItem(new Server().url(locUrl)).addServersItem(new Server().url(
                devUrl)).addServersItem(new Server().url(testUrl)).addServersItem(new Server().url(preUrl))
            .addServersItem(new Server().url(proUrl)).info(
                new Info().version("v1").title("XApp application API")
                    .description("(NOTE: If having Swagger UI issues w/ Chrome then use Firefox instead.)")
            .contact(new Contact().name("Edi")));
    }

为了根据分组进行改变，我做到了：

@Profile("!dev")
    @Bean
    public GroupedOpenApi groupedPublicOpenApi10() {
        return GroupedOpenApi
            .builder()
            .addOpenApiCustomiser(openApi -> openApi.getInfo().setVersion("v1"))
            .group("API-v1")
            .pathsToMatch("/api/**")
            .displayName("API v1")
            .build();
    }