@Target(value={})
@Retention(value=RUNTIME)
@Inherited
public @interface ExampleObject
Modifier and Type | Optional Element and Description |
---|---|
java.lang.String |
description
Long description for the example.
|
java.lang.String |
externalValue
A URL to point to an external document to be used as an example.
|
java.lang.String |
name
A unique name to identify this particular example in a map.
|
java.lang.String |
ref
Reference value to an Example object.
|
java.lang.String |
summary
A brief summary of the purpose or context of the example
|
java.lang.String |
value
A string representation of the example.
|
public abstract java.lang.String name
The name is REQUIRED when the example is defined within
Components
. The name will be used as the key to add this
example to the 'examples' map for reuse.
public abstract java.lang.String summary
public abstract java.lang.String description
public abstract java.lang.String value
This is mutually exclusive with the externalValue property, and ignored if the externalValue property is specified.
If the media type associated with the example allows parsing into an object, it may be converted from a string.public abstract java.lang.String externalValue
This is mutually exclusive with the value property.
public abstract java.lang.String ref
This property provides a reference to an object defined elsewhere. This property and all other properties are mutually exclusive. If other properties are defined in addition to the ref property then the result is undefined.