de.caluga.morphium

Class AnnotationAndReflectionHelper

java.lang.Object

de.caluga.morphium.AnnotationAndReflectionHelper

public class AnnotationAndReflectionHelper
extends Object

User: Stephan Bösebeck Date: 07.03.13 Time: 11:10

This class will encapsulate all calls to the reflection API. Specially getting all the annotations from entities is done here. For performance increase (and because the structure of the code usually does not change during runtime) those results are being cached.

this class is ThreadSafe!

Constructor Summary

Constructors

Constructor and Description
AnnotationAndReflectionHelper(boolean convertCamelCase)
AnnotationAndReflectionHelper(boolean convertCamelCase, Map<Class<?>,Class<?>> realClassCache)

Method Summary

Modifier and Type	Method and Description
void	callLifecycleMethod(Class<? extends Annotation> type, Object on)
String	convertCamelCase(String n) turns documentId into document_id
String	createCamelCase(String n, boolean capitalize) converts a sql/javascript-Name to Java, e.g. converts document_id to documentId.
String	getAdditionalDataField(Class<?> cls)
List<Annotation>	getAllAnnotationsFromHierachy(Class<?> cls, Class<? extends Annotation>... anCls)
List<Field>	getAllFields(Class clz) return list of fields in class - including hierachy!!!
<T extends Annotation> T	getAnnotationFromHierarchy(Class<?> superClass, Class<? extends T> annotationClass) returns annotations, even if in class hierarchy or lazyloading proxy
Class	getClassForTypeId(String typeId)
String	getCreationTimeField(Class<?> cls)
Date	getDateValue(Object o, String fld)
Double	getDoubleValue(Object o, String fld)
Field	getField(Class clz, String fld) extended logic: Fld may be, the java field name, the name of the specified value in Property-Annotation or the translated underscored lowercase name (mongoId => mongo_id) or a name specified in the Aliases-Annotation of this field
String	getFieldName(Class clz, String field)
List<String>	getFields(Class cls, boolean ignoreEntity, Class<? extends Annotation>... annotations)
List<String>	getFields(Class cls, Class<? extends Annotation>... annotations) get a list of valid fields of a given record as they are in the MongoDB so, if you have a field Mapping, the mapped Property-name will be used returns all fields, which have at least one of the given annotations if no annotation is given, all fields are returned Does not take the @Aliases-annotation int account
Object	getId(Object o)
Field	getIdField(Object o)
String	getIdFieldName(Object o)
String	getLastAccessField(Class<?> cls)
String	getLastChangeField(Class<?> cls)
Long	getLongValue(Object o, String fld)
<T> Class<? extends T>	getRealClass(Class<? extends T> superClass)
<T> T	getRealObject(T o)
String	getStringValue(Object o, String fld)
String	getTypeIdForClass(Class cls)
String	getTypeIdForClassName(String n)
Class	getTypeOfField(Class<?> cls, String fld)
Object	getValue(Object o, String fld)
Long	getVersion(Object o)
Field	getVersionField(Object o)
boolean	hasAdditionalData(Class aClass)
<T extends Annotation> boolean	isAnnotationPresentInHierarchy(Class<?> aClass, Class<? extends T> annotationClass)
boolean	isAsyncWrite(Class<?> cls)
boolean	isBufferedWrite(Class<?> aClass)
boolean	isEntity(Object o)
void	setValue(Object o, Object value, String fld)
boolean	storesCreation(Class<?> cls)
boolean	storesLastAccess(Class<?> cls)
boolean	storesLastChange(Class<?> cls)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AnnotationAndReflectionHelper

public AnnotationAndReflectionHelper(boolean convertCamelCase)

AnnotationAndReflectionHelper

public AnnotationAndReflectionHelper(boolean convertCamelCase,
                                     Map<Class<?>,Class<?>> realClassCache)

Method Detail

getTypeIdForClassName

public String getTypeIdForClassName(String n)
                             throws ClassNotFoundException

Throws:

ClassNotFoundException

getTypeIdForClass

public String getTypeIdForClass(Class cls)

getClassForTypeId

public Class getClassForTypeId(String typeId)
                        throws ClassNotFoundException

Throws:

ClassNotFoundException

isAnnotationPresentInHierarchy

public <T extends Annotation> boolean isAnnotationPresentInHierarchy(Class<?> aClass,
                                                                     Class<? extends T> annotationClass)

getAnnotationFromHierarchy

public <T extends Annotation> T getAnnotationFromHierarchy(Class<?> superClass,
                                                           Class<? extends T> annotationClass)

returns annotations, even if in class hierarchy or lazyloading proxy

Parameters:

superClass - class

Returns:

the Annotation

getRealClass

public <T> Class<? extends T> getRealClass(Class<? extends T> superClass)

isBufferedWrite

public boolean isBufferedWrite(Class<?> aClass)

hasAdditionalData

public boolean hasAdditionalData(Class aClass)

getFieldName

public String getFieldName(Class clz,
                           String field)

createCamelCase

public String createCamelCase(String n,
                              boolean capitalize)

converts a sql/javascript-Name to Java, e.g. converts document_id to documentId.

Parameters:

n - - string to convert

capitalize - : if true, first letter will be capitalized

Returns:

the translated name (capitalized or camel_case => camelCase)

convertCamelCase

public String convertCamelCase(String n)

turns documentId into document_id

Parameters:

n - - string to convert

Returns:

converted string (camelCase becomes camel_case)

getAllFields

public List<Field> getAllFields(Class clz)

return list of fields in class - including hierachy!!!

Parameters:

clz - class to get all fields for

Returns:

list of fields in that class

getField

public Field getField(Class clz,
                      String fld)

extended logic: Fld may be, the java field name, the name of the specified value in Property-Annotation or the translated underscored lowercase name (mongoId => mongo_id) or a name specified in the Aliases-Annotation of this field

Parameters:

clz - - class to search

fld - - field name

Returns:

field, if found, null else

isEntity

public boolean isEntity(Object o)

getValue

public Object getValue(Object o,
                       String fld)

setValue

public void setValue(Object o,
                     Object value,
                     String fld)

getVersionField

public Field getVersionField(Object o)

getVersion

public Long getVersion(Object o)

getId

public Object getId(Object o)

getIdFieldName

public String getIdFieldName(Object o)

getIdField

public Field getIdField(Object o)

getFields

public List<String> getFields(Class cls,
                              Class<? extends Annotation>... annotations)

get a list of valid fields of a given record as they are in the MongoDB so, if you have a field Mapping, the mapped Property-name will be used returns all fields, which have at least one of the given annotations if no annotation is given, all fields are returned Does not take the @Aliases-annotation int account

Parameters:

cls - - the class to geht ghe Fields from

Returns:

List of Strings, each a field name (as described in @Property or determined by name)

getFields

public List<String> getFields(Class cls,
                              boolean ignoreEntity,
                              Class<? extends Annotation>... annotations)

getRealObject

public <T> T getRealObject(T o)

getTypeOfField

public final Class getTypeOfField(Class<?> cls,
                                  String fld)

storesLastChange

public boolean storesLastChange(Class<?> cls)

storesLastAccess

public boolean storesLastAccess(Class<?> cls)

storesCreation

public boolean storesCreation(Class<?> cls)

getLongValue

public Long getLongValue(Object o,
                         String fld)

getStringValue

public String getStringValue(Object o,
                             String fld)

getDateValue

public Date getDateValue(Object o,
                         String fld)

getDoubleValue

public Double getDoubleValue(Object o,
                             String fld)

getAllAnnotationsFromHierachy

public List<Annotation> getAllAnnotationsFromHierachy(Class<?> cls,
                                                      Class<? extends Annotation>... anCls)

getLastChangeField

public String getLastChangeField(Class<?> cls)

getLastAccessField

public String getLastAccessField(Class<?> cls)

getAdditionalDataField

public String getAdditionalDataField(Class<?> cls)

getCreationTimeField

public String getCreationTimeField(Class<?> cls)

callLifecycleMethod

public void callLifecycleMethod(Class<? extends Annotation> type,
                                Object on)

isAsyncWrite

public boolean isAsyncWrite(Class<?> cls)