java.lang.Object | ||
↳ | org.apache.commons.beanutils.BasicDynaClass | |
↳ | org.apache.commons.beanutils.LazyDynaClass |
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.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
restricted | Controls whether changes to this DynaClass's properties are allowed. | ||||||||||
returnNull | Controls whether the |
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.beanutils.BasicDynaClass
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construct a new LazyDynaClass with default parameters.
| |||||||||||
Construct a new LazyDynaClass with the specified name.
| |||||||||||
Construct a new LazyDynaClass with the specified name and DynaBean class.
| |||||||||||
Construct a new LazyDynaClass with the specified name and properties.
| |||||||||||
Construct a new LazyDynaClass with the specified name, DynaBean class and properties.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Add a new dynamic property with the specified data type, readability, and writeability. | |||||||||||
Add a new dynamic property with the specified data type, but with
no restrictions on readability or writeability.
| |||||||||||
Add a new dynamic property with no restrictions on data type,
readability, or writeability.
| |||||||||||
Return a property descriptor for the specified property. | |||||||||||
Indicate whether a property actually exists. | |||||||||||
Is this DynaClass currently restricted. | |||||||||||
Should this DynaClass return a
null from
the getDynaProperty(name) method if the property
doesn't exist. | |||||||||||
Remove the specified dynamic property, and any associated data type,
readability, and writeability, from this dynamic class.
| |||||||||||
Set whether this DynaClass is currently restricted. | |||||||||||
Set whether this DynaClass should return a
null from
the getDynaProperty(name) method if the property
doesn't exist. |
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Add a new dynamic property.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.beanutils.BasicDynaClass
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
org.apache.commons.beanutils.DynaClass
| |||||||||||
From interface
org.apache.commons.beanutils.MutableDynaClass
|
Controls whether changes to this DynaClass's properties are allowed.
Controls whether the getDynaProperty()
method returns
null if a property doesn't exist - or creates a new one.
Default is false
.
Construct a new LazyDynaClass with default parameters.
Construct a new LazyDynaClass with the specified name.
name | Name of this DynaBean class |
---|
Construct a new LazyDynaClass with the specified name and DynaBean class.
name | Name of this DynaBean class |
---|---|
dynaBeanClass | The implementation class for new instances |
Construct a new LazyDynaClass with the specified name and properties.
name | Name of this DynaBean class |
---|---|
properties | Property descriptors for the supported properties |
Construct a new LazyDynaClass with the specified name, DynaBean class and properties.
name | Name of this DynaBean class |
---|---|
dynaBeanClass | The implementation class for new intances |
properties | Property descriptors for the supported properties |
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.
name | Name of the new dynamic property |
---|---|
type | Data type of the new dynamic property (null for no restrictions) |
readable | Set to true if this property value
should be readable |
writeable | Set to true if this property value
should be writeable |
UnsupportedOperationException | anytime this method is called |
---|
Add a new dynamic property with the specified data type, but with no restrictions on readability or writeability.
name | Name of the new dynamic property |
---|---|
type | Data type of the new dynamic property (null for no restrictions) |
IllegalArgumentException | if name is null |
---|---|
IllegalStateException | if this DynaClass is currently restricted, so no new properties can be added |
Add a new dynamic property with no restrictions on data type, readability, or writeability.
name | Name of the new dynamic property |
---|
IllegalArgumentException | if name is null |
---|---|
IllegalStateException | if this DynaClass is currently restricted, so no new properties can be added |
Return a property descriptor for the specified property.
If the property is not found and the returnNull
indicator is
true
, this method always returns null
.
If the property is not found and the returnNull
indicator is
false
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 that
BeanUtils
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, returning null
from
this method would defeat their purpose.
name | Name of the dynamic property for which a descriptor is requested |
---|
IllegalArgumentException | if no property name is specified |
---|
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 the
returnNull
indicator).
name | The name of the property to check |
---|
true if there is a property of the
specified name, otherwise false
IllegalArgumentException | if no property name is specified |
---|
Is this DynaClass currently restricted.
If restricted, no changes to the existing registration of property names, data types, readability, or writeability are allowed.
true
if this MutableDynaClass
cannot be changed
otherwise false
Should this DynaClass return a null
from
the getDynaProperty(name)
method if the property
doesn't exist.
true if a null
DynaProperty
should be returned if the property doesn't exist, otherwise
false
if a new DynaProperty
should be created.
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.
name | Name of the dynamic property to remove |
---|
IllegalArgumentException | if name is null |
---|---|
IllegalStateException | if this DynaClass is currently restricted, so no properties can be removed |
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.
restricted | true if this MutableDynaClass cannot
be changed otherwise false
|
---|
Set whether this DynaClass should return a null
from
the getDynaProperty(name)
method if the property
doesn't exist.
returnNull | true |
---|
Add a new dynamic property.
property | Property the new dynamic property to add. |
---|
IllegalArgumentException | if name is null |
---|---|
IllegalStateException | if this DynaClass is currently restricted, so no new properties can be added |