public class BasicDynaBean extends java.lang.Object implements DynaBean, java.io.Serializable
Minimal implementation of the DynaBean
interface. Can be
used as a convenience base class for more sophisticated implementations.
IMPLEMENTATION NOTE - Instances of this class that are accessed from multiple threads simultaneously need to be synchronized.
IMPLEMENTATION NOTE - Instances of this class can be
successfully serialized and deserialized ONLY if all
property values are Serializable
.
Modifier and Type | Field and Description |
---|---|
protected DynaClass |
dynaClass
The
DynaClass "base class" that this DynaBean
is associated with. |
private java.util.Map<java.lang.String,java.lang.Object> |
mapDecorator
Map decorator for this DynaBean
|
protected java.util.HashMap<java.lang.String,java.lang.Object> |
values
The set of property values for this DynaBean, keyed by property name.
|
Constructor and Description |
---|
BasicDynaBean(DynaClass dynaClass)
Construct a new
DynaBean associated with the specified
DynaClass instance. |
Modifier and Type | Method and Description |
---|---|
boolean |
contains(java.lang.String name,
java.lang.String key)
Does the specified mapped property contain a value for the specified
key value?
|
java.lang.Object |
get(java.lang.String name)
Return the value of a simple property with the specified name.
|
java.lang.Object |
get(java.lang.String name,
int index)
Return the value of an indexed property with the specified name.
|
java.lang.Object |
get(java.lang.String name,
java.lang.String key)
Return the value of a mapped property with the specified name,
or
null if there is no value for the specified key. |
DynaClass |
getDynaClass()
Return the
DynaClass instance that describes the set of
properties available for this DynaBean. |
protected DynaProperty |
getDynaProperty(java.lang.String name)
Return the property descriptor for the specified property name.
|
java.util.Map<java.lang.String,java.lang.Object> |
getMap()
Return a Map representation of this DynaBean.
|
protected boolean |
isAssignable(java.lang.Class<?> dest,
java.lang.Class<?> source)
Is an object of the source class assignable to the destination class?
|
void |
remove(java.lang.String name,
java.lang.String key)
Remove any existing value for the specified key on the
specified mapped property.
|
void |
set(java.lang.String name,
int index,
java.lang.Object value)
Set the value of an indexed property with the specified name.
|
void |
set(java.lang.String name,
java.lang.Object value)
Set the value of a simple property with the specified name.
|
void |
set(java.lang.String name,
java.lang.String key,
java.lang.Object value)
Set the value of a mapped property with the specified name.
|
protected DynaClass dynaClass
DynaClass
"base class" that this DynaBean
is associated with.protected java.util.HashMap<java.lang.String,java.lang.Object> values
private transient java.util.Map<java.lang.String,java.lang.Object> mapDecorator
public BasicDynaBean(DynaClass dynaClass)
DynaBean
associated with the specified
DynaClass
instance.dynaClass
- The DynaClass we are associated withpublic java.util.Map<java.lang.String,java.lang.Object> getMap()
fooProperty
:
${myDynaBean.map.fooProperty}
public boolean contains(java.lang.String name, java.lang.String key)
contains
in interface DynaBean
name
- Name of the property to checkkey
- Name of the key to checktrue
if the mapped property contains a value for
the specified key, otherwise false
java.lang.IllegalArgumentException
- if there is no property
of the specified namepublic java.lang.Object get(java.lang.String name)
public java.lang.Object get(java.lang.String name, int index)
get
in interface DynaBean
name
- Name of the property whose value is to be retrievedindex
- Index of the value to be retrievedjava.lang.IllegalArgumentException
- if there is no property
of the specified namejava.lang.IllegalArgumentException
- if the specified property
exists, but is not indexedjava.lang.IndexOutOfBoundsException
- if the specified index
is outside the range of the underlying propertyjava.lang.NullPointerException
- if no array or List has been
initialized for this propertypublic java.lang.Object get(java.lang.String name, java.lang.String key)
null
if there is no value for the specified key.get
in interface DynaBean
name
- Name of the property whose value is to be retrievedkey
- Key of the value to be retrievedjava.lang.IllegalArgumentException
- if there is no property
of the specified namejava.lang.IllegalArgumentException
- if the specified property
exists, but is not mappedpublic DynaClass getDynaClass()
DynaClass
instance that describes the set of
properties available for this DynaBean.getDynaClass
in interface DynaBean
public void remove(java.lang.String name, java.lang.String key)
public void set(java.lang.String name, java.lang.Object value)
set
in interface DynaBean
name
- Name of the property whose value is to be setvalue
- Value to which this property is to be setConversionException
- if the specified value cannot be
converted to the type required for this propertyjava.lang.IllegalArgumentException
- if there is no property
of the specified namejava.lang.NullPointerException
- if an attempt is made to set a
primitive property to nullpublic void set(java.lang.String name, int index, java.lang.Object value)
set
in interface DynaBean
name
- Name of the property whose value is to be setindex
- Index of the property to be setvalue
- Value to which this property is to be setConversionException
- if the specified value cannot be
converted to the type required for this propertyjava.lang.IllegalArgumentException
- if there is no property
of the specified namejava.lang.IllegalArgumentException
- if the specified property
exists, but is not indexedjava.lang.IndexOutOfBoundsException
- if the specified index
is outside the range of the underlying propertypublic void set(java.lang.String name, java.lang.String key, java.lang.Object value)
set
in interface DynaBean
name
- Name of the property whose value is to be setkey
- Key of the property to be setvalue
- Value to which this property is to be setConversionException
- if the specified value cannot be
converted to the type required for this propertyjava.lang.IllegalArgumentException
- if there is no property
of the specified namejava.lang.IllegalArgumentException
- if the specified property
exists, but is not mappedprotected DynaProperty getDynaProperty(java.lang.String name)
name
- Name of the property for which to retrieve the descriptorjava.lang.IllegalArgumentException
- if this is not a valid property
name for our DynaClassprotected boolean isAssignable(java.lang.Class<?> dest, java.lang.Class<?> source)
dest
- Destination classsource
- Source classtrue
if the source class is assignable to the
destination class, otherwise false
Copyright (c) 2000-2008 - Apache Software Foundation