net.ozwolf.raml.annotations

Annotation Type RamlBody

@Retention(value=RUNTIME)
public @interface RamlBody

RAML Body Annotation

This annotation is used to help describe a RAML body type for both requests and responses.

See Also:

RamlResponse, RamlRequests

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
String	contentType The content type of the body(eg.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	example The example for this body type.
String	schema The schema for this body type.
Class<?>	type A reference to the object type used for this body.

Element Detail

contentType

public abstract String contentType

The content type of the body(eg. “application/json”)

Returns:

the body content type

type

public abstract Class<?> type

A reference to the object type used for this body.

If this is supplied, the generator will attempt to use an appropriate generator to generate a schema document for the object.

If the object has a @RamlExample annotated static method that returns a concrete example of the type, the generator will use that to create an example payload.

If not value is provided here, the generator will resort to the contents of the schema() and example() properties to derive body schema and example

Returns:

the body object type

Default:

net.ozwolf.raml.annotations.RamlBody.NotDefinedReturnType.class

schema

public abstract String schema

The schema for this body type. The value in here can make reference to a classpath resource or a direct text entry.

This will be used to supply a schema in the RAML specification if the type() property has not be defined.

Returns:

the body schema

Default:

""

example

public abstract String example

The example for this body type. The value in here can make reference to a classpath resource or a direct text entry.

This will be used to supply a schema in the RAML specification if the type() property has not been defined.

Returns:

the body example

Default:

""