org.joda.beans
Annotation Type BeanDefinition

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

Annotation defining a bean for code generation.

This annotation must be used on classes that should be treated as beans.

style

public abstract String style

The style of bean generation.

By default, this follows 'smart' rules. Set to 'minimal' to generate a minimal amount of code. Set to 'full' to generate the full code. Set to 'light' to generate a light immutable bean using reflection internally.

Returns:

the style, defaulted to 'smart'

Default:

"smart"

constructorScope

public abstract String constructorScope

The scope of the generated constructor.

Only applicable to immutable beans. By default, this follows 'smart' rules, which generate a private constructor when needed by the builder. Set to 'private' to generate a private constructor. Set to 'package' to generate a package-scoped constructor. Set to 'protected' to generate a protected constructor. Set to 'public' to generate a public constructor. Set to 'public@ConstructorProperties' to generate a public constructor.

Returns:

the constructor scope, defaulted to 'smart'

Default:

"smart"

metaScope

public abstract String metaScope

The scope of the meta-bean class.

By default, this follows 'smart' rules, which generate a public meta-bean. Set to 'private' to generate a private meta-bean. Set to 'package' to generate a package-scoped meta-bean. Set to 'public' to generate a public meta-bean.

Returns:

the meta scope, defaulted to 'smart'

Default:

"smart"

builderScope

public abstract String builderScope

The scope of the builder class.

By default, this follows 'smart' rules, which generate a public builder for immutable beans and no builder for mutable beans. Set to 'private' to generate a private builder. Set to 'package' to generate a package-scoped builder. Set to 'public' to generate a public builder.

Returns:

the builder scope, defaulted to 'smart'

Default:

"smart"

factoryName

public abstract String factoryName

The name of the factory method.

By default, this is an empty string and no factory is generated. Set to 'of' to generate a factory method named 'of.

Returns:

the factory name, defaulted to ''

Default:

""

hierarchy

public abstract String hierarchy

Information about the bean hierarchy.

This is needed to add information that cannot be derived. Set to 'immutable' for a subclass of an immutable bean.

Returns:

the hierarchy, defaulted to ''

Default:

""

cloneStyle

public abstract String cloneStyle

The configuration for generating clone methods.

This flag controls generation of the clone method. The default is 'smart'.

The valid values are:

• 'omit' - omit the clone method
• 'smart' - process intelligently, generating it for mutable and not generating for immutable
• 'generate' - generate the clone method

Returns:

the clone style, defaulted to 'smart'

Default:

"smart"

cacheHashCode

public abstract boolean cacheHashCode

Whether to generate code to cache the hash code.

Setting this to true will cause the hash code to be cached using the racy single check idiom. The setting only applies to immutable beans.

Returns:

true if the hash code is to be cached

Default:

false