io.vertx.codegen.annotations

Annotation Type DataObject

@Retention(value=RUNTIME)
 @Target(value=TYPE)
public @interface DataObject

Declares a data object, such object must provide at least:

• a constructor with JsonObject

When the data object is processed, a model of properties from the setter methods or adder methods. Single valued and multi valued properties are supported.

A setter is just like a JavaBean setter, however the method return type shall be fluent and return the current object. A List setter type declares a multi valued property, otherwise it declares a single valued property.

An adder is a method prefixed by add, its purpose is to declare a List of properties. An adder declares a multi valued property, mapped to the JsonArray type. An adder and a multi valued setter of the same property name are naturally compatible and is encouraged.

Properties types can be:

• any basic type
• a valid data object type
• JsonObject
• JsonArray
• an enum type
• a List of above

A data object can be an interface or an abstract class to accomodate the api design. Data object can extend other data objects.

Sometimes data object can have a toJson() method that takes no arguments and returns a JsonObject representing the data object as a JsonObject.

Author:

Tim Fox

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	base64Type Deprecated. instead declare a JsonGen.base64Type()
boolean	generateConverter Deprecated. instead declare a JsonGen annotation
boolean	inheritConverter Deprecated. instead declare a JsonGen.inheritConverter()
Class<? extends Case>	jsonPropertyNameFormatter Deprecated. instead declare a JsonGen.jsonPropertyNameFormatter()
boolean	publicConverter Deprecated. instead declare a JsonGen.publicConverter()

Element Detail

generateConverter

@Deprecated
public abstract boolean generateConverter

Deprecated. instead declare a JsonGen annotation

Returns:

true if converter should be generated for the data object

Default:

false

inheritConverter

@Deprecated
public abstract boolean inheritConverter

Deprecated. instead declare a JsonGen.inheritConverter()

Returns:

true if the converter should handle the state of the ancestors.

Default:

false

publicConverter

@Deprecated
public abstract boolean publicConverter

Deprecated. instead declare a JsonGen.publicConverter()

Returns:

whether the generated converter should be public or package private

Default:

true

jsonPropertyNameFormatter

@Deprecated
public abstract Class<? extends Case> jsonPropertyNameFormatter

Deprecated. instead declare a JsonGen.jsonPropertyNameFormatter()

Returns:

the case class specifying how the data object converter properties will be translated to JSON element names.

Default:

io.vertx.codegen.format.LowerCamelCase.class

base64Type

@Deprecated
public abstract String base64Type

Deprecated. instead declare a JsonGen.base64Type()

Returns the expected Base64 (RFC 4648) type to be used. When omitted, his is vert.x default alphabet, usually (RFC 4648 Table 2) also known as base64url, unless the system property vertx.json.base64 is legacy. In this case the alphabet will be basic as it was during the vert.x 3.x releases. Allowed values are:

• "base64url" - Base64 URL and Filename Safe as defined in (RFC 4648 Table 2)
• "basic" - Base64 Basic as defined in (RFC 4648 Table 1)

Returns:

if generated converters are enabled, buffers should default to the configured type.

Default:

""