es.uniovi.reflection.invokedynamic

Class ProxyFactory

java.lang.Object

es.uniovi.reflection.invokedynamic.ProxyFactory

public class ProxyFactory
extends java.lang.Object

The ProxyFactory is a factory method that allows using the invokedynamic opcode included in JVM 1.7. Using this class, it is possible to perform dynamic invocations to methods, fields and constructors.
It is not possible to access to members of non-public types.

Version:

0.3

Author:

Computational Reflection Research Group. University of Oviedo

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.HashMap<java.lang.String,java.lang.Class<?>>	classDescriptor
private static java.util.HashMap<ConstructorClass<?>,Constructor<?>>	constructorClass
private static java.util.HashMap<java.lang.reflect.Field,GetProperty<?>>	fieldGetClass
private static java.util.HashMap<java.lang.reflect.Field,SetProperty>	fieldSetClass
private static java.util.HashMap<MemberBSClass<?>,Callable<?>>	invokedynamicClass
private static java.util.HashMap<MemberClass<?>,Callable<?>>	memberClass
private static java.util.HashMap<MemberBIClass<?>,MemberBIClass<?>>	memberMethod
private static java.util.HashMap<java.lang.reflect.Method,Callable<?>>	methodsClass
private static java.util.HashMap<PropertyClass<?>,GetProperty<?>>	propertyGetClass
private static java.util.HashMap<PropertyClass<?>,SetProperty>	propertySetClass

Constructor Summary

Constructors

Constructor and Description
ProxyFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T	generateCallable(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<T> interfaceCallable) Generates an object to provide instance method invocation using invokedynamic, passing the name of the method and class as parameters.
static <T> Callable<T>	generateCallable(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature.
static <T> Callable<T>	generateCallable(java.lang.reflect.Method method) Generates a Callable instance to perform dynamic invocations to an instance method, indicating a Method instance.
static <T> Callable<T>	generateCallable(java.lang.Object object, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature.
static <T> Callable<T>	generateCallable(java.lang.String clazzDescriptor, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature.
static <T> T	generateConstructor(java.lang.Class<?> clazz, java.lang.Class<T> interfaceCallable) Generates an object to provide a constructor invocation using invokedynamic.
static <T> Constructor<T>	generateConstructor(java.lang.Class<T> clazz, java.lang.Class<?>... parameterstype) Generates a Constructor instance of the class and parameters passed as arguments.
static <T> T	generateGetProperty(java.lang.Class<?> clazz, java.lang.String propertyName, java.lang.Class<T> interfaceCallable) Generates an object to obtain the value of an instance field by means of invokedynamic.
static <T> GetProperty<T>	generateGetProperty(java.lang.reflect.Field field) Generates a GetProperty instance to obtain the value of a Field by means of invokedynamic.
static <T> GetProperty<T>	generateGetProperty(java.lang.Object object, java.lang.String property, java.lang.Class<T> type) Generates a GetProperty instance to obtain the value of an instance field by means of invokedynamic.
static <T> GetProperty<T>	generateGetProperty(java.lang.String clazzDescriptor, java.lang.String property, java.lang.String typeDescriptor) Generates a GetProperty instance to obtain the value of an instance field by means of invokedynamic.
static <T> T	generateInvokeDynamic(Bootstrap bootstrap, java.lang.Class<T> interfaceCallable) Generates an object to provide instance method invocation using invokedynamic, passing the bootstrap method as parameter.
static <T> Callable<T>	generateInvokeDynamicCallable(Bootstrap bootstrap, MethodSignature methodSignature) Generates a Callable instance to perform dynamic invocations to methods, fields and constructors received as a parameter.
static <T> T	generateSetProperty(java.lang.Class<?> clazz, java.lang.String propertyName, java.lang.Class<T> interfaceCallable) Generates an object to modify the value of an instance field by means of invokedynamic.
static SetProperty	generateSetProperty(java.lang.reflect.Field field) Generates a SetProperty instance to modify the value of a Field by means of invokedynamic.
static SetProperty	generateSetProperty(java.lang.Object object, java.lang.String property, java.lang.Class<?> type) Generates a SetProperty instance to modify the value of an instance field by means of invokedynamic.
static SetProperty	generateSetProperty(java.lang.String clazzDescriptor, java.lang.String property, java.lang.String typeDescriptor) Generates a SetProperty instance to modify the value of an instance field by means of invokedynamic.
static <T> T	generateStaticCallable(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<T> interfaceCallable) Generates an object to provide static method invocation using invokedynamic, passing the name of the method and class as parameters.
static <T> Callable<T>	generateStaticCallable(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature.
static <T> Callable<T>	generateStaticCallable(java.lang.Object object, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature.
static <T> Callable<T>	generateStaticCallable(java.lang.String clazzDescriptor, java.lang.String methodName, java.lang.Class<T> returnType, java.lang.Class<?>... parametersType) Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature.
static <T> T	generateStaticGetProperty(java.lang.Class<?> clazz, java.lang.String propertyName, java.lang.Class<T> interfaceCallable) Generates an object to obtain the value of an static field by means of invokedynamic.
static <T> GetProperty<T>	generateStaticGetProperty(java.lang.Object object, java.lang.String property, java.lang.Class<T> type) Generates a GetProperty instance to obtain the value of a static field by means of invokedynamic.
static <T> GetProperty<T>	generateStaticGetProperty(java.lang.String clazzDescriptor, java.lang.String property, java.lang.String typeDescriptor) Generates a GetProperty instance to obtain the value of a static field by means of invokedynamic.
static <T> T	generateStaticInvokeDynamic(Bootstrap bootstrap, java.lang.Class<T> interfaceCallable) Generates an object to provide static method invocation using invokedynamic, passing the bootstrap method as parameter.
static <T> T	generateStaticSetProperty(java.lang.Class<?> clazz, java.lang.String propertyName, java.lang.Class<T> interfaceCallable) Generates an object to modify the value of an static field by means of invokedynamic.
static SetProperty	generateStaticSetProperty(java.lang.Object object, java.lang.String property, java.lang.Class<?> type) Generates a SetProperty instance to modify the value of a static field by means of invokedynamic.
static SetProperty	generateStaticSetProperty(java.lang.String clazzDescriptor, java.lang.String property, java.lang.String typeDescriptor) Generates a SetProperty instance to modify the value of a static field by means of invokedynamic.
private static <T> Callable<T>	getCallable(java.lang.Class<?> clazz, java.lang.String name, java.lang.Class<?> rtype, java.lang.Class<?>[] parametersType, TypeModifier typeModifier) Returns a Callable object.
private static java.lang.Class<?>	getClassToDescriptor(java.lang.String descriptor) Returns an object whose type is represented by a type descriptor.
private static <T> GetProperty<T>	getGetProperty(java.lang.Class<?> clazz, java.lang.String name, java.lang.Class<?> type, TypeModifier typeModifier) Returns a GetProperty object.
private static <T> T	getInstance(MemberBIClass<T> member) Returns an object of type T.
private static <T> Callable<T>	getInvokedynamicCallable(Bootstrap bootstrap, MethodSignature methodSignature) Returns a Callable object.
private static <T> SetProperty	getSetProperty(java.lang.Class<?> clazz, java.lang.String name, java.lang.Class<?> type, TypeModifier typeModifier) Returns a SetProperty object.
static <T> T	invokeDynamic(Bootstrap bootstrap, MethodSignature methodSignature, java.lang.Object object, java.lang.Object... args) Performs dynamic invocations to methods, fields and constructors received as a parameter.

Methods inherited from class java.lang.Object

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

Field Detail

classDescriptor

private static java.util.HashMap<java.lang.String,java.lang.Class<?>> classDescriptor

invokedynamicClass

private static final java.util.HashMap<MemberBSClass<?>,Callable<?>> invokedynamicClass

memberMethod

private static final java.util.HashMap<MemberBIClass<?>,MemberBIClass<?>> memberMethod

fieldGetClass

private static final java.util.HashMap<java.lang.reflect.Field,GetProperty<?>> fieldGetClass

fieldSetClass

private static final java.util.HashMap<java.lang.reflect.Field,SetProperty> fieldSetClass

methodsClass

private static final java.util.HashMap<java.lang.reflect.Method,Callable<?>> methodsClass

memberClass

private static final java.util.HashMap<MemberClass<?>,Callable<?>> memberClass

constructorClass

private static final java.util.HashMap<ConstructorClass<?>,Constructor<?>> constructorClass

propertyGetClass

private static final java.util.HashMap<PropertyClass<?>,GetProperty<?>> propertyGetClass

propertySetClass

private static final java.util.HashMap<PropertyClass<?>,SetProperty> propertySetClass

Constructor Detail

ProxyFactory

public ProxyFactory()

Method Detail

invokeDynamic

public static final <T> T invokeDynamic(Bootstrap bootstrap,
                  MethodSignature methodSignature,
                  java.lang.Object object,
                  java.lang.Object... args)
                             throws java.lang.InstantiationException,
                                    java.lang.IllegalAccessException

Performs dynamic invocations to methods, fields and constructors received as a parameter. If the member to be invoked is static, object is ignored (null should be passed).

Parameters:

bootstrap - Bootstrap responsible for generating a bootstrap handle.

methodSignature - The signature of the method to be invoked.

object - Implicit object used to perform the dynamic invocation.

args - Arguments of the method invocation.

Returns:

The value of the dynamic invocation to a method, field or constructor, passing the indicated parameters.

Throws:

java.lang.ClassCastException - If the types of the actual arguments do not match the type of the formal parameters.

java.lang.NullPointerException - If object is null and the method to be invoked is an instance method.

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.InstantiationException - The class could not be instantiated.

java.lang.IllegalAccessException - If the class of the member to be invoked is not public.

See Also:

Bootstrap, MethodSignature

generateInvokeDynamicCallable

public static final <T> Callable<T> generateInvokeDynamicCallable(Bootstrap bootstrap,
                                            MethodSignature methodSignature)
                                                       throws java.lang.InstantiationException,
                                                              java.lang.IllegalAccessException

Generates a Callable instance to perform dynamic invocations to methods, fields and constructors received as a parameter.

Parameters:

bootstrap - Bootstrap responsible for generating a bootstrap handle.

methodSignature - The signature of the method to be invoked.

Returns:

A Callable instance to perform dynamic invocations to methods, fields and constructors.

Throws:

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.InstantiationException - The class could not be instantiated.

java.lang.IllegalAccessException

See Also:

Bootstrap, MethodSignature

generateStaticInvokeDynamic

public static final <T> T generateStaticInvokeDynamic(Bootstrap bootstrap,
                                java.lang.Class<T> interfaceCallable)
                                           throws java.lang.InstantiationException,
                                                  java.lang.IllegalAccessException

Generates an object to provide static method invocation using invokedynamic, passing the bootstrap method as parameter.
The generated object implements the interface passed as a parameter. That interface must contain one single method with the same signature of the one to be dynamically invoked. The method could be named with any identifier.
T must be the interface.

Parameters:

bootstrap - Bootstrap responsible for generating a bootstrap handle.

interfaceCallable - The interface with one single method.

Returns:

An object to provide static method invocation using invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.IllegalAccessException

See Also:

Bootstrap

generateInvokeDynamic

public static final <T> T generateInvokeDynamic(Bootstrap bootstrap,
                          java.lang.Class<T> interfaceCallable)
                                     throws java.lang.InstantiationException,
                                            java.lang.IllegalAccessException

Generates an object to provide instance method invocation using invokedynamic, passing the bootstrap method as parameter.
The generated object implements the interface passed as a parameter. That interface must contain one single method with the same signature of the one to be dynamically invoked. The method could be named with any identifier.
T must be the interface.

Parameters:

bootstrap - Bootstrap responsible for generating a bootstrap handle.

interfaceCallable - The interface with one single method.

Returns:

An object to provide instance method invocation using invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.IllegalAccessException

See Also:

Bootstrap

generateConstructor

public static final <T> Constructor<T> generateConstructor(java.lang.Class<T> clazz,
                                     java.lang.Class<?>... parameterstype)
                                                throws java.lang.InstantiationException

Generates a Constructor instance of the class and parameters passed as arguments. T is the type of the constructor class.

The following code dynamically invokes a constructor of the Counter class with no parameter:
Constructor<Counter> constructor = ProxyFactory.<Contructor<Counter>>generateConstructor(Counter.class);
Counter counter = constructor.newInstance();

Parameters:

clazz - The class we want to create a new instance of.

parameterstype - Type of the parameters of the constructor to be invoked.

Returns:

A constructor with the signature passed as a parameter.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateStaticCallable

public static final <T> Callable<T> generateStaticCallable(java.lang.Object object,
                                     java.lang.String methodName,
                                     java.lang.Class<T> returnType,
                                     java.lang.Class<?>... parametersType)
                                                throws java.lang.InstantiationException

Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature. T is the return type of the static method.

The following code shows how to dynamically invoke the static method concat of the Counter class. The method returns a String and receives two String as parameters:
Callable<String> callable = ProxyFactory.<Callable<String>>generateStaticCallable(counter,"concat",String.class, String.class,String.class);
String cad = callable.invoke(null,"Hello", "World");

Parameters:

object - Object of the class of the method to be invoked.

methodName - Name of the method to be invoked. It must be static.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to a static method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateCallable

public static final <T> Callable<T> generateCallable(java.lang.Object object,
                               java.lang.String methodName,
                               java.lang.Class<T> returnType,
                               java.lang.Class<?>... parametersType)
                                          throws java.lang.InstantiationException

Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature. T is the return type of the instance method.

The following code shows how to dynamically invoke the instance method increase of the Counter class. The method return a long and receives no parameters:
Callable<Long> callable = ProxyFactory.<Callable<Long>>generateCallable(counter,"increase", long.class);
long value = callable.invoke(counter);

Parameters:

object - Object of the class of the method to be invoked.

methodName - Name of the instance method to be invoked.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to an instance method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateStaticCallable

public static final <T> Callable<T> generateStaticCallable(java.lang.Class<?> clazz,
                                     java.lang.String methodName,
                                     java.lang.Class<T> returnType,
                                     java.lang.Class<?>... parametersType)
                                                throws java.lang.InstantiationException

Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature. T is the return type of the static method.

The following code shows how to dynamically invoke the static method concat of the Counter class. The method returns a String and receives two String as parameters:
Callable<String> callable = ProxyFactory.<Callable<String>>generateStaticCallable(Counter.class,"concat",String.class, String.class,String.class);
String cad = callable.invoke(null,"Hello", "World");

Parameters:

clazz - Class of the method to be invoked.

methodName - Name of the method to be invoked. It must be static.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to a static method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateCallable

public static final <T> Callable<T> generateCallable(java.lang.Class<?> clazz,
                               java.lang.String methodName,
                               java.lang.Class<T> returnType,
                               java.lang.Class<?>... parametersType)
                                          throws java.lang.InstantiationException

Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature. T is the return type of the static method.

The following code shows how to dynamically invoke the instance method increase of the Counter class. The method returns a long and receives no parameter:
Callable<Long> callable = ProxyFactory.<Callable<Long>>generateCallable(Counter.class,"increase", long.class);
long value = callable.invoke(counter);

Parameters:

clazz - Class of the method to be invoked.

methodName - Name of the instance method to be invoked.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to an instance method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateStaticCallable

public static final <T> Callable<T> generateStaticCallable(java.lang.String clazzDescriptor,
                                     java.lang.String methodName,
                                     java.lang.Class<T> returnType,
                                     java.lang.Class<?>... parametersType)
                                                throws java.lang.InstantiationException,
                                                       java.lang.ClassNotFoundException

Generates a Callable instance to perform dynamic invocations to a static method, indicating its signature. T is the return type of the static method.

The following code shows how to dynamically invoke the static method concat of the Counter class. The method returns a String and receives two String as parameters:
Callable<String> callable = ProxyFactory.<Callable<String>>generateStaticCallable("paquete.Counter","concat",String.class, String.class,String.class);
String cad = callable.invoke(null,"Hello", "World");

Parameters:

clazzDescriptor - Class descriptor of the method to be invoked.

methodName - Name of the method to be invoked. It must be static.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to a static method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateCallable

public static <T> Callable<T> generateCallable(java.lang.String clazzDescriptor,
                               java.lang.String methodName,
                               java.lang.Class<T> returnType,
                               java.lang.Class<?>... parametersType)
                                    throws java.lang.InstantiationException,
                                           java.lang.ClassNotFoundException

Generates a Callable instance to perform dynamic invocations to an instance method, indicating its signature. T is the return type of the instance method.

The following code shows how to dynamically invoke the instance method increase of the Counter class. The method returns a long and receives no parameter
Callable<Long> callable = ProxyFactory.<Callable<Long>>generateCallable("paquete.Counter","increase", long.class);
long value = callable.invoke(counter);

Parameters:

clazzDescriptor - Class descriptor of the method to be invoked.

methodName - Name of the method to be invoked. It must be an instance method.

returnType - The return type of the method to be invoked.

parametersType - Type of the parameters of the method to be invoked.

Returns:

A Callable to perform dynamic invocations to an instance method, indicating its signature.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateCallable

public static final <T> Callable<T> generateCallable(java.lang.reflect.Method method)
                                          throws java.lang.InstantiationException

Generates a Callable instance to perform dynamic invocations to an instance method, indicating a Method instance. T is the return type of the instance method.

The following code shows how to dynamically invoke the method represented by the method Method:
Callable<T> callable = ProxyFactory.generateCallable(method);
Object value = callable.invoke(counter);

Parameters:

method - An instance of Method representing the method to be invoked.

Returns:

A Callable instance to perform dynamic invocations to an instance method.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticGetProperty

public static final <T> GetProperty<T> generateStaticGetProperty(java.lang.Object object,
                                           java.lang.String property,
                                           java.lang.Class<T> type)
                                                      throws java.lang.InstantiationException

Generates a GetProperty instance to obtain the value of a static field by means of invokedynamic. T is the type of the field.

The following code shows how to obtain the STATIC_COUNTER static field of the Counter class, whose type is long:
GetProperty<Long> getProperty = ProxyFactory.<GetProperty<Long>>generateStaticGetProperty(counter,"STATIC_COUNTER", long.class);
long value = getProperty.get(null);

Parameters:

object - The object of the class the property belongs to.

property - Name of the static property to be invoked.

type - Type of the static property to be invoked.

Returns:

A GetProperty instance to obtain the value of a static field by means of invokedynamic

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - If no method with the appropriate signature belongs to the class.

generateGetProperty

public static final <T> GetProperty<T> generateGetProperty(java.lang.Object object,
                                     java.lang.String property,
                                     java.lang.Class<T> type)
                                                throws java.lang.InstantiationException

Generates a GetProperty instance to obtain the value of an instance field by means of invokedynamic. T is the type of the field.

The following code shows how to obtain the instance_counter field of the Counter class, whose type is long:
GetProperty<Long> getProperty = ProxyFactory.<GetProperty<Long>>generateGetProperty(counter,"instance_counter", long.class);
long value = getProperty.get(counter);

Parameters:

object - The object of the class the property belongs to.

property - Name of the instance property to be invoked.

type - Type of the static property to be invoked.

Returns:

A GetProperty instance to obtain the value of an instance field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

generateStaticGetProperty

public static final <T> GetProperty<T> generateStaticGetProperty(java.lang.String clazzDescriptor,
                                           java.lang.String property,
                                           java.lang.String typeDescriptor)
                                                      throws java.lang.InstantiationException,
                                                             java.lang.ClassNotFoundException

Generates a GetProperty instance to obtain the value of a static field by means of invokedynamic. T is the type of the field.

The following code shows how to obtain the STATIC_COUNTER static field of the Counter class, whose type is Long: GetProperty<Long> getProperty = ProxyFactory.<GetProperty<Long>>generateStaticGetProperty("paquete.Counter","STATIC_COUNTER", "java.lang.Long");
long value = getProperty.get(null);

Parameters:

clazzDescriptor - Descriptor of the class the property belongs to.

property - Name of the static property to be invoked.

typeDescriptor - Descriptor of the type of the static property to be invoked.

Returns:

A GetProperty instance to obtain the value of a static field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateGetProperty

public static <T> GetProperty<T> generateGetProperty(java.lang.String clazzDescriptor,
                                     java.lang.String property,
                                     java.lang.String typeDescriptor)
                                          throws java.lang.InstantiationException,
                                                 java.lang.ClassNotFoundException

Generates a GetProperty instance to obtain the value of an instance field by means of invokedynamic. T is the type of the field.

The following code shows how to obtain the instance_counter field of the Counter class, whose type is Long:
GetProperty<Long> getProperty = ProxyFactory.<GetProperty<Long>>generateGetProperty("paquete.Counter","instance_counter", "java.lang.Long");
long value = getProperty.get(counter);

Parameters:

clazzDescriptor - Descriptor of the class the property belongs to.

property - Name of the instance property to be invoked.

typeDescriptor - Descriptor or the type of the static property to be invoked.

Returns:

A GetProperty instance to obtain the value of an instance field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.NoSuchMethodException - There is no method with the specified signature.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateGetProperty

public static final <T> GetProperty<T> generateGetProperty(java.lang.reflect.Field field)
                                                throws java.lang.InstantiationException

Generates a GetProperty instance to obtain the value of a Field by means of invokedynamic. T is the type of the field.
The following code shows how to obtain the value of a filed using the appropriate Field:
GetProperty<?> getProperty = ProxyFactory.generateGetProperty(field);
Object value = getProperty.get(counter);

Parameters:

field - Objeto de la clase Field que representa la propiedad a invocar.

Returns:

A GetProperty instance to obtain the value of a Field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticSetProperty

public static final SetProperty generateStaticSetProperty(java.lang.Object object,
                                    java.lang.String property,
                                    java.lang.Class<?> type)
                                                   throws java.lang.InstantiationException

Generates a SetProperty instance to modify the value of a static field by means of invokedynamic.

The following code shows how to modify the value of the STATIC_COUNTER static field of the Counter class, whose type is long:
SetProperty setProperty = ProxyFactory.<SetProperty>generateStaticSetProperty(counter,"STATIC_COUNTER", long.class);
setProperty.set(null,newValue);

Parameters:

object - Object of the class the property belongs to.

property - Name of the static property to be invoked.

type - Type of the static property to be invoked.

Returns:

A SetProperty instance to modify the value of a static field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateSetProperty

public static final SetProperty generateSetProperty(java.lang.Object object,
                              java.lang.String property,
                              java.lang.Class<?> type)
                                             throws java.lang.InstantiationException

Generates a SetProperty instance to modify the value of an instance field by means of invokedynamic.

The following code shows how to modify the value of the instance_counter field of the Counter class, whose type is long:
SetProperty setProperty = ProxyFactory.<SetProperty>generateSetProperty(counter,"instance_counter", long.class);
setProperty.set(counter,newValue);

Parameters:

object - Object of the class the property belongs to.

property - Name of the instance property to be invoked.

type - Type of the static property to be invoked.

Returns:

A SetProperty instance to modify the value of an instance field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticSetProperty

public static final SetProperty generateStaticSetProperty(java.lang.String clazzDescriptor,
                                    java.lang.String property,
                                    java.lang.String typeDescriptor)
                                                   throws java.lang.InstantiationException,
                                                          java.lang.ClassNotFoundException

Generates a SetProperty instance to modify the value of a static field by means of invokedynamic.

The following code shows how to modify the value of the STATIC_COUNTER static field of the Counter class, whose type is Long:
SetProperty setProperty = ProxyFactory.<SetProperty>generateStaticSetProperty("paquete.Counter","STATIC_COUNTER", "java.lang.Long");
setProperty.set(null,newValue);

Parameters:

clazzDescriptor - Descriptor of the class the property belongs to.

property - Name of the static property to be invoked.

typeDescriptor - Type of the static property to be invoked.

Returns:

A SetProperty instance to modify the value of a static field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateSetProperty

public static SetProperty generateSetProperty(java.lang.String clazzDescriptor,
                              java.lang.String property,
                              java.lang.String typeDescriptor)
                                       throws java.lang.InstantiationException,
                                              java.lang.ClassNotFoundException

Generates a SetProperty instance to modify the value of an instance field by means of invokedynamic.

The following code shows how to modify the value of the instance_counter field of the Counter class, whose type is Long:
SetProperty setProperty = ProxyFactory.<SetProperty>generateSetProperty("paquete.Counter","instance_counter", "java.lang.Long");
setProperty.set(counter,newValue);

Parameters:

clazzDescriptor - Descriptor of the class the property belongs to.

property - Name of the instance property to be invoked.

typeDescriptor - Type of the static property to be invoked.

Returns:

A SetProperty instance to modify the value of an instance field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.

generateSetProperty

public static final SetProperty generateSetProperty(java.lang.reflect.Field field)
                                             throws java.lang.InstantiationException

Generates a SetProperty instance to modify the value of a Field by means of invokedynamic. T is the type of the field.
The following code shows how to modify the value of a filed using the appropriate Field
SetProperty setProperty = ProxyFactory.<SetProperty>generateSetProperty(field);
setProperty.set(counter, newValue);

Parameters:

field - A Field instance representing que the field whose value is going to be modified.

Returns:

A SetProperty instance to modify the value of a Field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateCallable

public static final <T> T generateCallable(java.lang.Class<?> clazz,
                     java.lang.String methodName,
                     java.lang.Class<T> interfaceCallable)
                                throws java.lang.InstantiationException

Generates an object to provide instance method invocation using invokedynamic, passing the name of the method and class as parameters.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have the same return type of method to invoke, the first parameter must be the method class, then put the other parameters of the method. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and invoke its method using invokedynamic.
We want to invoke the increase instance method in the Counter class. This method returns a long and receives no parameter. We create the following interface:
public interface CallablelongCounter{
public long invoke(Counter counter);
}

Then, we generate the Callable instance:
CallablelongCounter callable = ProxyFactory.<CallablelongCounter> generateCallable(Counter.class, "increase", CallablelongCounter.class);
And the method is invoked with invokedynamic:
long value = callable.invoke(counter);

Parameters:

clazz - Class of the method to be invoked.

methodName - Name of the method to be invoked. It must be an instance method.

interfaceCallable - The interface with one single method.

Returns:

An object to provide instance method invocation using invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticCallable

public static final <T> T generateStaticCallable(java.lang.Class<?> clazz,
                           java.lang.String methodName,
                           java.lang.Class<T> interfaceCallable)
                                      throws java.lang.InstantiationException

Generates an object to provide static method invocation using invokedynamic, passing the name of the method and class as parameters.
The generated object implements the interface passed as a parameter. That interface must contain one single method with the same signature of the one to be dynamically invoked. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and invoke its method using invokedynamic.
We want to invoke the concat static method in the Counter class. This method returns a String and receives two String parameter. We create the following interface:
public interface CallableString2String{
public String invoke(String cad1, String cad2);
}

Then, the Callable is generated:
CallableString2String callable = ProxyFactory.<CallableString2String> generateStaticCallable(Counter.class, "concat", CallableString2String.class);
And the method can be dynamically invoked:
String cad = callable.invoke("Hello", "World");

Parameters:

clazz - Class of the method to be invoked.

methodName - Name of the method to be invoked. It must be an static method.

interfaceCallable - The interface with one single method.

Returns:

An object to provide static method invocation using invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateGetProperty

public static final <T> T generateGetProperty(java.lang.Class<?> clazz,
                        java.lang.String propertyName,
                        java.lang.Class<T> interfaceCallable)
                                   throws java.lang.InstantiationException

Generates an object to obtain the value of an instance field by means of invokedynamic.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have the same return type of field and the property class as the only parameter. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and obtain the value of an instance field by means of invokedynamic.
We want to the value of instance_concat a instance field in the Counter class with long type. We create the following interface:
public interface CallablelongCounter{
public long invoke(Counter counter);
}

Then, the Callable is generated:
CallablelongCounter callable = ProxyFactory.<CallablelongCounter> generateGetProperty(Counter.class, "instance_concat", CallablelongCounter.class);
And the field can be dynamically invoked:
long value = callable.invoke(counter);

Parameters:

clazz - Class of the field to be invoked.

propertyName - Name of the instance field to be invoked.

interfaceCallable - The interface with one single method.

Returns:

An object to obtain the value field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticGetProperty

public static final <T> T generateStaticGetProperty(java.lang.Class<?> clazz,
                              java.lang.String propertyName,
                              java.lang.Class<T> interfaceCallable)
                                         throws java.lang.InstantiationException

Generates an object to obtain the value of an static field by means of invokedynamic.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have the same return type of field and not have any parameters. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and obtain the value of an static field by means of invokedynamic.
We want to the value of STATIC_COUNTER a static field in the Counter class with long type. We create the following interface:
public interface Callablelong{
public long invoke();
}

Then, the Callable is generated:
Callablelong callable = ProxyFactory.<Callablelong> generateStaticGetProperty(Counter.class, "STATIC_COUNTER", Callablelong.class);
And the field can be dynamically invoked:
long value = callable.invoke();

Parameters:

clazz - Class of the field to be invoked.

propertyName - Name of the static field to be invoked.

interfaceCallable - The interface with one single method.

Returns:

An object to obtain the value field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateSetProperty

public static final <T> T generateSetProperty(java.lang.Class<?> clazz,
                        java.lang.String propertyName,
                        java.lang.Class<T> interfaceCallable)
                                   throws java.lang.InstantiationException

Generates an object to modify the value of an instance field by means of invokedynamic.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have a void return type, the property class as the first parameter and the second parameter is the field type. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and modify the value of an instance field by means of invokedynamic
We want to modify the value of instance_concat a instance field in the Counter class with long type. We create the following interface:
public interface CallablevoidCounterlong{
public void invoke(Counter counter, long newValue);
}

Then, the Callable is generated:
CallablevoidCounterlong callable = ProxyFactory.<CallablevoidCounterlong> generateSetProperty(Counter.class, "instance_concat", CallablevoidCounterlong.class);
And the field can be dynamically invoked:
callable.invoke(counter,newValue);

Parameters:

clazz - Class of the field to be invoked.

propertyName - Name of the instance field to be invoked.

interfaceCallable - The interface with one single method.

Returns:

An object to modify the value of an instance field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateStaticSetProperty

public static final <T> T generateStaticSetProperty(java.lang.Class<?> clazz,
                              java.lang.String propertyName,
                              java.lang.Class<T> interfaceCallable)
                                         throws java.lang.InstantiationException

Generates an object to modify the value of an static field by means of invokedynamic.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have a void return type, and the field type as a only parameter. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and modify the value of an static field by means of invokedynamic
We want to modify the value of STATIC_COUNTER a static field in the Counter class with long type. We create the following interface:
public interface Callablevoidlong{
public void invoke(long newValue);
}

Then, the Callable is generated:
Callablevoidlong callable = ProxyFactory.<Callablevoidlong> generateStaticSetProperty(Counter.class, "STATIC_COUNTER", Callablevoidlong.class);
And the field can be dynamically invoked:
callable.invoke(newValue);

Parameters:

clazz - Class of the field to be invoked.

propertyName - Name of the static field to be invoked.

interfaceCallable - The interface with one single method.

Returns:

An object to modify the value of an static field by means of invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

generateConstructor

public static final <T> T generateConstructor(java.lang.Class<?> clazz,
                        java.lang.Class<T> interfaceCallable)
                                   throws java.lang.InstantiationException

Generates an object to provide a constructor invocation using invokedynamic.
The generated object implements the interface passed as a parameter. That interface must contain one single method. The method of the interface must have the type class to return type and as parameters, the arguments of the constructor to invoke. The method could be named with any identifier.
T must be the interface.

The next example shows how to declare an interface and dynamically invokes a constructor
we want to create a new instance of Counter class and invoke a constructor with a long type parameter. We create the following interface:
public interface CallableCounterlong{
public Counter invoke(long value);
}

Then, the Callable is generated:
CallableCounterlong callable = ProxyFactory.<CallableCounterlong> generateConstructor(Counter.class, CallableCounterlong.class);
And the method can be dynamically invoked:
Counter counter = callable.invoke(value);

Parameters:

clazz - Class of the constructor to be invoked.

interfaceCallable - The interface with one single method.

Returns:

An object to provide a constructor invocation using invokedynamic.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getSetProperty

private static <T> SetProperty getSetProperty(java.lang.Class<?> clazz,
                             java.lang.String name,
                             java.lang.Class<?> type,
                             TypeModifier typeModifier)
                                   throws java.lang.InstantiationException

Returns a SetProperty object. If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

clazz - Class the property belongs to.

name - Name of the property.

type - Type of the property.

typeModifier - Indicates if the member is instance or class (static).

Returns:

A SetProperty object.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getCallable

private static <T> Callable<T> getCallable(java.lang.Class<?> clazz,
                          java.lang.String name,
                          java.lang.Class<?> rtype,
                          java.lang.Class<?>[] parametersType,
                          TypeModifier typeModifier)
                                throws java.lang.InstantiationException

Returns a Callable object. If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

clazz - Class the method belongs to.

name - Name of the method.

rtype - Return type of the method

parametersType - Type of the parameters of the method.

typeModifier - Indicates if the member is instance or class (static).

Returns:

A Callable instance.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getInvokedynamicCallable

private static <T> Callable<T> getInvokedynamicCallable(Bootstrap bootstrap,
                                       MethodSignature methodSignature)
                                             throws java.lang.InstantiationException

Returns a Callable object. If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

bootstrap - responsible for generating the Handle used to invoke the appropriate bootstrap class.

methodSignature - The signature of the method to be invoked.

Returns:

A Callable instance.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getGetProperty

private static <T> GetProperty<T> getGetProperty(java.lang.Class<?> clazz,
                                java.lang.String name,
                                java.lang.Class<?> type,
                                TypeModifier typeModifier)
                                      throws java.lang.InstantiationException

Returns a GetProperty object. If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

clazz - Class the field belongs to.

name - Name of the property.

type - Type of the property.

typeModifier - Indicates if the member is instance or class (static).

Returns:

A GetProperty instance.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getInstance

private static <T> T getInstance(MemberBIClass<T> member)
                      throws java.lang.InstantiationException

Returns an object of type T. T is an interface that will be used in the dynamic invocation. . If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

member - Represent a bootstrap and an interface.

Returns:

Returns an object of type T.

Throws:

java.lang.InstantiationException - If the class could not be instantiated.

getClassToDescriptor

private static final java.lang.Class<?> getClassToDescriptor(java.lang.String descriptor)
                                                      throws java.lang.ClassNotFoundException

Returns an object whose type is represented by a type descriptor. If the object is in the internal cache, it is then returned. Otherwise, it is first created, then stored and finally returned.

Parameters:

descriptor - The class descriptor.

Returns:

Returns an class whose type is represented by a type descriptor.

Throws:

java.lang.ClassNotFoundException - If the class specified by the descriptor cannot be found.