java - 如何添加 链接以使元素在 Java 中可单击以供 Swagger 使用

Question

我想让 Capo Mastro 在 Java 中成为可点击的链接，以便在 @ApiOperation 注释中 Swagger ，但我得不到任何结果。

@ApiOperation(
        value = "This method updates an existing capo mastro."+" <a href>Capo mastro<a>"+ can be managed only by system",
        response = SaveCapoMastroResponse.class
    )

如果有人能提供帮助，我将不胜感激!谢谢!

Answer 1

假设您在 Swagger UI 中表示可点击 – 您可以使用 Markdown 语法在操作描述(notes 属性)中添加链接。虽然操作摘要(value)不支持 Markdown。

@ApiOperation(
        value = "This method updates an existing capo mastro.",
        notes = "[Capo mastro](http://example.com) can be managed only by system.",
        response = SaveCapoMastroResponse.class
    )

HTML <a href="">标记也应该有效，因为 Markdown 支持 HTML。确保转义内部 "引号。

@ApiOperation(
        value = "This method updates an existing capo mastro.",
        notes = "<a href=\"http://example.com\" target=\"_blank\">Capo mastro</a> can be managed only by system.",
        response = SaveCapoMastroResponse.class
    )