com.wordnik.swagger.annotations

Annotation Type ApiParam

@Target(value={PARAMETER,METHOD,FIELD})
@Retention(value=RUNTIME)
@Inherited
public @interface ApiParam

Adds additional meta-data for operation parameters.

This annotation can be used only in combination of JAX-RS 1.x/2.x annotations.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	access Allows for filtering a parameter from the API documentation.
String	allowableValues Limits the acceptable values for this parameter.
boolean	allowMultiple Specifies whether the parameter can accept multiple comma-separated values.
String	defaultValue Describes the default value for the parameter.
String	name The parameter name.
boolean	required Specifies if the parameter is required or not.
String	value A brief description of the parameter.

Element Detail

name

public abstract String name

The parameter name.

The name of the parameter will be derived from the field/method/parameter name, however you can override it.

Body parameters will always be named "body". Path parameters will always be named as the path section they represent.

Default:

""

value

public abstract String value

A brief description of the parameter.

Default:

""

defaultValue

public abstract String defaultValue

Describes the default value for the parameter.

If the parameter is annotated with JAX-RS's @DefaultValue, that value would be used, but can be overridden by setting this property.

Default:

""

allowableValues

public abstract String allowableValues

Limits the acceptable values for this parameter.

If the original parameter type is an enum, the values of the enum would be translated to the allowableValues. Those can be overridden by setting this property.

There are three ways to describe the allowable values:

1. To set a list of values, provide a comma-separated list surrounded by square brackets. For example: [first, second, third].
2. To set a range of values, start the value with "range", and surrounding by square brackets include the minimum and maximum values. For example: range[1, 5].
3. To set a minimum/maximum value, use the same format for range but use "infinity" or "-infinity" as the second value. For example, range[1, infinity] means the minimum allowable value of this parameter is 1.

Default:

""

required

public abstract boolean required

Specifies if the parameter is required or not.

Path parameters will always be set as required, whether you set this property or not.

Default:

false

access

public abstract String access

Allows for filtering a parameter from the API documentation.

See Also:

com.wordnik.swagger.core.filter.SwaggerSpecFilter

Default:

""

allowMultiple

public abstract boolean allowMultiple

Specifies whether the parameter can accept multiple comma-separated values.

Default:

false