de.alpharogroup.lang

Class AnnotationExtensions

java.lang.Object

de.alpharogroup.lang.AnnotationExtensions

public final class AnnotationExtensions
extends Object

The class AnnotationExtensions.

Author:

Asterios Raptis

Method Summary

Modifier and Type	Method and Description
static Set<Class<?>>	getAllAnnotatedClasses(String packagePath, Class<? extends Annotation> annotationClass) Gets all annotated classes that belongs from the given package path and the given annotation class.
static Set<Class<?>>	getAllAnnotatedClassesFromSet(String packagePath, Set<Class<? extends Annotation>> annotationClasses) Gets all annotated classes that belongs from the given package path and the given list with annotation classes.
static Set<Class<?>>	getAllClasses(String packagePath) Gets all the classes from the class loader that belongs to the given package path.
static Set<Class<?>>	getAllClasses(String packagePath, Set<Class<? extends Annotation>> annotationClasses) Gets all the classes from the class loader that belongs to the given package path.
static <T extends Annotation> T	getAnnotation(Class<?> componentClass, Class<T> annotationClass) Search for the given annotationClass in the given componentClass and return it if search was successful.
static boolean	isAnnotationPresentInSuperClasses(Class<?> componentClass, Class<? extends Annotation> annotationClass) Checks if is annotation present through making a lookup if the given annotation class is present in the given class or in one of the super classes.
static boolean	isAnnotationPresentInSuperClassesOrInterfaces(Class<?> componentClass, Class<? extends Annotation> annotationClass) Checks if is annotation present through making a lookup if the given annotation class is present in the given class or in one of the super classes.
static Set<Class<?>>	scanForAnnotatedClasses(File directory, String packagePath, Class<? extends Annotation> annotationClass) Scan recursive for annotated classes in the given directory.
static Set<Class<?>>	scanForAnnotatedClassesFromSet(File directory, String packagePath, Set<Class<? extends Annotation>> annotationClasses) Scan recursive for annotated classes in the given directory.
static Set<Class<?>>	scanForClasses(File directory, String packagePath) Scan recursive for classes in the given directory.
static Object	setAnnotationValue(Annotation annotation, String key, Object value) Sets the annotation value for the given key of the given annotation to the given new value at runtime.

Methods inherited from class java.lang.Object

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

Method Detail

getAllAnnotatedClasses

public static Set<Class<?>> getAllAnnotatedClasses(String packagePath,
                                                   Class<? extends Annotation> annotationClass)
                                            throws ClassNotFoundException,
                                                   IOException

Gets all annotated classes that belongs from the given package path and the given annotation class.

Parameters:

packagePath - the package path

annotationClass - the annotation class

Returns:

the all classes

Throws:

ClassNotFoundException - the class not found exception

IOException - Signals that an I/O exception has occurred.

getAllAnnotatedClassesFromSet

public static Set<Class<?>> getAllAnnotatedClassesFromSet(String packagePath,
                                                          Set<Class<? extends Annotation>> annotationClasses)
                                                   throws ClassNotFoundException,
                                                          IOException

Gets all annotated classes that belongs from the given package path and the given list with annotation classes.

Parameters:

packagePath - the package path

annotationClasses - the list with the annotation classes

Returns:

the all classes

Throws:

ClassNotFoundException - the class not found exception

IOException - Signals that an I/O exception has occurred.

getAllClasses

public static Set<Class<?>> getAllClasses(String packagePath)
                                   throws ClassNotFoundException,
                                          IOException

Gets all the classes from the class loader that belongs to the given package path.

Parameters:

packagePath - the package path

Returns:

the all classes

Throws:

ClassNotFoundException - the class not found exception

IOException - Signals that an I/O exception has occurred.

getAllClasses

public static Set<Class<?>> getAllClasses(String packagePath,
                                          Set<Class<? extends Annotation>> annotationClasses)
                                   throws ClassNotFoundException,
                                          IOException

Gets all the classes from the class loader that belongs to the given package path.

Parameters:

packagePath - the package path

annotationClasses - the annotation classes

Returns:

the all classes

Throws:

ClassNotFoundException - the class not found exception

IOException - Signals that an I/O exception has occurred.

getAnnotation

public static <T extends Annotation> T getAnnotation(Class<?> componentClass,
                                                     Class<T> annotationClass)

Search for the given annotationClass in the given componentClass and return it if search was successful.

Type Parameters:

T - the generic type

Parameters:

componentClass - the component class

annotationClass - the annotation class

Returns:

the annotation

isAnnotationPresentInSuperClasses

public static boolean isAnnotationPresentInSuperClasses(Class<?> componentClass,
                                                        Class<? extends Annotation> annotationClass)

Checks if is annotation present through making a lookup if the given annotation class is present in the given class or in one of the super classes.

Parameters:

componentClass - the component class

annotationClass - the annotation class

Returns:

true, if is annotation present

isAnnotationPresentInSuperClassesOrInterfaces

public static boolean isAnnotationPresentInSuperClassesOrInterfaces(Class<?> componentClass,
                                                                    Class<? extends Annotation> annotationClass)

Checks if is annotation present through making a lookup if the given annotation class is present in the given class or in one of the super classes.

Parameters:

componentClass - the component class

annotationClass - the annotation class

Returns:

true, if is annotation present

scanForAnnotatedClasses

public static Set<Class<?>> scanForAnnotatedClasses(File directory,
                                                    String packagePath,
                                                    Class<? extends Annotation> annotationClass)
                                             throws ClassNotFoundException

Scan recursive for annotated classes in the given directory.

Parameters:

directory - the directory

packagePath - the package path

annotationClass - the annotation class

Returns:

the list

Throws:

ClassNotFoundException - occurs if a given class cannot be located by the specified class loader

scanForAnnotatedClassesFromSet

public static Set<Class<?>> scanForAnnotatedClassesFromSet(File directory,
                                                           String packagePath,
                                                           Set<Class<? extends Annotation>> annotationClasses)
                                                    throws ClassNotFoundException

Scan recursive for annotated classes in the given directory.

Parameters:

directory - the directory

packagePath - the package path

annotationClasses - the list with the annotation classes

Returns:

the list

Throws:

ClassNotFoundException - the class not found exception

scanForClasses

public static Set<Class<?>> scanForClasses(File directory,
                                           String packagePath)
                                    throws ClassNotFoundException

Scan recursive for classes in the given directory.

Parameters:

directory - the directory

packagePath - the package path

Returns:

the list

Throws:

ClassNotFoundException - the class not found exception

setAnnotationValue

public static Object setAnnotationValue(Annotation annotation,
                                        String key,
                                        Object value)
                                 throws NoSuchFieldException,
                                        SecurityException,
                                        IllegalArgumentException,
                                        IllegalAccessException

Sets the annotation value for the given key of the given annotation to the given new value at runtime.

Parameters:

annotation - the annotation

key - the key

value - the value to set

Returns:

the old value or default value if not set

Throws:

NoSuchFieldException - the no such field exception

SecurityException - Thrown if the security manager indicates a security violation.

IllegalArgumentException - the illegal argument exception

IllegalAccessException - the illegal access exception