org.castor.jdo.jpa.processors
Class ReflectionsHelper

java.lang.Object
  extended by org.castor.jdo.jpa.processors.ReflectionsHelper

public final class ReflectionsHelper
extends java.lang.Object

Tool class that offers methods to retrieve information from AnnotatedElements (Methods or Fields).

Version:
12.02.2009
Author:
Peter Schmidt

Method Summary
static java.lang.Class<?> getCollectionType(java.lang.reflect.AnnotatedElement target, boolean jpaTypesOnly)
          Get the (raw) type of collection from the annotations target and optional check for JPA 1.0 restrictions (only Collection, Map, List and Set are allowed).
static java.lang.String getFieldnameFromGetter(java.lang.reflect.Method getter)
          Little helper to get a field (bean property) name from a getter method.
static java.lang.reflect.Method getSetterMethodFromGetter(java.lang.reflect.Method getter)
          Return a setter Method for a given getter Method.
static java.lang.Class<?> getTargetEntityFromGenerics(java.lang.reflect.AnnotatedElement target)
          Get the target entity information from the target (necessary if it was not specified by the annotation itself).
static boolean isGetter(java.lang.reflect.Method method)
          Convenience method to check whether a Method is a getter method, i.e.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getCollectionType

public static java.lang.Class<?> getCollectionType(java.lang.reflect.AnnotatedElement target,
                                                   boolean jpaTypesOnly)
                                            throws AnnotationTargetException
Get the (raw) type of collection from the annotations target and optional check for JPA 1.0 restrictions (only Collection, Map, List and Set are allowed).

Parameters:
target - The ManyToMany annotations target.
jpaTypesOnly - If set to true only Collection types of JPA 1.0 are allowed. Others will lead to a thrown Exception.
Returns:
The raw collection type.
Throws:
AnnotationTargetException - if the raw collection type can not be inferred from the type definition or if the type is not supported by JPA 1.0 and jpaTypesOnly was set to true.

getTargetEntityFromGenerics

public static java.lang.Class<?> getTargetEntityFromGenerics(java.lang.reflect.AnnotatedElement target)
                                                      throws AnnotationTargetException
Get the target entity information from the target (necessary if it was not specified by the annotation itself).

Parameters:
target - The *ToMany annotations target. This method will fail if target is not of Type Field or Method!
Returns:
the relations target entity inferred by the targets generic definition or null if no generic definition was found at all.
Throws:
AnnotationTargetException - if the generic definition is not sufficient

getFieldnameFromGetter

public static java.lang.String getFieldnameFromGetter(java.lang.reflect.Method getter)
Little helper to get a field (bean property) name from a getter method.
Example: getFoo() => "foo"
Example: isBar() => "bar"

Parameters:
getter - the Method to analyse.
Returns:
the field name determined by the methods name or NULL if the method is not a getter (start with "get" or "is").

getSetterMethodFromGetter

public static java.lang.reflect.Method getSetterMethodFromGetter(java.lang.reflect.Method getter)
                                                          throws java.lang.SecurityException,
                                                                 java.lang.NoSuchMethodException
Return a setter Method for a given getter Method.

Parameters:
getter - The getter Method
Returns:
The setter Method for the given getter Method.
Throws:
java.lang.NoSuchMethodException - If the setter method does not exist
java.lang.SecurityException - If the setter method is not accessible

isGetter

public static boolean isGetter(java.lang.reflect.Method method)
Convenience method to check whether a Method is a getter method, i.e. starts with "get" or "is".

Parameters:
method - the Method to check.
Returns:
true if the methods name starts with "get" or "is" (Java Beans convention).


Intalio Inc. (C) 1999-2008. All rights reserved http://www.intalio.com