org.joda.beans.impl.light

Class LightMetaBean<T extends Bean>

java.lang.Object

org.joda.beans.impl.light.LightMetaBean<T>

Type Parameters:

T - the type of the bean

All Implemented Interfaces:

MetaBean, TypedMetaBean<T>

public final class LightMetaBean<T extends Bean>
extends Object
implements TypedMetaBean<T>

A meta-bean implementation that operates using method handles.

The properties are found using the PropertyDefinition annotation. There must be a constructor matching the property definitions (arguments of same order and types).

This uses method handles to avoid problems with reflection setAccessible() in Java SE 9. The old reflection approach is still present, but deprecated.

Method Summary

Modifier and Type	Method and Description
Class<T>	beanType() Get the type of the bean, represented as a Class.
BeanBuilder<T>	builder() Creates a bean builder that can be used to create an instance of this bean.
boolean	equals(Object obj)
int	hashCode()
boolean	isBuildable() Checks whether this bean is buildable or not.
Map<String,MetaProperty<?>>	metaPropertyMap() Gets the map of meta-properties, keyed by property name.
static <B extends Bean> LightMetaBean<B>	of(Class<B> beanClass) Deprecated. Use method handles version of this method
static <B extends Bean> LightMetaBean<B>	of(Class<B> beanType, MethodHandles.Lookup lookup, Object... defaultValues) Obtains an instance of the meta-bean.
String	toString() Returns a string that summarises the meta-bean.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.joda.beans.MetaBean

annotation, annotations, beanName, metaProperty, metaPropertyCount, metaPropertyExists, metaPropertyIterable, of, register

Method Detail

of

@Deprecated
public static <B extends Bean> LightMetaBean<B> of(Class<B> beanClass)

Deprecated. Use method handles version of this method

Obtains an instance of the meta-bean.

The properties will be determined using reflection to find the PropertyDefinition annotation.

Type Parameters:

B - the type of the bean

Parameters:

beanClass - the bean class, not null

Returns:

the meta-bean, not null

of

public static <B extends Bean> LightMetaBean<B> of(Class<B> beanType,
                                                   MethodHandles.Lookup lookup,
                                                   Object... defaultValues)

Obtains an instance of the meta-bean.

The properties will be determined using reflection to find the PropertyDefinition annotation.

The default values must be provided if they cannot be determined automatically. Default values for primitives are determined automatically, but empty lists and maps are not.

Type Parameters:

B - the type of the bean

Parameters:

beanType - the bean type, not null

lookup - the method handle lookup, not null

defaultValues - the default values, one for each property, not null

Returns:

the meta-bean, not null

isBuildable

public boolean isBuildable()

Description copied from interface: MetaBean

Checks whether this bean is buildable or not.

A buildable bean can be constructed using MetaBean.builder(). If this method returns true then builder() must return a valid builder. If this method returns false then builder() must throw UnsupportedOperationException.

Specified by:

isBuildable in interface MetaBean

Returns:

true if this bean is buildable

builder

public BeanBuilder<T> builder()

Description copied from interface: MetaBean

Creates a bean builder that can be used to create an instance of this bean.

The builder is used in two main ways. The first is to allow immutable beans to be constructed. The second is to enable automated tools like serialization/deserialization.

The builder can be thought of as a Map of MetaProperty to value. Note that the implementation is not necessarily an actual map.

Specified by:

builder in interface MetaBean

Specified by:

builder in interface TypedMetaBean<T extends Bean>

Returns:

the bean builder, not null

beanType

public Class<T> beanType()

Description copied from interface: MetaBean

Get the type of the bean, represented as a Class.

A MetaBean can be thought of as the equivalent of Class but for beans. This method allows the actual Class instance of the bean to be obtained.

Specified by:

beanType in interface MetaBean

Specified by:

beanType in interface TypedMetaBean<T extends Bean>

Returns:

the type of the bean, not null

metaPropertyMap

public Map<String,MetaProperty<?>> metaPropertyMap()

Description copied from interface: MetaBean

Gets the map of meta-properties, keyed by property name.

Where possible, use MetaBean.metaPropertyIterable() instead as it typically has better performance.

Specified by:

metaPropertyMap in interface MetaBean

Returns:

the unmodifiable map of meta property objects, not null

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Returns a string that summarises the meta-bean.

Overrides:

toString in class Object

Returns:

a summary string, not null