jmplib.util.intercessor

Class IntercessorUtils

java.lang.Object

jmplib.util.intercessor.IntercessorUtils

public class IntercessorUtils
extends java.lang.Object

This class holds all the utility methods of both intercessors, mostly related to checking parameters. It was created as a major refactoring and code optimization process.

Author:

Jose Manuel Redondo

Constructor Summary

Constructors

Constructor and Description
IntercessorUtils()

Method Summary

Modifier and Type	Method and Description
static void	checkVisibility(java.lang.Class<?> clazz, java.lang.String name) Checks if there is any attribute in the last version of the class that matches with the data provided and its visibility is public.
static void	checkVisibility(java.lang.Class<?> clazz, java.lang.String name, java.lang.Class<?> methodInterface, int modifiers, java.lang.Class<?>[] parametrizationClasses) Checks if any method matches the provided functional interface method in the last version of the class.
static <T> T	compileFile(java.io.File file, java.lang.String name, java.lang.String packageName) Compiles a class file and return an instance of the compiled class.
static void	resetLibraryState() This method clears the source code cache, so previously modified classes are not taken into account when performing "unsafe" operations (those that may produce errors with external classes that call the modified classes, such as deleting methods or modifying the hierarchy of a class).

Methods inherited from class java.lang.Object

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

Constructor Detail

IntercessorUtils

public IntercessorUtils()

Method Detail

compileFile

public static <T> T compileFile(java.io.File file,
                                java.lang.String name,
                                java.lang.String packageName)
                         throws CompilationFailedException,
                                StructuralIntercessionException

Compiles a class file and return an instance of the compiled class. Each class compiled is instrumented by Polyglot. The name and the package of the class are needed to load the Class instance.

Parameters:

file - The file of the class

name - The name of the class

packageName - The package of the class

Returns:

The instance of the compiled class

Throws:

CompilationFailedException - If the class have compilation errors

StructuralIntercessionException - If some errors ocurrs

java.lang.RuntimeException - If there are errors accesing the files, obtaining the class or creating the instance

checkVisibility

public static void checkVisibility(java.lang.Class<?> clazz,
                                   java.lang.String name,
                                   java.lang.Class<?> methodInterface,
                                   int modifiers,
                                   java.lang.Class<?>[] parametrizationClasses)
                            throws java.lang.NoSuchMethodException

Checks if any method matches the provided functional interface method in the last version of the class.

Parameters:

clazz - The original class

name - The name of the method

methodInterface - The functional interface

modifiers - The modifiers of the method

parametrizationClasses - The classes that parametrize the interface

Throws:

java.lang.NoSuchMethodException - If no method matches the functional interface method in the last version of the class

checkVisibility

public static void checkVisibility(java.lang.Class<?> clazz,
                                   java.lang.String name)
                            throws java.lang.NoSuchFieldException

Checks if there is any attribute in the last version of the class that matches with the data provided and its visibility is public.

Parameters:

clazz - The original class

name - The name of the field

Throws:

java.lang.NoSuchFieldException - If the field isn't public or doesn't exist

resetLibraryState

public static void resetLibraryState()

This method clears the source code cache, so previously modified classes are not taken into account when performing "unsafe" operations (those that may produce errors with external classes that call the modified classes, such as deleting methods or modifying the hierarchy of a class). This is basically used in unit testing, when tests are independent between them and there is no reason to recompile previously compiled classes.