在 Swagger-ui 中更改名称和描述端点

Question

我正在使用 Spring Boot 和 Spring Data Rest 来实现我的 Rest API。为了记录它，我一直在使用 Swagger，以及这些 maven 依赖项：

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.6.1</version>
    </dependency>

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.6.1</version>
    </dependency>

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-data-rest</artifactId>
        <version>2.6.1</version>
    </dependency>

我想稍微更改和自定义我的 Swagger UI 页面。我想更改它出现在 html 页面中的名称和描述，具体而言，这些名称在屏幕截图中以红色突出显示，但没有任何效果。

我一直在尝试将 @Api 注释添加到我的实体和存储库类/接口中，但没有任何效果。

知道如何自定义它吗？

谢谢！

Answer 1

使用带有标签和描述的@Api注解。

@Api(description="Device APIs", tags = "Device")

请注意，description 已弃用，但它可以工作。