org.joda.beans

Annotation Type PropertyDefinition

@Retention(value=RUNTIME)
@Target(value=FIELD)
public @interface PropertyDefinition

Annotation defining a property for code generation.

This annotation must be used on all private instance variables that should be treated as properties.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	get The style of the method used to query the property.
String	set The style of the method used to mutate the property.
String	validate The validator to use.

Element Detail

get

public abstract String get

The style of the method used to query the property.

The style is a string describing the getter, typically used for code generation. By default this is 'smart' which will use the source code knowledge to determine what to generate. This will be a method of the form isXxx() for boolean and getXxx() for all other types.

Supported style stings are:

• '' - do not generate any form of getter
• 'smart' - process intelligently - 'is' for boolean and 'get' for other types
• 'is' - generates isXxx()
• 'get' - generates getXxx()
• 'manual' - a method named getXxx() must be manually provided at package scope or greater

Default:

"smart"

set

public abstract String set

The style of the method used to mutate the property.

The style is a string describing the mutator, typically used for code generation. By default this is 'smart' which will use the source code knowledge to determine what to generate. This will be a method of the form setXxx() for all types unless the field is final. If the field is a final Collection or Map of a known type then a set method is generated using addAll or puAll

Standard style stings are:

• '' - do not generate any form of setter
• 'smart' - process intelligently - uses 'set' unless final, when it will use 'setClearAddAll' for common list types or 'setClearPutAll' for common map types and FlexiBean
• 'set' - generates setXxx()
• 'setClearAddAll' - generates setXxx() using field.clear() and field.addAll(newData)
• 'setClearPutAll' - generates setXxx() using field.clear() and field.putAll(newData)
• 'manual' - a method named setXxx() must be manually provided at package scope or greater

Default:

"smart"

validate

public abstract String validate

The validator to use.

The property value may be validated by specifying this attribute. By default no validation is performed. The code generator places the validation into the set method and ensures that new objects are validated correctly.

Custom validations, are written by writing a static method and referring to it. For example, public void checkMyValue(Integer val, String propertyName) ... The method generally has a void return, throwing an exception if validation fails. There must be two arguments, the value and the property name. The value may be the property type or a superclass (like Object). The property name should be a String.

Standard validation stings are:

• '' - do not generate any form of validation
• 'notNull' - suitable for checking that the value is non-null, calls JodaBeanUtils.notNull() which throws an IllegalArgumentException
• 'notEmpty' - suitable for checking that a string is non-null and non-empty, calls JodaBeanUtils.notEmpty() which throws an IllegalArgumentException
• '{className}.{staticMethodName}' - a custom validation method, described above

Default:

""