ObjectUtil (Nuiton Utils 3.1-rc-1 API)

java.lang.Object
- org.nuiton.util.ObjectUtil

```
public class ObjectUtil
extends Object
```
Outils pour manipuler des objets. Création d'un objet à partir d'une chaîne le décrivant, conversion d'un objet en Object, récupération de méthodes à partir de leur nom, de constructeurs à partir de leurs paramètres... Created: 4 novembre 2004

Author:

Benjamin Poussin - poussin@codelutin.com

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CLASS_METHOD_SEPARATOR` Used to know what is separator between class and method
`protected static Integer`	`ZERO`
`protected static Byte`	`ZEROB`
`protected static Character`	`ZEROC`
`protected static Double`	`ZEROD`
`protected static Float`	`ZEROF`
`protected static Long`	`ZEROL`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Object`	`call(Object o, Method m, String... params)` Call method m with params as String.
`protected static Object`	`choiceArgument(Class<?> clazz, List args, boolean nullIfMissing)` Permet de matcher un type d'argument attendu clazz parmi un ensemble possible de candidat.
`static <E extends Cloneable> E`	`clone(E e)` Clone object by introspection because Cloneable interface don't permit to call clone :(.
`protected static Object`	`convert(String v, Class<?> clazz)`
`static Object`	`create(String classnameAndProperties)` Create new object from string like org.nuiton.Toto(name=machine, int=10) where machine and int is properties on org.nuiton.Toto object.
`static <E> E`	`deepClone(E e)` Use serialization/deserialization to do deep clone of object
`static <T> List<Constructor<T>>`	`getConstructor(Class<T> clazz, int paramNumber)` Get all constructors that support paramNumber as parameters numbers.
`static List<Method>`	`getMethod(Class<?> clazz, String methodName, boolean ignoreCase)` Get all methods with name given in argument without check parameters.
`static List<Method>`	`getMethod(String name, boolean ignoreCase)` List method that match name, name must be [package.]
`static boolean`	`isNullValue(boolean value)`
`static boolean`	`isNullValue(byte value)`
`static boolean`	`isNullValue(char value)`
`static boolean`	`isNullValue(double value)`
`static boolean`	`isNullValue(float value)`
`static boolean`	`isNullValue(int value)`
`static boolean`	`isNullValue(Object value)` Tests if the given value is null according to default value for primitive types if nedded.
`static boolean`	`isPrimitive(Class<?> clazz)` Verifie si la classe est de type primitif.
`static <E> E`	`newInstance(Class<E> clazz, Collection<?> args, boolean nullIfMissing)` Invoke constructor on clazz to create new instance.
`static <T> T`	`newInstance(Class<T> clazz, String... params)` Create new instance of clazz, call constructor with params as String.
`static Object`	`newInstance(String constructorWithParams)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CLASS_METHOD_SEPARATOR
```
public static final String CLASS_METHOD_SEPARATOR
```
    Used to know what is separator between class and method
    
    See Also:
    
    Constant Field Values
  - ZERO
```
protected static final Integer ZERO
```
  - ZEROC
```
protected static final Character ZEROC
```
  - ZEROF
```
protected static final Float ZEROF
```
  - ZEROL
```
protected static final Long ZEROL
```
  - ZEROD
```
protected static final Double ZEROD
```
  - ZEROB
```
protected static final Byte ZEROB
```
- Method Detail
  - newInstance
```
public static <E> E newInstance(Class<E> clazz,
                                Collection<?> args,
                                boolean nullIfMissing)
```
    Invoke constructor on clazz to create new instance. Try to find argument for constructor in args parameter.
    
    Type Parameters:
    
    E - FIXME
    
    Parameters:
    
    clazz - class of object to instanciate
    
    args - all possible parameter that constructor can used
    
    nullIfMissing - if no suitable class or object found in args, use null value (no exception)
    
    Returns:
    
    new instance
    
    Throws:
    
    IllegalArgumentException - if something is wrong during instanciation
  - choiceArgument
```
protected static Object choiceArgument(Class<?> clazz,
                                       List args,
                                       boolean nullIfMissing)
```
    Permet de matcher un type d'argument attendu clazz parmi un ensemble possible de candidat. Les candidats peuvent etre des classes qu'il faudra instancier pour satisfaire le type demande.
    
    Parameters:
    
    clazz - le type recherché
    
    args - la liste des arguments ou des types
    
    nullIfMissing - pour retourner nulle si l'argument n'est pas trouvé
    
    Returns:
    
    le type d'argument trouvé
  - create
```
public static Object create(String classnameAndProperties)
                     throws ClassNotFoundException,
                            InstantiationException,
                            IllegalAccessException,
                            InvocationTargetException,
                            NoSuchMethodException
```
    Create new object from string like org.nuiton.Toto(name=machine, int=10) where machine and int is properties on org.nuiton.Toto object. Conversion between 10 in string and 10 as integer as automaticaly done For String property you can use ex:
    - name="my string with , in string"
    - name='my string with , in string'
    Parameters:
    
    classnameAndProperties - FIXME
    
    Returns:
    
    the instanciated object FIXME
    
    Throws:
    
    ClassNotFoundException - FIXME
    
    IllegalAccessException - FIXME
    
    InstantiationException - FIXME
    
    NoSuchMethodException - FIXME
    
    InvocationTargetException - FIXME
  - convert
```
protected static Object convert(String v,
                                Class<?> clazz)
```
  - clone
```
public static <E extends Cloneable> E clone(E e)
                                     throws CloneNotSupportedException
```
    Clone object by introspection because Cloneable interface don't permit to call clone :(. This methode replace next code that don't work :(
```
 if (o instanceof Cloneable) {
   Object n = ((Cloneable)o).clone();
 }
 
```
    Type Parameters:
    
    E - FIXME
    
    Parameters:
    
    e - object to clone
    
    Returns:
    
    new instance of E
    
    Throws:
    
    CloneNotSupportedException - if some error occur during clone
  - deepClone
```
public static <E> E deepClone(E e)
                       throws CloneNotSupportedException
```
    Use serialization/deserialization to do deep clone of object
    
    Type Parameters:
    
    E - FIXME
    
    Parameters:
    
    e - object to clone
    
    Returns:
    
    new instance of E
    
    Throws:
    
    CloneNotSupportedException - if some error occur during clone
  - call
```
public static Object call(Object o,
                          Method m,
                          String... params)
                   throws IllegalAccessException,
                          IllegalArgumentException,
                          InvocationTargetException,
                          InstantiationException
```
    Call method m with params as String. Each param is converted to required type for method with beanutils converter
    
    Parameters:
    
    o - object where method must be call
    
    m - method to call
    
    params - parameters for method call
    
    Returns:
    
    returned method's value
    
    Throws:
    
    IllegalAccessException - FIXME
    
    IllegalArgumentException - FIXME
    
    InvocationTargetException - FIXME
    
    InstantiationException - FIXME
  - getMethod
```
public static List<Method> getMethod(Class<?> clazz,
                                     String methodName,
                                     boolean ignoreCase)
```
    Get all methods with name given in argument without check parameters.
    
    Parameters:
    
    clazz - where to search method
    
    methodName - method name to search
    
    ignoreCase - if true, ignore difference in method name case
    
    Returns:
    
    list of detected methods
  - getMethod
```
public static List<Method> getMethod(String name,
                                     boolean ignoreCase)
```
    List method that match name, name must be [package.][class][#][method] if package, class or method missing, exception throw
    
    Parameters:
    
    name - name of the method
    
    ignoreCase - check exact method name if false
    
    Returns:
    
    list of method that match name
    
    Since:
    
    2.6.9
  - newInstance
```
public static Object newInstance(String constructorWithParams)
                          throws ClassNotFoundException
```
    Throws:
    
    ClassNotFoundException
  - newInstance
```
public static <T> T newInstance(Class<T> clazz,
                                String... params)
                         throws IllegalArgumentException
```
    Create new instance of clazz, call constructor with params as String. Each param is converted to required type for constructor with beanutils converter, first constructor that permit instanciation is used
    
    Type Parameters:
    
    T - type to instanciate
    
    Parameters:
    
    clazz - class to instanciate
    
    params - parameters for constructor call
    
    Returns:
    
    new instance of clazz
    
    Throws:
    
    IllegalArgumentException - FIXME
  - getConstructor
```
public static <T> List<Constructor<T>> getConstructor(Class<T> clazz,
                                                      int paramNumber)
```
    Get all constructors that support paramNumber as parameters numbers. Varargs is supported
    
    Type Parameters:
    
    T - le type de la classe a inspecter
    
    Parameters:
    
    clazz - la classe sur lequel rechercher le constructeur
    
    paramNumber - le nombre de parametre souhaite pour le constructeur, -1 indique que tous les constructeur sont souhaite.
    
    Returns:
    
    list of constructors
  - isNullValue
```
public static boolean isNullValue(Object value)
```
    Tests if the given value is null according to default value for primitive types if nedded.
    
    Parameters:
    
    value - the value to test
    
    Returns:
    
    true if value is null or default value on a primitive
    
    Since:
    
    1.1.5
  - isNullValue
```
public static boolean isNullValue(boolean value)
```
  - isNullValue
```
public static boolean isNullValue(byte value)
```
  - isNullValue
```
public static boolean isNullValue(int value)
```
  - isNullValue
```
public static boolean isNullValue(char value)
```
  - isNullValue
```
public static boolean isNullValue(float value)
```
  - isNullValue
```
public static boolean isNullValue(double value)
```
  - isPrimitive
```
public static boolean isPrimitive(Class<?> clazz)
```
    Verifie si la classe est de type primitif.
    
    Parameters:
    
    clazz - nom de la classe a tester
    
    Returns:
    
    vrai si le classe est de type primitif faux sinon

Class ObjectUtil

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CLASS_METHOD_SEPARATOR

ZERO

ZEROC

ZEROF

ZEROL

ZEROD

ZEROB

Method Detail

newInstance

choiceArgument

create

convert

clone

deepClone

call

getMethod

getMethod

newInstance

newInstance

getConstructor

isNullValue

isNullValue

isNullValue

isNullValue

isNullValue

isNullValue

isNullValue

isPrimitive