Package caseine.reflect

Class ReflectUtilities

java.lang.Object

caseine.reflect.ReflectUtilities

public class ReflectUtilities
extends Object

Classe utilitaires offrant de nombreuses méthodes introspectives utiles

Author:

Yvan Maillot <yvan.maillot@uha.fr>

Constructor Summary

Constructors

Constructor	Description
ReflectUtilities()

Method Summary

Modifier and Type	Method	Description
static boolean	allParametersArePrimitive(Constructor<?> c)
static Object	clone(Object o)
static Object	clone(Object o1, Class<?> c2)
static boolean	equals(Object o1, Object o2)	Egalité de deux objets non nécessairement de mêmes types.
static Object[]	fillParametersArray(Executable k)
static <T> T	get(Class<T> c, Object... pv)
static <T> T	get(String className, Object... pv)
static Object	getAttribut(Class<?> c, Object o, String nom)
static Class<?>	getDeclaredClass(Class<?> c, String name)
static Object	getFromMethod(Class<?> c, Object o, String methodName, Object... pv)	Retourne par introspection le résultat de l'invocation d'une méthode avec ses arguments.
static Object	getFromMethod(String className, Object o, String methodName, Object... pv)
static Object	getFromMethodTA(Class<?> c, Object o, String methodName, Object... pv)	Retourne par introspection le résultat de l'invocation d'une méthode avec ses arguments.
static Object	getFromMethodTA(String className, Object o, String methodName, Object... pv)
static String	getFromMethodTASystemInOut(Class<?> c, Object o, String methodName, String sin, Object... pv)	Retourne dans une chaine de caractères le résultat à l'écran de l'invocation d'une méthode avec ses arguments.
static String	getFromMethodTASystemOut(Class<?> c, Object o, String methodName, Object... pv)	Retourne dans une chaine de caractères le résultat à l'écran de l'invocation d'une méthode avec ses arguments.
static Constructor<?>	getOneConstructor(Class<?> c)
static Constructor<?>	getOneSimpleConstructor(Class<?> c)	Retourne le premier constructeur contenant que des paramètres simples.
static <T> T	getTA(Class<T> c, Object... pv)
static <T> T	getTA(String className, Object... pv)
static boolean	isCheckedException(Class<?> crt)	Retourne vrai l'objet de classe donné en paramètre est une exception contrôlée, faux si c'est une exception non contrôlée.
static boolean	isCheckedException(Throwable cause)
static boolean	isMutable(Class<?> C)
static String	paramsToString(Executable m)
static String	paramsToStringClass(Executable m)
static Class<?>	parseType(String className)
static int	randomInt(int min, int max)
static int	randomInt(int min, int max, boolean notNul)
static Object	randomValue(Class<?> c)
static Object	randomValue(Class<?> c, Class<?>... p)
static Object	randomValue(Class<?> c, Object... p)
static boolean	sameResult(boolean checkStdOut, StringBuilder msg, Class<?> c1, Class<?> c2, String methodName, Class<?>... parameterTypes)
static boolean	sameResult(StringBuilder msg, Class<?> c1, Class<?> c2, String methodName, Class<?>... parameterTypes)
static void	setAttribut(Class<?> c, Object o, String nom, Object v)	Met à jour la valeur d'un attribut d'un object donné
static String	writePreviousUnitTestCalling(TreeMap<String,StringBuilder> msb, String[] priorities)

Methods inherited from class java.lang.Object

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

Constructor Details

ReflectUtilities

public ReflectUtilities()

Method Details

getTA

public static <T> T getTA(Class<T> c,
 Object... pv)
                   throws NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

getTA

public static <T> T getTA(String className,
 Object... pv)
                   throws ClassNotFoundException,
NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

ClassNotFoundException

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

get

public static <T> T get(Class<T> c,
 Object... pv)
                 throws NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

get

public static <T> T get(String className,
 Object... pv)
                 throws NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
ClassNotFoundException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

ClassNotFoundException

getFromMethodTA

public static Object getFromMethodTA(Class<?> c,
 Object o,
 String methodName,
 Object... pv)
                              throws NoSuchMethodException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Retourne par introspection le résultat de l'invocation d'une méthode avec ses arguments.

Parameters:

c - la classe à laquelle la méthode appartient.

o - l'objet sur lequel s'application la méthode (peut-être null dans le cas d'une méthode static)

methodName - le nom de la méthode

pv - une liste de couples (type et sa valeur)

Returns:

le résultat de l'invocation

Throws:

NoSuchMethodException - la méthode n'existe pas

IllegalAccessException - accès interdit

IllegalArgumentException - les types arguments de ne correspondent pas

InvocationTargetException - l'invocation de la méthode a engendré une exception

getFromMethodTA

public static Object getFromMethodTA(String className,
 Object o,
 String methodName,
 Object... pv)
                              throws ClassNotFoundException,
NoSuchMethodException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

ClassNotFoundException

NoSuchMethodException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

getFromMethod

public static Object getFromMethod(Class<?> c,
 Object o,
 String methodName,
 Object... pv)
                            throws NoSuchMethodException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Retourne par introspection le résultat de l'invocation d'une méthode avec ses arguments.

Parameters:

c - la classe à laquelle la méthode appartient

o - l'objet sur lequel s'application la méthode

methodName - le nom de la méthode

pv - une liste de valeurs (dont les types sont déduits)

Returns:

le résultat de l'invocation

Throws:

NoSuchMethodException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

getFromMethod

public static Object getFromMethod(String className,
 Object o,
 String methodName,
 Object... pv)
                            throws NoSuchMethodException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
ClassNotFoundException

Throws:

NoSuchMethodException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

ClassNotFoundException

getFromMethodTASystemOut

public static String getFromMethodTASystemOut(Class<?> c,
 Object o,
 String methodName,
 Object... pv)
                                       throws FileNotFoundException,
IOException,
NoSuchMethodException,
IllegalAccessException,
InvocationTargetException

Retourne dans une chaine de caractères le résultat à l'écran de l'invocation d'une méthode avec ses arguments.

Parameters:

c - la classe à laquelle la méthode appartient

o - l'objet sur lequel s'application la méthode

methodName - le nom de la méthode

pv - une liste de couples (type et sa valeur)

Returns:

le résultat de l'invocation

Throws:

FileNotFoundException

IOException

NoSuchMethodException

IllegalAccessException

InvocationTargetException

getFromMethodTASystemInOut

public static String getFromMethodTASystemInOut(Class<?> c,
 Object o,
 String methodName,
 String sin,
 Object... pv)
                                         throws FileNotFoundException,
IOException,
NoSuchMethodException,
IllegalAccessException,
InvocationTargetException

Retourne dans une chaine de caractères le résultat à l'écran de l'invocation d'une méthode avec ses arguments.

Parameters:

c - la classe à laquelle la méthode appartient

o - l'objet sur lequel s'application la méthode

methodName - le nom de la méthode

sin - String à envoyer dans l'entrée standard

pv - une liste de couples (type et sa valeur)

Returns:

le résultat de l'invocation

Throws:

FileNotFoundException

IOException

NoSuchMethodException

IllegalAccessException

InvocationTargetException

setAttribut

public static void setAttribut(Class<?> c,
 Object o,
 String nom,
 Object v)
                        throws NoSuchFieldException,
IllegalArgumentException,
IllegalAccessException

Met à jour la valeur d'un attribut d'un object donné

Parameters:

c - l'objet de classe de l'objet donné

o - l'objet donné

nom - le nom de l'attribut

v - la valeur à affecter à cet attribut

Throws:

NoSuchFieldException

IllegalArgumentException

IllegalAccessException

getAttribut

public static Object getAttribut(Class<?> c,
 Object o,
 String nom)
                          throws NoSuchFieldException,
IllegalArgumentException,
IllegalAccessException

Throws:

NoSuchFieldException

IllegalArgumentException

IllegalAccessException

isMutable

public static boolean isMutable(Class<?> C)

clone

public static Object clone(Object o1,
 Class<?> c2)
                    throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException,
NoSuchFieldException

Throws:

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

NoSuchMethodException

NoSuchFieldException

clone

public static Object clone(Object o)
                    throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

NoSuchMethodException

equals

public static boolean equals(Object o1,
 Object o2)
                      throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException

Egalité de deux objets non nécessairement de mêmes types.

Deux objets o1 et o2 sont considérés égaux (au sens défini ICI) si

1. ils sont des wrappers de type simple ET o1.equals(o2)
2. OU ils sont de même type ET ils redéfissent Object::equals(Object) ET o1.equals(o2)
3. OU
   1. leur type ont le même nom (simple)
   2. ET leurs attributs non statique ont les mêmes noms et sont égaux entre eux (au sens défini ICI)

Parameters:

o1 - à comparer avec o2

o2 - à comparer avec o1

Returns:

vrai si o1 est égal à o2 au sens défini ICI

Throws:

InstantiationException - problème

IllegalAccessException - problème

IllegalArgumentException - problème

InvocationTargetException - problème

NoSuchMethodException - problème

allParametersArePrimitive

public static boolean allParametersArePrimitive(Constructor<?> c)

getOneConstructor

public static Constructor<?> getOneConstructor(Class<?> c)

getOneSimpleConstructor

public static Constructor<?> getOneSimpleConstructor(Class<?> c)
                                              throws NoSimpleConstructor

Retourne le premier constructeur contenant que des paramètres simples. Les constructeurs publiques sont cherchés en premier Si le constructeur retourné est non-public, alors il est rendu accessible.

Parameters:

c - le type de classe dont on veut un constructeur

Returns:

un constructeur

Throws:

NoSimpleConstructor - aucun constructeur trouvé

fillParametersArray

public static Object[] fillParametersArray(Executable k)
                                    throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

NoSuchMethodException

randomInt

public static int randomInt(int min,
 int max,
 boolean notNul)

randomInt

public static int randomInt(int min,
 int max)

randomValue

public static Object randomValue(Class<?> c,
 Object... p)
                          throws NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

randomValue

public static Object randomValue(Class<?> c,
 Class<?>... p)
                          throws NoSuchMethodException,
InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

randomValue

public static Object randomValue(Class<?> c)
                          throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

NoSuchMethodException

isCheckedException

public static boolean isCheckedException(Class<?> crt)
                                  throws IllegalArgumentException

Retourne vrai l'objet de classe donné en paramètre est une exception contrôlée, faux si c'est une exception non contrôlée.

Parameters:

crt - l'exception dont on veut connaître la nature

Returns:

vrai si crt est une exception contrôlée, faux si crt est une exception non contrôlée

Throws:

IllegalArgumentException - si crt n'est pas une exception

isCheckedException

public static boolean isCheckedException(Throwable cause)

sameResult

public static boolean sameResult(StringBuilder msg,
 Class<?> c1,
 Class<?> c2,
 String methodName,
 Class<?>... parameterTypes)
                          throws NoSuchMethodException,
IllegalArgumentException,
IllegalAccessException,
InvocationTargetException,
InstantiationException,
NoSuchFieldException

Throws:

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

InstantiationException

NoSuchFieldException

sameResult

public static boolean sameResult(boolean checkStdOut,
 StringBuilder msg,
 Class<?> c1,
 Class<?> c2,
 String methodName,
 Class<?>... parameterTypes)
                          throws NoSuchMethodException,
IllegalArgumentException,
IllegalAccessException,
InvocationTargetException,
InstantiationException,
NoSuchFieldException

Throws:

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

InstantiationException

NoSuchFieldException

parseType

public static Class<?> parseType(String className)
                          throws ClassNotFoundException

Throws:

ClassNotFoundException

getDeclaredClass

public static Class<?> getDeclaredClass(Class<?> c,
 String name)

paramsToStringClass

public static String paramsToStringClass(Executable m)

paramsToString

public static String paramsToString(Executable m)

writePreviousUnitTestCalling

public static String writePreviousUnitTestCalling(TreeMap<String,StringBuilder> msb,
 String[] priorities)