jmplib

Class SimpleEvaluator

java.lang.Object

jmplib.SimpleEvaluator

All Implemented Interfaces:

IEvaluator

Direct Known Subclasses:

ThreadSafeSimpleEvaluator

public class SimpleEvaluator
extends java.lang.Object
implements IEvaluator

Constructor Summary

Constructors

Constructor and Description
SimpleEvaluator() Use createEvaluator instead.

Method Summary

Modifier and Type	Method and Description
java.lang.Class<?>	createEmptyClass(java.lang.String packageName, java.lang.String className, java.lang.reflect.AnnotatedElement... importClasses) 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 type, 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 type, 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 type, java.lang.String name, MemberInvokerData<T> info) Generates an instance of the specified interface to provide one field setter.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleEvaluator

public SimpleEvaluator()

Use createEvaluator instead.

Method Detail

createEvaluator

public IEvaluator createEvaluator()

Creates an instance of the evaluator implementing this interface

Specified by:

createEvaluator in interface IEvaluator

Returns:

An evaluator instance

getMethodInvoker

public <T> T getMethodInvoker(java.lang.reflect.Type type,
                              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.

Specified by:

getMethodInvoker in interface IEvaluator

Parameters:

type - 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

public <T> T getFieldInvoker(java.lang.reflect.Type type,
                             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.

Specified by:

getFieldInvoker in interface IEvaluator

Parameters:

type - 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

public <T> T setFieldInvoker(java.lang.reflect.Type type,
                             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.

Specified by:

setFieldInvoker in interface IEvaluator

Parameters:

type - 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

public java.lang.Class<?> createEmptyClass(java.lang.String packageName,
                                           java.lang.String className,
                                           java.lang.reflect.AnnotatedElement... importClasses)
                                    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.

Specified by:

createEmptyClass in interface IEvaluator

Parameters:

packageName - Package name of the class to be created

className - Name of the class to be created

importClasses - 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

public 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.

Specified by:

exec in interface IEvaluator

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

public <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.

Specified by:

generateEvalInvoker in interface IEvaluator

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)