? LazyDynaClass
- ????????:
Serializable
,DynaClass
,MutableDynaClass
DynaClass which implements the MutableDynaClass
interface.
A MutableDynaClass
is a specialized extension to DynaClass
that allows properties to be added or removed dynamically.
This implementation has one slightly unusual default behaviour - calling
the getDynaProperty(name)
method for a property which doesn't
exist returns a DynaProperty
rather than null
. The
reason for this is that BeanUtils
calls this method to check if
a property exists before trying to set the value. This would defeat the object
of the LazyDynaBean
which automatically adds missing properties
when any of its set()
methods are called. For this reason the
isDynaProperty(name)
method has been added to this implementation
in order to determine if a property actually exists. If the more normal
behaviour of returning null
is required, then this can be achieved
by calling the setReturnNull(true)
.
The add(name, type, readable, writable)
method is not implemented
and always throws an UnsupportedOperationException
. I believe
this attributes need to be added to the DynaProperty
class
in order to control read/write facilities.
- ??:
- $Id$
- ????:
-
????
????????????protected boolean
Controls whether changes to this DynaClass's properties are allowed.protected boolean
Controls whether thegetDynaProperty()
method returns null if a property doesn't exist - or creates a new one.??????? org.apache.commons.beanutils.BasicDynaClass
constructor, constructorTypes, constructorValues, dynaBeanClass, name, properties, propertiesMap
-
?????
????????Construct a new LazyDynaClass with default parameters.LazyDynaClass
(String name) Construct a new LazyDynaClass with the specified name.LazyDynaClass
(String name, Class<?> dynaBeanClass) Construct a new LazyDynaClass with the specified name and DynaBean class.LazyDynaClass
(String name, Class<?> dynaBeanClass, DynaProperty[] properties) Construct a new LazyDynaClass with the specified name, DynaBean class and properties.LazyDynaClass
(String name, DynaProperty[] properties) Construct a new LazyDynaClass with the specified name and properties. -
????
??????????void
Add a new dynamic property with no restrictions on data type, readability, or writeability.void
Add a new dynamic property with the specified data type, but with no restrictions on readability or writeability.void
Add a new dynamic property with the specified data type, readability, and writeability.protected void
add
(DynaProperty property) Add a new dynamic property.getDynaProperty
(String name) Return a property descriptor for the specified property.boolean
isDynaProperty
(String name) Indicate whether a property actually exists.boolean
Is this DynaClass currently restricted.boolean
Should this DynaClass return anull
from thegetDynaProperty(name)
method if the property doesn't exist.void
Remove the specified dynamic property, and any associated data type, readability, and writeability, from this dynamic class.void
setRestricted
(boolean restricted) Set whether this DynaClass is currently restricted.void
setReturnNull
(boolean returnNull) Set whether this DynaClass should return anull
from thegetDynaProperty(name)
method if the property doesn't exist.??????? org.apache.commons.beanutils.BasicDynaClass
getDynaBeanClass, getDynaProperties, getName, newInstance, setDynaBeanClass, setProperties
??????? java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
???????? org.apache.commons.beanutils.DynaClass
getDynaProperties, getName, newInstance
-
??????
-
restricted
Controls whether changes to this DynaClass's properties are allowed. -
returnNull
Controls whether the
getDynaProperty()
method returns null if a property doesn't exist - or creates a new one.Default is
false
.
-
-
???????
-
LazyDynaClass
public LazyDynaClass()Construct a new LazyDynaClass with default parameters. -
LazyDynaClass
Construct a new LazyDynaClass with the specified name.- ??:
name
- Name of this DynaBean class
-
LazyDynaClass
Construct a new LazyDynaClass with the specified name and DynaBean class.- ??:
name
- Name of this DynaBean classdynaBeanClass
- The implementation class for new instances
-
LazyDynaClass
Construct a new LazyDynaClass with the specified name and properties.- ??:
name
- Name of this DynaBean classproperties
- Property descriptors for the supported properties
-
LazyDynaClass
Construct a new LazyDynaClass with the specified name, DynaBean class and properties.- ??:
name
- Name of this DynaBean classdynaBeanClass
- The implementation class for new instancesproperties
- Property descriptors for the supported properties
-
-
??????
-
isRestricted
Is this DynaClass currently restricted.
If restricted, no changes to the existing registration of property names, data types, readability, or writeability are allowed.
- ???:
isRestricted
????MutableDynaClass
- ??:
true
if thisMutableDynaClass
cannot be changed otherwisefalse
-
setRestricted
Set whether this DynaClass is currently restricted.
If restricted, no changes to the existing registration of property names, data types, readability, or writeability are allowed.
- ???:
setRestricted
????MutableDynaClass
- ??:
restricted
-true
if thisMutableDynaClass
cannot be changed otherwisefalse
-
isReturnNull
Should this DynaClass return anull
from thegetDynaProperty(name)
method if the property doesn't exist.- ??:
true
if anull
DynaProperty
should be returned if the property doesn't exist, otherwisefalse
if a newDynaProperty
should be created.
-
setReturnNull
Set whether this DynaClass should return anull
from thegetDynaProperty(name)
method if the property doesn't exist.- ??:
returnNull
-true
if anull
DynaProperty
should be returned if the property doesn't exist, otherwisefalse
if a newDynaProperty
should be created.
-
add
Add a new dynamic property with no restrictions on data type, readability, or writeability.- ???:
add
????MutableDynaClass
- ??:
name
- Name of the new dynamic property- ??:
IllegalArgumentException
- if name is nullIllegalStateException
- if this DynaClass is currently restricted, so no new properties can be added
-
add
Add a new dynamic property with the specified data type, but with no restrictions on readability or writeability.- ???:
add
????MutableDynaClass
- ??:
name
- Name of the new dynamic propertytype
- Data type of the new dynamic property (null for no restrictions)- ??:
IllegalArgumentException
- if name is nullIllegalStateException
- if this DynaClass is currently restricted, so no new properties can be added
-
add
Add a new dynamic property with the specified data type, readability, and writeability.
N.B.Support for readable/writeable properties has not been implemented and this method always throws a
UnsupportedOperationException
.I'm not sure the intention of the original authors for this method, but it seems to me that readable/writable should be attributes of the
DynaProperty
class (which they are not) and is the reason this method has not been implemented.- ???:
add
????MutableDynaClass
- ??:
name
- Name of the new dynamic propertytype
- Data type of the new dynamic property (null for no restrictions)readable
- Set totrue
if this property value should be readablewriteable
- Set totrue
if this property value should be writeable- ??:
UnsupportedOperationException
- anytime this method is called
-
add
Add a new dynamic property.- ??:
property
- Property the new dynamic property to add.- ??:
IllegalArgumentException
- if name is nullIllegalStateException
- if this DynaClass is currently restricted, so no new properties can be added
-
remove
Remove the specified dynamic property, and any associated data type, readability, and writeability, from this dynamic class. NOTE - This does NOT cause any corresponding property values to be removed from DynaBean instances associated with this DynaClass.- ???:
remove
????MutableDynaClass
- ??:
name
- Name of the dynamic property to remove- ??:
IllegalArgumentException
- if name is nullIllegalStateException
- if this DynaClass is currently restricted, so no properties can be removed
-
getDynaProperty
Return a property descriptor for the specified property.
If the property is not found and the
returnNull
indicator istrue
, this method always returnsnull
.If the property is not found and the
returnNull
indicator isfalse
a new property descriptor is created and returned (although its not actually added to the DynaClass's properties). This is the default beahviour.The reason for not returning a
null
property descriptor is thatBeanUtils
uses this method to check if a property exists before trying to set it - since these Lazy implementations automatically add any new properties when they are set, returningnull
from this method would defeat their purpose.- ???:
getDynaProperty
????DynaClass
- ??:
getDynaProperty
???BasicDynaClass
- ??:
name
- Name of the dynamic property for which a descriptor is requested- ??:
- The dyna property for the specified name
- ??:
IllegalArgumentException
- if no property name is specified
-
isDynaProperty
Indicate whether a property actually exists.
N.B. Using
getDynaProperty(name) == null
doesn't work in this implementation because that method might return a DynaProperty if it doesn't exist (depending on thereturnNull
indicator).- ??:
name
- The name of the property to check- ??:
true
if there is a property of the specified name, otherwisefalse
- ??:
IllegalArgumentException
- if no property name is specified
-