ameba.util.bean

类 BeanMap<T>

java.lang.Object

java.util.AbstractMap<String,Object>

ameba.util.bean.BeanMap<T>

所有已实现的接口:

Cloneable, Map<String,Object>

public class BeanMap<T>
extends AbstractMap<String,Object>
implements Cloneable

作者:

icode

嵌套类概要

嵌套类

限定符和类型	类和说明
protected static class	BeanMap.Entry<T> Map entry used by BeanMap.

从类继承的嵌套类/接口 java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

字段概要

字段

限定符和类型	字段和说明
protected T	bean An empty array.
protected Class<T>	beanClass
protected Map<String,ameba.util.bean.BeanMap.HandleType>	readHandleType
protected Map<String,BeanInvoker>	readInvokers
protected BeanTransformer	transformer
protected Map<String,Class<?>>	types
protected Map<String,BeanInvoker>	writeInvokers

构造器概要

构造器

构造器和说明
BeanMap() Constructs a new empty BeanMap.
BeanMap(T bean) Constructs a new BeanMap that operates on the specified bean.
BeanMap(T bean, BeanTransformer beanTransformer)

方法概要

方法

限定符和类型	方法和说明
void	clear() This method reinitializes the bean map to have default values for the bean's properties.
Object	clone() Clone this bean map using the following process: If there is no underlying bean, return a cloned BeanMap without a bean.
boolean	containsKey(Object name) Returns true if the bean defines a property with the given name.
Iterator<Map.Entry<String,Object>>	entryIterator() Convenience method for getting an iterator over the entries.
Set<Map.Entry<String,Object>>	entrySet() Gets a Set of MapEntry objects that are the mappings for this BeanMap.
protected void	firePropertyChange(Object key, Object oldValue, Object newValue) Called during a successful AbstractMap.put(Object, Object) operation.
Object	get(Object name) Returns the value of the bean's property with the given name.
T	getBean() Returns the bean currently being operated on.
String	getBeanName()
BeanInvoker	getReadInvoker(String name) Returns the accessor for the property with the given name.
Class<?>	getType(String name) Returns the type of the property with the given name.
BeanInvoker	getWriteInvoker(String name) Returns the mutator for the property with the given name.
protected void	initialise()
Iterator<String>	keyIterator() Convenience method for getting an iterator over the keys.
Set<String>	keySet() Get the keys for this BeanMap.
Object	put(String name, Object value) Sets the bean property with the given name to the given value.
void	putAllWriteable(BeanMap<T> map) Puts all of the writable properties from the given BeanMap into this BeanMap.
protected void	reinitialise() Reinitializes this bean.
void	set(String name, Object value)
void	setBean(T newBean) Sets the bean to be operated on by this map.
int	size() Returns the number of properties defined by the bean.
String	toString() Renders a string representation of this object.
protected Object	transform(BeanInvoker invoker)
protected String	transformPropertyName(String name)
Iterator<Object>	valueIterator() Convenience method for getting an iterator over the values.
Collection<Object>	values() Returns the values for the BeanMap.

从类继承的方法 java.util.AbstractMap

containsValue, equals, hashCode, isEmpty, putAll, remove

从类继承的方法 java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细资料

transformer

protected BeanTransformer transformer

bean

protected transient T bean

An empty array. Used to invoke accessors via reflection.

beanClass

protected transient Class<T> beanClass

readInvokers

protected transient Map<String,BeanInvoker> readInvokers

writeInvokers

protected transient Map<String,BeanInvoker> writeInvokers

types

protected transient Map<String,Class<?>> types

readHandleType

protected transient Map<String,ameba.util.bean.BeanMap.HandleType> readHandleType

构造器详细资料

BeanMap

public BeanMap()

Constructs a new empty BeanMap.

BeanMap

public BeanMap(T bean)

Constructs a new BeanMap that operates on the specified bean. If the given bean is null, then this map will be empty.

参数:

bean - the bean for this map to operate on

BeanMap

public BeanMap(T bean,
       BeanTransformer beanTransformer)

方法详细资料

getBeanName

public String getBeanName()

toString

public String toString()

Renders a string representation of this object.

覆盖:

toString 在类中 AbstractMap<String,Object>

返回:

a String representation of this object

clone

public Object clone()
             throws CloneNotSupportedException

Clone this bean map using the following process:

• If there is no underlying bean, return a cloned BeanMap without a bean.
  
• Since there is an underlying bean, try to instantiate a new bean of the same type using Class.newInstance().
  
• If the instantiation fails, throw a CloneNotSupportedException
  
• Clone the bean map and set the newly instantiated bean as the underlying bean for the bean map.
  
• Copy each property that is both readable and writable from the existing object to a cloned bean map.
  
• If anything fails along the way, throw a CloneNotSupportedException.
  

覆盖:

clone 在类中 AbstractMap<String,Object>

返回:

a cloned instance of this bean map

抛出:

CloneNotSupportedException - if the underlying bean cannot be cloned

putAllWriteable

public void putAllWriteable(BeanMap<T> map)

Puts all of the writable properties from the given BeanMap into this BeanMap. Read-only and Write-only properties will be ignored.

参数:

map - the BeanMap whose properties to put

clear

public void clear()

This method reinitializes the bean map to have default values for the bean's properties. This is accomplished by constructing a new instance of the bean which the map uses as its underlying data source. This behavior for clear() differs from the Map contract in that the mappings are not actually removed from the map (the mappings for a BeanMap are fixed).

指定者:

clear 在接口中 Map<String,Object>

覆盖:

clear 在类中 AbstractMap<String,Object>

containsKey

public boolean containsKey(Object name)

Returns true if the bean defines a property with the given name.
The given name must be a String; if not, this method returns false. This method will also return false if the bean does not define a property with that name.
Write-only properties will not be matched as the test operates against property read methods.

指定者:

containsKey 在接口中 Map<String,Object>

覆盖:

containsKey 在类中 AbstractMap<String,Object>

参数:

name - the name of the property to check

返回:

false if the given name is null or is not a String; false if the bean does not define a property with that name; or true if the bean does define a property with that name

get

public Object get(Object name)

Returns the value of the bean's property with the given name.
The given name must be a String and must not be null; otherwise, this method returns null. If the bean defines a property with the given name, the value of that property is returned. Otherwise, null is returned.
Write-only properties will not be matched as the test operates against property read methods.

指定者:

get 在接口中 Map<String,Object>

覆盖:

get 在类中 AbstractMap<String,Object>

参数:

name - the name of the property whose value to return

返回:

the value of the property with that name

transform

protected Object transform(BeanInvoker invoker)
                    throws Throwable

抛出:

Throwable

put

public Object put(String name,
         Object value)
           throws IllegalArgumentException,
                  ClassCastException

Sets the bean property with the given name to the given value.

指定者:

put 在接口中 Map<String,Object>

覆盖:

put 在类中 AbstractMap<String,Object>

参数:

name - the name of the property to set

value - the value to set that property to

返回:

the previous value of that property

抛出:

IllegalArgumentException - if the given name is null; if the given name is not a String; if the bean doesn't define a property with that name; or if the bean property with that name is read-only

ClassCastException - if an error occurs creating the method args

set

public void set(String name,
       Object value)
         throws IllegalArgumentException,
                ClassCastException

抛出:

IllegalArgumentException

ClassCastException

size

public int size()

Returns the number of properties defined by the bean.

指定者:

size 在接口中 Map<String,Object>

覆盖:

size 在类中 AbstractMap<String,Object>

返回:

the number of properties defined by the bean

keySet

public Set<String> keySet()

Get the keys for this BeanMap.
Write-only properties are not included in the returned set of property names, although it is possible to set their value and to get their type.

指定者:

keySet 在接口中 Map<String,Object>

覆盖:

keySet 在类中 AbstractMap<String,Object>

返回:

BeanMap keys. The Set returned by this method is not modifiable.

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Gets a Set of MapEntry objects that are the mappings for this BeanMap.
Each MapEntry can be set but not removed.

指定者:

entrySet 在接口中 Map<String,Object>

指定者:

entrySet 在类中 AbstractMap<String,Object>

返回:

the unmodifiable set of mappings

values

public Collection<Object> values()

Returns the values for the BeanMap.

指定者:

values 在接口中 Map<String,Object>

覆盖:

values 在类中 AbstractMap<String,Object>

返回:

values for the BeanMap. The returned collection is not modifiable.

getType

public Class<?> getType(String name)

Returns the type of the property with the given name.

参数:

name - the name of the property

返回:

the type of the property, or null if no such property exists

keyIterator

public Iterator<String> keyIterator()

Convenience method for getting an iterator over the keys.
Write-only properties will not be returned in the iterator.

返回:

an iterator over the keys

valueIterator

public Iterator<Object> valueIterator()

Convenience method for getting an iterator over the values.

返回:

an iterator over the values

entryIterator

public Iterator<Map.Entry<String,Object>> entryIterator()

Convenience method for getting an iterator over the entries.

返回:

an iterator over the entries

getBean

public T getBean()

Returns the bean currently being operated on. The return value may be null if this map is empty.

返回:

the bean being operated on by this map

setBean

public void setBean(T newBean)

Sets the bean to be operated on by this map. The given value may be null, in which case this map will be empty.

参数:

newBean - the new bean to operate on

getReadInvoker

public BeanInvoker getReadInvoker(String name)

Returns the accessor for the property with the given name.

参数:

name - the name of the property

返回:

the accessor method for the property, or null

getWriteInvoker

public BeanInvoker getWriteInvoker(String name)

Returns the mutator for the property with the given name.

参数:

name - the name of the property

返回:

the mutator method for the property, or null

reinitialise

protected void reinitialise()

Reinitializes this bean. Called during setBean(Object). Does introspection to find properties.

transformPropertyName

protected String transformPropertyName(String name)

initialise

protected void initialise()

firePropertyChange

protected void firePropertyChange(Object key,
                      Object oldValue,
                      Object newValue)

Called during a successful AbstractMap.put(Object, Object) operation. Default implementation does nothing. Override to be notified of property changes in the bean caused by this map.

参数:

key - the name of the property that changed

oldValue - the old value for that property

newValue - the new value for that property