您现在的位置是：亿华云 > IT科技类资讯

Swagger中配置了@ApiModelProperty的allowableValues属性但不显示的问题

亿华云2025-10-02 14:21:35【IT科技类资讯】6人已围观

简介现在用Swagger来生成API文档的例子已经非常多了，今天碰到开发同事问了一个问题，帮着看了一下，主要还是配置方法的问题，所以记录一下。如果您也碰到了同样的问题，希望本文对您有用。问题描述@ApiM

现在用Swagger来生成API文档的配置例子已经非常多了，今天碰到开发同事问了一个问题，但不的问帮着看了一下，属性主要还是显示配置方法的问题，所以记录一下。配置如果您也碰到了同样的但不的问问题，希望本文对您有用。属性

问题描述

@ApiModelProperty注解是云服务器提供商显示用来给属性标注说明、默认值、配置是但不的问否可以为空等配置使用的，其中有一个属性allowableValues是属性本文要讲的重点，从属性命名上就能知道，显示该属性用来配置所标注字段允许的配置可选值。

但是云南idc服务商但不的问这个属性是一个String类型，我们要如何配置可选值呢?属性

我们可以通过源码的注释了解到一切：

public @interface ApiModelProperty { /** * Limits the acceptable values for this parameter. * <p> * There are three ways to describe the allowable values: * <ol> * <li>To set a list of values, provide a comma-separated list. * For example: { @code first, second, third}.</li> * <li>To set a range of values, start the value with "range", and surrounding by square * brackets include the minimum and maximum values, or round brackets for exclusive minimum and maximum values. * For example: { @code range[1, 5]}, { @code range(1, 5)}, { @code range[1, 5)}.</li> * <li>To set a minimum/maximum value, use the same format for range but use "infinity" * or "-infinity" as the second value. For example, { @code range[1, infinity]} means the * minimum allowable value of this parameter is 1.</li> * </ol> */ String allowableValues() default ""; ... }

我们只需要通过,分割来定义可选值，或者用range函数定义范围等方式就能正确显示了，比如：

public class Filter { @ApiModelProperty(allowableValues = "range[1,5]") Integer order @ApiModelProperty(allowableValues = "111, 222") String code; }

再运行下程序，就能看到如下内容，设置的允许值正常显示了。