Class Overview
An IndexedPropertyDescriptor describes a property that acts like an
array and has an indexed read and/or indexed write method to access
specific elements of the array.
An indexed property may also provide simple non-indexed read and write
methods. If these are present, they read and write arrays of the type
returned by the indexed read method.
Summary
Public Constructors |
|
IndexedPropertyDescriptor(String propertyName, Class<?> beanClass)
This constructor constructs an IndexedPropertyDescriptor for a property
that follows the standard Java conventions by having getFoo and setFoo
accessor methods, for both indexed access and array access.
|
|
IndexedPropertyDescriptor(String propertyName, Class<?> beanClass, String readMethodName, String writeMethodName, String indexedReadMethodName, String indexedWriteMethodName)
This constructor takes the name of a simple property, and method
names for reading and writing the property, both indexed
and non-indexed.
|
|
IndexedPropertyDescriptor(String propertyName, Method readMethod, Method writeMethod, Method indexedReadMethod, Method indexedWriteMethod)
This constructor takes the name of a simple property, and Method
objects for reading and writing the property.
|
[Expand]
Inherited Methods |
From class
java.beans.PropertyDescriptor
PropertyEditor
|
createPropertyEditor(Object bean)
Constructs an instance of a property editor using the current
property editor class.
|
boolean
|
equals(Object obj)
Compares this PropertyDescriptor against the specified object.
|
Class<?>
|
getPropertyEditorClass()
Gets any explicit PropertyEditor Class that has been registered
for this property.
|
synchronized
Class<?>
|
getPropertyType()
Gets the Class object for the property.
|
synchronized
Method
|
getReadMethod()
Gets the method that should be used to read the property value.
|
synchronized
Method
|
getWriteMethod()
Gets the method that should be used to write the property value.
|
int
|
hashCode()
Returns a hash code value for the object.
|
boolean
|
isBound()
Updates to "bound" properties will cause a "PropertyChange" event to
get fired when the property is changed.
|
boolean
|
isConstrained()
Attempted updates to "Constrained" properties will cause a "VetoableChange"
event to get fired when the property is changed.
|
void
|
setBound(boolean bound)
Updates to "bound" properties will cause a "PropertyChange" event to
get fired when the property is changed.
|
void
|
setConstrained(boolean constrained)
Attempted updates to "Constrained" properties will cause a "VetoableChange"
event to get fired when the property is changed.
|
void
|
setPropertyEditorClass(Class<?> propertyEditorClass)
Normally PropertyEditors will be found using the PropertyEditorManager.
|
synchronized
void
|
setReadMethod(Method readMethod)
Sets the method that should be used to read the property value.
|
synchronized
void
|
setWriteMethod(Method writeMethod)
Sets the method that should be used to write the property value.
|
|
From class
java.beans.FeatureDescriptor
Enumeration<String>
|
attributeNames()
Gets an enumeration of the locale-independent names of this
feature.
|
String
|
getDisplayName()
Gets the localized display name of this feature.
|
String
|
getName()
Gets the programmatic name of this feature.
|
String
|
getShortDescription()
Gets the short description of this feature.
|
Object
|
getValue(String attributeName)
Retrieve a named attribute with this feature.
|
boolean
|
isExpert()
The "expert" flag is used to distinguish between those features that are
intended for expert users from those that are intended for normal users.
|
boolean
|
isHidden()
The "hidden" flag is used to identify features that are intended only
for tool use, and which should not be exposed to humans.
|
boolean
|
isPreferred()
The "preferred" flag is used to identify features that are particularly
important for presenting to humans.
|
void
|
setDisplayName(String displayName)
Sets the localized display name of this feature.
|
void
|
setExpert(boolean expert)
The "expert" flag is used to distinguish between features that are
intended for expert users from those that are intended for normal users.
|
void
|
setHidden(boolean hidden)
The "hidden" flag is used to identify features that are intended only
for tool use, and which should not be exposed to humans.
|
void
|
setName(String name)
Sets the programmatic name of this feature.
|
void
|
setPreferred(boolean preferred)
The "preferred" flag is used to identify features that are particularly
important for presenting to humans.
|
void
|
setShortDescription(String text)
You can associate a short descriptive string with a feature.
|
void
|
setValue(String attributeName, Object value)
Associate a named attribute with this feature.
|
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
Public Constructors
public
IndexedPropertyDescriptor
(String propertyName, Class<?> beanClass)
This constructor constructs an IndexedPropertyDescriptor for a property
that follows the standard Java conventions by having getFoo and setFoo
accessor methods, for both indexed access and array access.
Thus if the argument name is "fred", it will assume that there
is an indexed reader method "getFred", a non-indexed (array) reader
method also called "getFred", an indexed writer method "setFred",
and finally a non-indexed writer method "setFred".
Parameters
propertyName
| The programmatic name of the property. |
beanClass
| The Class object for the target bean. |
public
IndexedPropertyDescriptor
(String propertyName, Class<?> beanClass, String readMethodName, String writeMethodName, String indexedReadMethodName, String indexedWriteMethodName)
This constructor takes the name of a simple property, and method
names for reading and writing the property, both indexed
and non-indexed.
Parameters
propertyName
| The programmatic name of the property. |
beanClass
| The Class object for the target bean. |
readMethodName
| The name of the method used for reading the property
values as an array. May be null if the property is write-only
or must be indexed. |
writeMethodName
| The name of the method used for writing the property
values as an array. May be null if the property is read-only
or must be indexed. |
indexedReadMethodName
| The name of the method used for reading
an indexed property value.
May be null if the property is write-only. |
indexedWriteMethodName
| The name of the method used for writing
an indexed property value.
May be null if the property is read-only. |
public
IndexedPropertyDescriptor
(String propertyName, Method readMethod, Method writeMethod, Method indexedReadMethod, Method indexedWriteMethod)
This constructor takes the name of a simple property, and Method
objects for reading and writing the property.
Parameters
propertyName
| The programmatic name of the pro
perty. |
readMethod
| The method used for reading the property values as an array.
May be null if the property is write-only or must be indexed. |
writeMethod
| The method used for writing the property values as an array.
May be null if the property is read-only or must be indexed. |
indexedReadMethod
| The method used for reading an indexed property value.
May be null if the property is write-only. |
indexedWriteMethod
| The method used for writing an indexed property value.
May be null if the property is read-only. |
Public Methods
public
boolean
equals
(Object obj)
Compares this PropertyDescriptor
against the specified object.
Returns true if the objects are the same. Two PropertyDescriptor
s
are the same if the read, write, property types, property editor and
flags are equivalent.
Parameters
obj
| the reference object with which to compare. |
Returns
true
if this object is the same as the obj
argument; false
otherwise.
public
synchronized
Class<?>
getIndexedPropertyType
()
Gets the Class
object of the indexed properties' type.
The returned Class
may describe a primitive type such as int
.
Returns
- The
Class
for the indexed properties' type; may return null
if the type cannot be determined.
public
synchronized
Method
getIndexedReadMethod
()
Gets the method that should be used to read an indexed
property value.
Returns
- The method that should be used to read an indexed
property value.
May return null if the property isn't indexed or is write-only.
public
synchronized
Method
getIndexedWriteMethod
()
Gets the method that should be used to write an indexed property value.
Returns
- The method that should be used to write an indexed
property value.
May return null if the property isn't indexed or is read-only.
public
int
hashCode
()
Returns a hash code value for the object.
See hashCode()
for a complete description.
Returns
- a hash code value for this object.
public
synchronized
void
setIndexedReadMethod
(Method readMethod)
Sets the method that should be used to read an indexed property value.
Parameters
readMethod
| The new indexed read method.
|
public
synchronized
void
setIndexedWriteMethod
(Method writeMethod)
Sets the method that should be used to write an indexed property value.
Parameters
writeMethod
| The new indexed write method.
|