是否有一些摇摇晃晃的注释会限制摇摇晃晃文档中特定属性的其余部分,但不是全部?

时间:2020-10-16 00:11:36

标签: java rest annotations swagger swagger-2.0

我正在使用Java swagger批注“ io.swagger.v3.oas.annotations”。 我有以下模型。

public class ObjectInfo {


    @Schema(description = "object name")
    @JsonProperty
    private String name;

    @Schema(description = "object description")
    @JsonProperty
    private String description;

    @Schema(description = "object abbreviation")
    @JsonProperty
    private String abbreviation;

   @Schema(description = "object type")
    @JsonProperty
    private String type;

}

但是,此模型类在许多端点中用作许多restAPI的响应类。

类似于GET / users / id,GET / connections / id,GET / projects / id,GET / roles / id等。所有这些API入口点都是一个单独的类。类似于GET /用户是UserResource.java,GET /项目是ProjectResource.java,等等。

我的主要目的是仅隐藏abbreviatetype,以便对角色和项目API进行全面记录。同样,仅需要为用户API隐藏description,而无需隐藏其他端点。

我可以使用@Schema(description = "object type", hidden = true)之类的“隐藏”。 但是,它将不仅适用于特定的其余端点,还适用于所有REST端点响应模型。我也尝试使用not annotation。但是没有成功。

我在模式下没有发现任何限制特定端点(但不是全部)的醒目注解。 可能会有创建自定义注释的选项。但是我不确定,是否可能有这样的要求? 有什么办法可以实现这个目标。

0 个答案:

没有答案