com.massa.util.property

Class SimpleProperty

java.lang.Object

com.massa.util.property.AbstractProperty

com.massa.util.property.SimpleProperty

All Implemented Interfaces:

IProperty, Serializable

Direct Known Subclasses:

LocalVarProperty, SimpleProperty2

public class SimpleProperty
extends AbstractProperty

Most simple property. A simple String representing a property name. No specified mapped or indexed access. If the source is a map, the property name is used as a key to access the map.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SimpleProperty(String property)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
Object	get(IPropertySource source, boolean instantiateAll) Introspects source to retrieve property value.
Class<?>	getGenericCollectionType(IPropertySource source) Tries to detect if the generic type of the property if the type is a Collection, knowing the argument type to use.
Class<?>	getGenericMapKeyType(IPropertySource source) Tries to detect if the generic key type of the property if the type is a Map, knowing the argument type to use.
Class<?>	getGenericMapValueType(IPropertySource source) Tries to detect if the generic value type of the property if the type is a Map, knowing the argument type to use.
Class<?>[]	getGenericTypes(IPropertySource source) Tries to detect if the parameterized types of the property, whatever its type is, knowing the argument type to use.
String	getProperty()
protected IMethodInvoker	getReadMethod(IPropertySource source, boolean mandatory)
Class<?>	getType(IPropertySource source) Tries to detect if the type of the property, knowing the argument type to use.
protected IMethodInvoker	getWriteMethod(IPropertySource source, boolean mandatory)
protected Class<?>	getWriteMethodParamType(IPropertySource source, boolean mandatory)
protected Object	handleGetFromMap(IPropertySource source, boolean instantiateAll, Map<?,?> map) Gets an object from a typed map.
protected Object	handleSetInTypedMap(TypedMap curTarget, Object obj, boolean forceUseProvidedObjectType) Set an object to a typed map.
int	hashCode()
boolean	isReadable(IPropertySource source) Tries to detect if the property will be able to be read in theory, knowing the argument type to use.
boolean	isWriteable(IPropertySource target) Tries to detect if the property will be able to be written in theory, knowing the argument type to use.
Object	set(IPropertySource target, Object obj, boolean instanciateNested) Introspects target to set property value.
String	toString()

Methods inherited from class com.massa.util.property.AbstractProperty

get, getGenericCollectionType, getGenericMapKeyType, getGenericMapValueType, getGenericTypes, getType, isReadable, isWriteable, set

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleProperty

public SimpleProperty(String property)

Method Detail

get

public Object get(IPropertySource source,
                  boolean instantiateAll)
           throws UtilsException

Description copied from interface: IProperty

Introspects source to retrieve property value. If a nested property is null, tries if requested to instantiate all hierarchy. If this process fails, an exception is raised. If not requested, returns null.

Parameters:

source - Source context to introspect.

instantiateAll - whether to try or not to instantiate null nested properties values.

Throws:

UtilsException

set

public Object set(IPropertySource target,
                  Object obj,
                  boolean instanciateNested)
           throws UtilsException

Description copied from interface: IProperty

Introspects target to set property value. Tries to instantiate null nested properties if requested. If it fails, an exception is raised. If not requested, an exception is directly raised in case of null nested property.

Parameters:

target - Source context to introspect.

obj - Value to set

instanciateNested - whether to try or not to instantiate null nested properties values.

Returns:

Real set value (after eventual cast)

Throws:

UtilsException

handleGetFromMap

protected Object handleGetFromMap(IPropertySource source,
                                  boolean instantiateAll,
                                  Map<?,?> map)
                           throws UtilsException

Gets an object from a typed map. Extracted for performance purposes.

Throws:

UtilsException

handleSetInTypedMap

protected Object handleSetInTypedMap(TypedMap curTarget,
                                     Object obj,
                                     boolean forceUseProvidedObjectType)
                              throws UtilsException

Set an object to a typed map. Extracted for performance purposes.

Parameters:

curTarget - Map where the value will be set.

obj - Value to set in the Map.

forceUseProvidedObjectType - If true, current type in typed map will be overridden.

Throws:

UtilsException

getType

public Class<?> getType(IPropertySource source)
                 throws UtilsException

Description copied from interface: IProperty

Tries to detect if the type of the property, knowing the argument type to use. If impossible, returns null.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

getGenericTypes

public Class<?>[] getGenericTypes(IPropertySource source)
                           throws UtilsException

Description copied from interface: IProperty

Tries to detect if the parameterized types of the property, whatever its type is, knowing the argument type to use. If impossible, returns null.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

getGenericCollectionType

public Class<?> getGenericCollectionType(IPropertySource source)
                                  throws UtilsException

Description copied from interface: IProperty

Tries to detect if the generic type of the property if the type is a Collection, knowing the argument type to use. If impossible, returns null.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

getGenericMapKeyType

public Class<?> getGenericMapKeyType(IPropertySource source)
                              throws UtilsException

Description copied from interface: IProperty

Tries to detect if the generic key type of the property if the type is a Map, knowing the argument type to use. If impossible, returns null.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

getGenericMapValueType

public Class<?> getGenericMapValueType(IPropertySource source)
                                throws UtilsException

Description copied from interface: IProperty

Tries to detect if the generic value type of the property if the type is a Map, knowing the argument type to use. If impossible, returns null.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

isReadable

public boolean isReadable(IPropertySource source)
                   throws UtilsException

Description copied from interface: IProperty

Tries to detect if the property will be able to be read in theory, knowing the argument type to use. Might be based on a real bean or only on a type. When undefined, returns true, so that real case will be detected at runtime.

Parameters:

source - Source context to introspect.

Throws:

UtilsException

isWriteable

public boolean isWriteable(IPropertySource target)
                    throws UtilsException

Description copied from interface: IProperty

Tries to detect if the property will be able to be written in theory, knowing the argument type to use. Might be based on a real bean or only on a type. When undefined, returns true, so that real case will be detected at runtime.

Parameters:

target - Source context to introspect.

Throws:

UtilsException

getReadMethod

protected IMethodInvoker getReadMethod(IPropertySource source,
                                       boolean mandatory)
                                throws UtilsException

Throws:

UtilsException

getWriteMethod

protected IMethodInvoker getWriteMethod(IPropertySource source,
                                        boolean mandatory)
                                 throws UtilsException

Throws:

UtilsException

getWriteMethodParamType

protected Class<?> getWriteMethodParamType(IPropertySource source,
                                           boolean mandatory)
                                    throws UtilsException

Throws:

UtilsException

getProperty

public String getProperty()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object