jmplib

Interface IEvaluator

All Known Implementing Classes:

SimpleEvaluator, ThreadSafeSimpleEvaluator

public interface IEvaluator

Method Summary

Modifier and Type	Method and Description
java.lang.Class<?>	createEmptyClass(java.lang.String packageName, java.lang.String className, java.lang.reflect.AnnotatedElement... imports) This method is a front-end of the exec method specially created to easily return empty classes with a concrete name and package.
IEvaluator	createEvaluator() Creates an instance of the evaluator implementing this interface
java.lang.Class<?>	exec(java.lang.String classSource) Exec method allows the addition of new classes at runtime from its source code to the application.
<T> T	generateEvalInvoker(java.lang.String code, EvalInvokerData<T> invokerData) This method generates classes that implements generic functional interfaces, that have to extend EnvironmentSetUp interface.
<T> T	getFieldInvoker(java.lang.reflect.Type clazz, java.lang.String name, MemberInvokerData<T> info) Generates an instance of the specified interface to provide one field getter.
<T> T	getMethodInvoker(java.lang.reflect.Type clazz, java.lang.String name, MemberInvokerData<T> info) Generates an instance of the specified interface to invoke one method.
<T> T	setFieldInvoker(java.lang.reflect.Type clazz, java.lang.String name, MemberInvokerData<T> info) Generates an instance of the specified interface to provide one field setter.

Method Detail

createEvaluator

IEvaluator createEvaluator()

Creates an instance of the evaluator implementing this interface

Returns:

An evaluator instance

getMethodInvoker

<T> T getMethodInvoker(java.lang.reflect.Type clazz,
                       java.lang.String name,
                       MemberInvokerData<T> info)
                throws StructuralIntercessionException

Generates an instance of the specified interface to invoke one method. The first parameter of the interface must be the class owner type, meaning, the class where the method is. This parameter is going to be the instance over the invokations are called.

Parameters:

clazz - The class where the method is

name - The name of the method

info - The invoker data needed to obtain the invoker of the specified method

Returns:

The populated interface with the invoker

Throws:

StructuralIntercessionException - If a problem was encountered before finishing

getFieldInvoker

<T> T getFieldInvoker(java.lang.reflect.Type clazz,
                      java.lang.String name,
                      MemberInvokerData<T> info)
               throws StructuralIntercessionException

Generates an instance of the specified interface to provide one field getter. The first parameter of the interface must be the class owner type, meaning, the class where the field is.

Parameters:

clazz - The class where the field is

name - The name of the field

info - The invoker data needed to obtain the invoker of the specified field

Returns:

The populated interface with the invoker

Throws:

StructuralIntercessionException - If a problem was encountered before finishing

setFieldInvoker

<T> T setFieldInvoker(java.lang.reflect.Type clazz,
                      java.lang.String name,
                      MemberInvokerData<T> info)
               throws StructuralIntercessionException

Generates an instance of the specified interface to provide one field setter. The first parameter of the interface must be the class owner type, meaning, the class where the field is.

Parameters:

clazz - The class where the field is

name - The name of the field

info - The invoker data needed to obtain the invoker of the specified field

Returns:

The populated interface with the invoker

Throws:

StructuralIntercessionException - If a problem was encountered before finishing

createEmptyClass

java.lang.Class<?> createEmptyClass(java.lang.String packageName,
                                    java.lang.String className,
                                    java.lang.reflect.AnnotatedElement... imports)
                             throws StructuralIntercessionException

This method is a front-end of the exec method specially created to easily return empty classes with a concrete name and package. Coupled with the new functionalities that allow to incorporate arrays of fields and methods from other classes, it can be a powerful way of creating brand new classes made from parts of other classes.

Parameters:

packageName - Package name of the class to be created

className - Name of the class to be created

imports - Import clauses to be included in the new file.

Returns:

A class with the specified name and imports but with no contents

Throws:

StructuralIntercessionException

exec

java.lang.Class<?> exec(java.lang.String classSource)
                 throws StructuralIntercessionException

Exec method allows the addition of new classes at runtime from its source code to the application. These classes are incorporated to the specified package as they were there before the application start running, and can be used by other classes as normal.

The following example shows how does it works:

 Class clazz = Evaluator.exec("package pack.example; public class Foo {}");
 

This sentence adds a new class called Foo to the package package.example of the application. This new class is compatible with JMPlib modifications because a copy of its source code is located inside the source code folder.

IMPORTANT: If you stop the application make sure you delete the added classes before launching it again.

Parameters:

classSource - source code of the class

Returns:

The class reference

Throws:

StructuralIntercessionException - If problems with the metaprogramming primitives are detected (exception * message indicates the concrete problem, as it wraps the inner exception)

generateEvalInvoker

<T> T generateEvalInvoker(java.lang.String code,
                          EvalInvokerData<T> invokerData)
                   throws StructuralIntercessionException

This method generates classes that implements generic functional interfaces, that have to extend EnvironmentSetUp interface. It allows to enclose the code given and invoke it by the interface instance returned.

Additionally, this method define the global variables of the generated class using the map environment . All this variables are common for each invokation and have to be initialized by the method EnvironmentSetUp.setEnvironment.

Parameters:

code - the code to enclose in the interface method

invokerData - Data needed to perform the code evaluation

Throws:

StructuralIntercessionException - If problems with the metaprogramming primitives are detected (exception * message indicates the concrete problem, as it wraps the inner exception)