Enumeration of data model properties

[gbisaga]

I have a case where I have an enumeration that can return different String values. The @ApiModelProperty's allowableValues is close, but I need to have metadata associated with each possible value. Something like this:

@ApiModelProperty(...., allowableValues={
@ApiModelPropertyValue( value="registered", description="Yada yada...", discriminator="PUT" ),
@ApiModelPropertyValue( value="active", description="Yada yada...", discriminator="PUT,POST" ),
@ApiModelPropertyValue( value="closed", description="Yada yada...", discriminator="POST" )
});

It seems like any time there is a value, you'd need to at least describe the possible values.

[webron]

Swagger 2.0 allows for more extensive external documentation but it does not offer the ability to attach a description to fixed values in the allowableValues list.

I will close the issue for now, but will mark it as a feature proposal for the next spec version.

[webron]

Closing in favor of #348.