org.raml.v2.api.model.v10.datamodel

Interface TypeDeclaration

All Superinterfaces:

Annotable

All Known Subinterfaces:

AnyTypeDeclaration, ArrayTypeDeclaration, BooleanTypeDeclaration, DateTimeOnlyTypeDeclaration, DateTimeTypeDeclaration, DateTypeDeclaration, ExternalTypeDeclaration, FileTypeDeclaration, FileTypeDeclaration, IntegerTypeDeclaration, JSONTypeDeclaration, NullTypeDeclaration, NumberTypeDeclaration, ObjectTypeDeclaration, StringTypeDeclaration, TimeOnlyTypeDeclaration, UnionTypeDeclaration, XMLTypeDeclaration

public interface TypeDeclaration
extends Annotable

Method Summary

Modifier and Type	Method and Description
List<AnnotationTarget>	allowedTargets() Restrictions on where annotations of this type can be applied.
String	defaultValue() Provides default value for a property
MarkdownString	description() A longer, human-friendly description of the type
AnnotableStringType	displayName() The displayName attribute specifies the type display name.
ExampleSpec	example() An example of this type instance represented as string or yaml map/sequence.
List<ExampleSpec>	examples() An example of this type instance represented as string.
List<TypeDeclaration>	facets() Gets the list of user-defined facets
String	name() Name of the parameter
List<TypeDeclaration>	parentTypes() The list of inherited types
Boolean	required() Sets if property is optional or not
String	toXmlSchema()
String	type() A base type which the current type extends, or more generally a type expression.
List<ValidationResult>	validate(String payload) Validates payload against the type/schema defined
XMLFacetInfo	xml()

Methods inherited from interface org.raml.v2.api.model.v10.common.Annotable

annotations

Method Detail

name

String name()

Name of the parameter

displayName

AnnotableStringType displayName()

The displayName attribute specifies the type display name. It is a friendly name used only for display or documentation purposes. If displayName is not specified, it defaults to the element's key (the name of the property itself).

type

String type()

A base type which the current type extends, or more generally a type expression.

parentTypes

List<TypeDeclaration> parentTypes()

The list of inherited types

defaultValue

String defaultValue()

Provides default value for a property

example

ExampleSpec example()

An example of this type instance represented as string or yaml map/sequence. This can be used, e.g., by documentation generators to generate sample values for an object of this type. Cannot be present if the examples property is present.

examples

List<ExampleSpec> examples()

An example of this type instance represented as string. This can be used, e.g., by documentation generators to generate sample values for an object of this type. Cannot be present if the example property is present.

required

Boolean required()

Sets if property is optional or not

description

MarkdownString description()

A longer, human-friendly description of the type

allowedTargets

List<AnnotationTarget> allowedTargets()

Restrictions on where annotations of this type can be applied. If this property is specified, annotations of this type may only be applied on a property corresponding to one of the target names specified as the value of this property.

validate

List<ValidationResult> validate(String payload)

Validates payload against the type/schema defined

Parameters:

payload - the payload to be validated

Returns:

the list of errors if any or an empty list if validation succeeded

facets

List<TypeDeclaration> facets()

Gets the list of user-defined facets

xml

XMLFacetInfo xml()

toXmlSchema

String toXmlSchema()