java.lang.Object
- io.github.mmm.bean.AbstractBean

All Implemented Interfaces:

ReadableBean, WritableBean, MarshallableObject, Marshaller<Object>, Marshalling<Object>, MarshallingObject, UnmarshallableObject, Unmarshaller<Object>, Validatable

Direct Known Subclasses:

AbstractVirtualBean, Bean
```
public abstract class AbstractBean
extends Object
implements WritableBean
```
Abstract base implementation of WritableBean.

See Also:

Bean

Field Summary
- Fields inherited from interface io.github.mmm.bean.ReadableBean
  PROPERTY_TYPE

Constructor Summary

Constructors
Constructor Description

AbstractBean()
The constructor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected DefaultPropertyBuilders`	`add()`
`protected <V,P extends WritableProperty<V>> P`	`add(P property)`	Internal method for `addProperty(WritableProperty)`, without verification.
`<P extends WritableProperty<?>> P`	`addProperty(P property)`	Adds the given `WritableProperty` to this bean.
`WritableBean`	`copy(boolean isReadOnly)`
`protected AbstractBean`	`create()`	Creates a new instance of this `Bean` implementation.
`<V> WritableProperty<V>`	`createProperty(String name, Class<V> valueClass, Type valueType)`	Creates and `adds` a `WritableProperty` with the given `value class` dynamically.
`protected PropertyBuilders`	`createPropertyBuilders()`	Internal method that may be overridden to replace the `PropertyBuilders` implementation.
`Iterable<? extends WritableProperty<?>>`	`getProperties()`
`WritableProperty<?>`	`getProperty(String name)`
`int`	`getPropertyCount()`
`boolean`	`isDynamic()`
`boolean`	`isReadOnly()`
`protected boolean`	`isThreadSafe()`
`AbstractBean`	`newInstance()`
`protected void`	`onPropertyAdded(WritableProperty<?> property)`
`protected void`	`requireDynamic()`	Verifies that this `Bean` is `dynamic` (extensible).
`protected void`	`requireWritable()`	Verifies that this `Bean` is writable (not `read-only`).
`String`	`toString()`
`void`	`toString(StringBuilder sb)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.github.mmm.marshall.MarshallableObject
writeObject

Methods inherited from interface io.github.mmm.bean.ReadableBean
copy, get, getPropertyNameForAlias, getType, isEqualTo, isPolymorphic, isPrototype, validate, write

Methods inherited from interface io.github.mmm.marshall.UnmarshallableObject
readObject

Methods inherited from interface io.github.mmm.bean.WritableBean
createProperty, getOrCreateProperty, getOrCreateProperty, getRequiredProperty, read, set, set, set

- Constructor Detail
  - AbstractBean
```
public AbstractBean()
```
    The constructor.
- Method Detail
  - isThreadSafe
```
protected boolean isThreadSafe()
```
    Returns:
    
    true if the Bean shall be thread-safe (use concurrent collections, etc.), false otherwise.
  - isDynamic
```
public boolean isDynamic()
```
    Specified by:
    
    isDynamic in interface ReadableBean
    
    Returns:
    
    true if this Bean is dynamic meaning that is not strictly typed but allows to dynamically add properties, false otherwise.
    
    See Also:
    
    VirtualBean
  - requireWritable
```
protected void requireWritable()
```
    Verifies that this Bean is writable (not read-only).
  - requireDynamic
```
protected void requireDynamic()
```
    Verifies that this Bean is dynamic (extensible).
  - newInstance
```
public AbstractBean newInstance()
```
    Specified by:
    
    newInstance in interface ReadableBean
    
    Returns:
    
    a new instance of this WritableBean.
  - copy
```
public WritableBean copy(boolean isReadOnly)
```
    Specified by:
    
    copy in interface ReadableBean
    
    Parameters:
    
    isReadOnly - - true if the copy shall be read-only.
    
    Returns:
    
    a copy of this WritableBean. If readOnly is true and this bean is already read-only, the same instance will be returned.
  - isReadOnly
```
public final boolean isReadOnly()
```
    Specified by:
    
    isReadOnly in interface ReadableBean
    
    Returns:
    
    true if this Bean is read-only (immutable), false otherwise.
  - create
```
protected AbstractBean create()
```
    Creates a new instance of this Bean implementation. The default implementation uses reflection. To improve performance please override this method. Please note, that if you do so, you also need to override this method again for all sub-classes of the hierarchy.
    
    Returns:
    
    the new Bean instance. Has to be of the same type as the current class.
  - getProperties
```
public Iterable<? extends WritableProperty<?>> getProperties()
```
    Specified by:
    
    getProperties in interface ReadableBean
    
    Specified by:
    
    getProperties in interface WritableBean
    
    Returns:
    
    an Iterable of all properties of this bean.
  - getProperty
```
public WritableProperty<?> getProperty(String name)
```
    Specified by:
    
    getProperty in interface ReadableBean
    
    Specified by:
    
    getProperty in interface WritableBean
    
    Parameters:
    
    name - the name of the requested property or a potential alias of the property.
    
    Returns:
    
    the requested WritableProperty or null if no such property exists.
    
    See Also:
    
    WritableBean.addProperty(WritableProperty), WritableBean.getOrCreateProperty(String, Class)
  - getPropertyCount
```
public int getPropertyCount()
```
    Specified by:
    
    getPropertyCount in interface ReadableBean
    
    Returns:
    
    the number of properties of this ReadableBean.
  - createProperty
```
public <V> WritableProperty<V> createProperty(String name,
                                              Class<V> valueClass,
                                              Type valueType)
```
    Description copied from interface: WritableBean
    
    Creates and adds a WritableProperty with the given value class dynamically.
    
    Specified by:
    
    createProperty in interface WritableBean
    
    Type Parameters:
    
    V - the generic type of the value class.
    
    Parameters:
    
    name - the property name.
    
    valueClass - the value class.
    
    valueType - the Type reflecting the property value.
    
    Returns:
    
    the newly created and added property.
  - addProperty
```
public <P extends WritableProperty<?>> P addProperty(P property)
```
    Description copied from interface: WritableBean
    
    Adds the given WritableProperty to this bean.
    
    Specified by:
    
    addProperty in interface WritableBean
    
    Type Parameters:
    
    P - type of the WritableProperty to add.
    
    Parameters:
    
    property - the WritableProperty to add.
    
    Returns:
    
    the given property.
  - add
```
protected <V,P extends WritableProperty<V>> P add(P property)
```
    Internal method for addProperty(WritableProperty), without verification. Will be called from constructor of bean class implementations to register properties.
    
    Type Parameters:
    
    V - type of the property value.
    
    P - type of the WritableProperty to add.
    
    Parameters:
    
    property - the WritableProperty to add.
    
    Returns:
    
    the given property.
  - add
```
protected DefaultPropertyBuilders add()
```
    Returns:
    
    the builder factory to build properties to be added to this bean.
  - createPropertyBuilders
```
protected PropertyBuilders createPropertyBuilders()
```
    Internal method that may be overridden to replace the PropertyBuilders implementation.
    
    Returns:
    
    the PropertyBuilders instance.
  - onPropertyAdded
```
protected void onPropertyAdded(WritableProperty<?> property)
```
    Parameters:
    
    property - the WritableProperty that has been added.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toString
```
public void toString(StringBuilder sb)
```
    Parameters:
    
    sb - the StringBuilder where to append the details (the properties) of this Bean for toString()-Representation.

Class AbstractBean

Field Summary

Fields inherited from interface io.github.mmm.bean.ReadableBean

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface io.github.mmm.marshall.MarshallableObject

Methods inherited from interface io.github.mmm.bean.ReadableBean

Methods inherited from interface io.github.mmm.marshall.UnmarshallableObject

Methods inherited from interface io.github.mmm.bean.WritableBean

Constructor Detail

AbstractBean

Method Detail

isThreadSafe

isDynamic

requireWritable

requireDynamic

newInstance

copy

isReadOnly

create

getProperties

getProperty

getPropertyCount

createProperty

addProperty

add

add

createPropertyBuilders

onPropertyAdded

toString

toString