Package org.apache.juneau.annotation

Annotation Interface SubItems

@Documented
@Retention(RUNTIME)
public @interface SubItems

Swagger items annotation.

This class is essentially identical to Items except it's used for defining items of items.

Since annotations cannot be nested, we're forced to create a separate annotation for it.
If you want to nest items further, you have to define them free-form using items() as free-form JSON.

See Also:

• juneau-bean-swagger-v2
• Swagger Items Object

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
String	$ref	$ref field of the Swagger Items Object.
String	cf	Synonym for collectionFormat().
String	collectionFormat	collectionFormat field of the Swagger Items Object.
String[]	default_	default field of the Swagger Items Object.
String[]	description	Optional description for the exposed API.
String[]	df	Synonym for default_().
String[]	e	Synonym for enum_().
boolean	emax	Synonym for exclusiveMaximum().
boolean	emin	Synonym for exclusiveMinimum().
String[]	enum_	enum field of the Swagger Items Object.
boolean	exclusiveMaximum	exclusiveMaximum field of the Swagger Items Object.
boolean	exclusiveMinimum	exclusiveMinimum field of the Swagger Items Object.
String	f	Synonym for format().
String	format	format field of the Swagger Items Object.
String[]	items	items field of the Swagger Items Object.
String	max	Synonym for maximum().
long	maxi	Synonym for maxItems().
String	maximum	maximum field of the Swagger Items Object.
long	maxItems	maxItems field of the Swagger Items Object.
long	maxl	Synonym for maxLength().
long	maxLength	maxLength field of the Swagger Items Object.
String	min	Synonym for minimum().
long	mini	Synonym for minItems().
String	minimum	minimum field of the Swagger Items Object.
long	minItems	minItems field of the Swagger Items Object.
long	minl	Synonym for minLength().
long	minLength	minLength field of the Swagger Items Object.
String	mo	Synonym for multipleOf().
String	multipleOf	multipleOf field of the Swagger Items Object.
String	p	Synonym for pattern().
String	pattern	pattern field of the Swagger Items Object.
String	t	Synonym for type().
String	type	type field of the Swagger Items Object.
boolean	ui	Synonym for uniqueItems().
boolean	uniqueItems	uniqueItems field of the Swagger Items Object.

Element Details

default_

String[] default_

default field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

{}

enum_

String[] enum_

enum field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

{}

$ref

String $ref

$ref field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

cf

String cf

Synonym for collectionFormat().

Returns:

The annotation value.

Default:

""

collectionFormat

String collectionFormat

collectionFormat field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

description

String[] description

Optional description for the exposed API.

Returns:

The annotation value.

Since:

9.2.0

Default:

{}

df

String[] df

Synonym for default_().

Returns:

The annotation value.

Default:

{}

e

String[] e

Synonym for enum_().

Returns:

The annotation value.

Default:

{}

emax

boolean emax

Synonym for exclusiveMaximum().

Returns:

The annotation value.

Default:

false

emin

boolean emin

Synonym for exclusiveMinimum().

Returns:

The annotation value.

Default:

false

exclusiveMaximum

boolean exclusiveMaximum

exclusiveMaximum field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

false

exclusiveMinimum

boolean exclusiveMinimum

exclusiveMinimum field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

false

f

String f

Synonym for format().

Returns:

The annotation value.

Default:

""

format

String format

format field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

items

String[] items

items field of the Swagger Items Object.

Describes the type of items in the array.

This is a juneau-bean-swagger-v2 object.
It must be declared free-form because it's not possible to nest annotations in Java.

Returns:

The annotation value.

Default:

{}

max

String max

Synonym for maximum().

Returns:

The annotation value.

Default:

""

maxi

long maxi

Synonym for maxItems().

Returns:

The annotation value.

Default:

-1L

maximum

String maximum

maximum field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

maxItems

long maxItems

maxItems field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

-1L

maxl

long maxl

Synonym for maxLength().

Returns:

The annotation value.

Default:

-1L

maxLength

long maxLength

maxLength field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

-1L

min

String min

Synonym for minimum().

Returns:

The annotation value.

Default:

""

mini

long mini

Synonym for minItems().

Returns:

The annotation value.

Default:

-1L

minimum

String minimum

minimum field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

minItems

long minItems

minItems field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

-1L

minl

long minl

Synonym for minLength().

Returns:

The annotation value.

Default:

-1L

minLength

long minLength

minLength field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

-1L

mo

String mo

Synonym for multipleOf().

Returns:

The annotation value.

Default:

""

multipleOf

String multipleOf

multipleOf field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

p

String p

Synonym for pattern().

Returns:

The annotation value.

Default:

""

pattern

String pattern

pattern field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

t

String t

Synonym for type().

Returns:

The annotation value.

Default:

""

type

String type

type field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

""

ui

boolean ui

Synonym for uniqueItems().

Returns:

The annotation value.

Default:

false

uniqueItems

boolean uniqueItems

uniqueItems field of the Swagger Items Object.

Notes:

• The format is a plain-text string.

Returns:

The annotation value.

Default:

false