LangUtils (eu.ralph-schuster.baselib 1.2.5 API)

java.lang.Object
- rs.baselib.lang.LangUtils

```
public class LangUtils
extends Object
```
Reflection and language Utils.

Author:

ralph

Constructor Summary

Constructors
Constructor and Description

LangUtils()

Constructors
Constructor and Description
`LangUtils()`

Method Summary

Methods
Modifier and Type	Method and Description
`static Class<?>`	`forName(String className)` Load a class by first checking the thread's class loader and then the caller's class loader.
`static Class<?>`	`forName(String className, ClassLoader classLoader)` Load a class by directly specifying a class loader.
`static boolean`	`getBoolean(Object o)` Converts the object to a boolean.
`static Class<?>`	`getClass(Type type)` Get the underlying class for a type, or null if the type is a variable type.
`static Date`	`getDate(Object o)` Converts the object to a `Date`.
`static Date`	`getDate(Object o, DateFormat format)` Converts the object to a date.
`static Date`	`getDate(Object o, DateFormat[] formats)` Returns the date using the first `DateFormat` that produces a result.
`static Date`	`getDate(Object o, DateFormat[] formats, Date defaultValue)` Returns the date using the first `DateFormat` that produces a result.
`static Date`	`getDate(Object o, DateFormat format, Date defaultValue)` Converts the object to a date.
`static Date`	`getDate(Object o, DateFormat format, Date defaultValue, boolean logError)` Converts the object to a date.
`static double`	`getDouble(Object o)` Converts the object to a double.
`static double`	`getDouble(Object o, double defaultValue)` Converts the object to a double.
`static float`	`getFloat(Object o)` Converts the object to a float.
`static float`	`getFloat(Object o, float defaultValue)` Converts the object to a float.
`static int`	`getInt(Object o)` Converts the object to an int.
`static int`	`getInt(Object o, int defaultValue)` Converts the object to an int.
`static Locale`	`getLocale(String id)` Returns the locale with the id.
`static Locale`	`getLocale(String id, Locale defaultLocale)` Returns the locale with the id.
`static long`	`getLong(Object o)` Converts the object to a long.
`static long`	`getLong(Object o, long defaultValue)` Converts the object to a long.
`static RsDate`	`getRsDate(Object o)` Converts the object to a `RsDate`.
`static RsDate`	`getRsDate(Object o, DateFormat format)` Converts the object to a `RsDate`.
`static RsDate`	`getRsDate(Object o, DateFormat[] formats)` Returns the date using the first `DateFormat` that produces a result.
`static RsDate`	`getRsDate(Object o, DateFormat[] formats, RsDate defaultValue)` Returns the date using the first `DateFormat` that produces a result.
`static RsDate`	`getRsDate(Object o, DateFormat format, RsDate defaultValue)` Converts the object to a `RsDate`.
`static RsDate`	`getRsDate(Object o, DateFormat format, RsDate defaultValue, boolean logError)` Converts the object to a `RsDate`.
`static String`	`getString(Object o)` Converts the object to a string.
`static <T> List<Class<?>>`	`getTypeArguments(Class<T> baseClass, Class<? extends T> childClass)` Get the actual type arguments a child class has used to extend a generic base class.
`static boolean`	`isJava6()` Returns true when the runtime is Java 6.
`static boolean`	`isNoCopy(PropertyDescriptor desc)` Returns true when given property is not allowed to be copied with `IBean.copyTo(Object)`.
`static boolean`	`isTransient(PropertyDescriptor desc)` Returns true when given property is transient.
`static Object`	`newInstance(String className)` Instantiates a class object from class name.
`static Object`	`newInstance(String className, ClassLoader classLoader)` Instantiates a class object from class name.
`static byte[]`	`serialize(Object value)` Serializes the given value.
`static String`	`serializeBase64(Object value)` Serializes the given value into BASE64.
`static void`	`sleep(long milliseconds)` A wrapper for `Thread.sleep(long)` to avoid try/catch blocks.
`static String`	`toString(String className, Object... properties)` Creates a unified `toString()` output.
`static Object`	`unserialize(byte[] bytes)` Unserializes the given value.
`static Object`	`unserialize(String value)` Unserializes the given value.

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

- Constructor Detail
  - LangUtils
```
public LangUtils()
```
- Method Detail
  - forName
```
public static Class<?> forName(String className)
                        throws ClassNotFoundException
```
    Load a class by first checking the thread's class loader and then the caller's class loader.
    
    Parameters:
    className - name of cass to be loaded
    
    Returns:
    the class found
    
    Throws:
    
    ClassNotFoundException - when the class cannot be found
  - forName
```
public static Class<?> forName(String className,
               ClassLoader classLoader)
                        throws ClassNotFoundException
```
    Load a class by directly specifying a class loader.
    
    Parameters:
    className - name of cass to be loaded
    classLoader - the class loader to be used - if null the thread's class loader will be used first
    
    Returns:
    the class found
    
    Throws:
    
    ClassNotFoundException - when the class cannot be found
  - newInstance
```
public static Object newInstance(String className)
                          throws ClassNotFoundException,
                                 IllegalAccessException,
                                 InstantiationException
```
    Instantiates a class object from class name. This is a shortcut method for forName(String).newInstance().
    
    Parameters:
    className - the name of class
    
    Returns:
    an instance of the named class
    
    Throws:
    
    ClassNotFoundException - when class cannot be found
    
    IllegalAccessException - when constructor cannot be called
    
    InstantiationException - when constructor throws errors
  - newInstance
```
public static Object newInstance(String className,
                 ClassLoader classLoader)
                          throws ClassNotFoundException,
                                 IllegalAccessException,
                                 InstantiationException
```
    Instantiates a class object from class name. This is a shortcut method for forName(String,ClassLoader).newInstance().
    
    Parameters:
    className - the name of class
    classLoader - the class loader to be used - if null the thread's class loader will be used first
    
    Returns:
    an instance of the named class
    
    Throws:
    
    ClassNotFoundException - when class cannot be found
    
    IllegalAccessException - when constructor cannot be called
    
    InstantiationException - when constructor throws errors
  - getClass
```
public static Class<?> getClass(Type type)
```
    Get the underlying class for a type, or null if the type is a variable type.
    
    Parameters:
    type - the type
    
    Returns:
    the underlying class
  - getTypeArguments
```
public static <T> List<Class<?>> getTypeArguments(Class<T> baseClass,
                                  Class<? extends T> childClass)
```
    Get the actual type arguments a child class has used to extend a generic base class.
    
    Parameters:
    baseClass - the base class
    childClass - the child class
    
    Returns:
    a list of the raw classes for the actual type arguments.
  - getString
```
public static String getString(Object o)
```
    Converts the object to a string.
    
    Parameters:
    o - object to be converted
    
    Returns:
    null if object is null, string value of object otherwise
  - getInt
```
public static int getInt(Object o)
```
    Converts the object to an int. The method will throw an exception when the object is not null and cannot be parsed.
    
    Parameters:
    o - object to be converted
    
    Returns:
    0 if object is null, int value of object otherwise
  - getInt
```
public static int getInt(Object o,
         int defaultValue)
```
    Converts the object to an int.
    
    Parameters:
    o - object to be converted
    defaultValue - the default value to return
    
    Returns:
    default if object is null or cannot be parsed, int value of object otherwise
  - getLong
```
public static long getLong(Object o)
```
    Converts the object to a long. The method will throw an exception when the object is not null and cannot be parsed.
    
    Parameters:
    o - object to be converted
    
    Returns:
    0 if object is null, long value of object otherwise
  - getLong
```
public static long getLong(Object o,
           long defaultValue)
```
    Converts the object to a long.
    
    Parameters:
    o - object to be converted
    defaultValue - the default value to return
    
    Returns:
    default if object is null or cannot be parsed, long value of object otherwise
  - getFloat
```
public static float getFloat(Object o)
```
    Converts the object to a float. The method will throw an exception when the object is not null and cannot be parsed.
    
    Parameters:
    o - object to be converted
    
    Returns:
    0 if object is null, float value of object otherwise
  - getFloat
```
public static float getFloat(Object o,
             float defaultValue)
```
    Converts the object to a float.
    
    Parameters:
    o - object to be converted
    defaultValue - the default value to return
    
    Returns:
    default if object is null or cannot be parsed, float value of object otherwise
  - getDouble
```
public static double getDouble(Object o)
```
    Converts the object to a double. The method will throw an exception when the object is not null and cannot be parsed.
    
    Parameters:
    o - object to be converted
    
    Returns:
    0 if object is null, double value of object otherwise
  - getDouble
```
public static double getDouble(Object o,
               double defaultValue)
```
    Converts the object to a double.
    
    Parameters:
    o - object to be converted
    defaultValue - the default value to return
    
    Returns:
    default if object is null or cannot be parsed, double value of object otherwise
  - getBoolean
```
public static boolean getBoolean(Object o)
```
    Converts the object to a boolean. Values recognized a strue are 1, true, on, yes, y (case-insensitive).
    
    Parameters:
    o - object to be converted
    
    Returns:
    false if object is null, boolean value of object otherwise
  - getRsDate
```
public static RsDate getRsDate(Object o,
               DateFormat[] formats)
```
    Returns the date using the first DateFormat that produces a result.
    
    Parameters:
    o - object to be transformed
    formats - formats to be used
    
    Returns:
    the date if it could be parsed or null
  - getRsDate
```
public static RsDate getRsDate(Object o,
               DateFormat[] formats,
               RsDate defaultValue)
```
    Returns the date using the first DateFormat that produces a result.
    
    Parameters:
    o - object to be transformed
    formats - formats to be used
    defaultValue - value to be returned when object cannot be transformed.
    
    Returns:
    the date if it could be parsed, the default value otherwise
  - getRsDate
```
public static RsDate getRsDate(Object o)
```
    Converts the object to a RsDate.
    
    Parameters:
    o - object to be converted
    
    Returns:
    RsDate value of object, null otherwise
  - getRsDate
```
public static RsDate getRsDate(Object o,
               DateFormat format)
```
    Converts the object to a RsDate.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    
    Returns:
    RsDate value of object, null otherwise
  - getRsDate
```
public static RsDate getRsDate(Object o,
               DateFormat format,
               RsDate defaultValue)
```
    Converts the object to a RsDate.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    defaultValue - value to be returned when object cannot be transformed.
    
    Returns:
    RsDate value of object, the default value otherwise
  - getRsDate
```
public static RsDate getRsDate(Object o,
               DateFormat format,
               RsDate defaultValue,
               boolean logError)
```
    Converts the object to a RsDate.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    defaultValue - value to be returned when object cannot be transformed.
    logError - whether parsing error shall be logged
    
    Returns:
    RsDate value of object, the default value otherwise
  - getDate
```
public static Date getDate(Object o,
           DateFormat[] formats)
```
    Returns the date using the first DateFormat that produces a result.
    
    Parameters:
    o - object to be transformed
    formats - formats to be used
    
    Returns:
    the date if it could be parsed, null otherwise
  - getDate
```
public static Date getDate(Object o,
           DateFormat[] formats,
           Date defaultValue)
```
    Returns the date using the first DateFormat that produces a result.
    
    Parameters:
    o - object to be transformed
    formats - formats to be used
    defaultValue - value to be returned when object cannot be transformed.
    
    Returns:
    the date if it could be parsed, the default value otherwise
  - getDate
```
public static Date getDate(Object o)
```
    Converts the object to a Date.
    
    Parameters:
    o - object to be converted
    
    Returns:
    Date value of object, null otherwise
  - getDate
```
public static Date getDate(Object o,
           DateFormat format)
```
    Converts the object to a date.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    
    Returns:
    Date value of object, null otherwise
  - getDate
```
public static Date getDate(Object o,
           DateFormat format,
           Date defaultValue)
```
    Converts the object to a date.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    defaultValue - value to be returned when object cannot be transformed.
    
    Returns:
    Date value of object, the default value otherwise
  - getDate
```
public static Date getDate(Object o,
           DateFormat format,
           Date defaultValue,
           boolean logError)
```
    Converts the object to a date.
    
    Parameters:
    o - object to be converted
    format - format to be applied
    defaultValue - value to be returned when object cannot be transformed.
    logError - whether parsing error shall be logged
    
    Returns:
    Date value of object, the default value otherwise
  - isJava6
```
public static boolean isJava6()
```
    Returns true when the runtime is Java 6.
    
    Returns:
    true if Java 6, false otherwise.
  - getLocale
```
public static Locale getLocale(String id)
```
    Returns the locale with the id.
    
    Parameters:
    id - id of locale as returned by toString()
    
    Returns:
    the locale or the default Locale if not found.
  - getLocale
```
public static Locale getLocale(String id,
               Locale defaultLocale)
```
    Returns the locale with the id.
    
    Parameters:
    id - id of locale as returned by toString()
    defaultLocale - default to return when locale cannot be found
    
    Returns:
    the locale or the default if not found.
  - serializeBase64
```
public static String serializeBase64(Object value)
                              throws IOException
```
    Serializes the given value into BASE64.
    
    Parameters:
    value - value to be serialized
    
    Returns:
    the serialized string
    
    Throws:
    
    IOException
  - serialize
```
public static byte[] serialize(Object value)
                        throws IOException
```
    Serializes the given value.
    
    Parameters:
    value - value to be serialized
    
    Returns:
    the serialized string
    
    Throws:
    
    IOException
  - unserialize
```
public static Object unserialize(String value)
                          throws ClassNotFoundException,
                                 IOException
```
    Unserializes the given value.
    
    Parameters:
    value - the serialized string (BASE64 encoded)
    
    Returns:
    the object (or null)
    
    Throws:
    
    ClassNotFoundException
    
    IOException
  - unserialize
```
public static Object unserialize(byte[] bytes)
                          throws ClassNotFoundException,
                                 IOException
```
    Unserializes the given value.
    
    Parameters:
    bytes - the bytes of serialized object
    
    Returns:
    the object (or null)
    
    Throws:
    
    ClassNotFoundException
    
    IOException
  - toString
```
public static String toString(String className,
              Object... properties)
```
    Creates a unified toString() output.
    Properties must be represented with two values: name of property and its value, e.g. the call
```
    toString("ClassName", "property1", "value1", "property2", "value2")
 
```
    will produce ClassName[property1=value1;property2=value2].
    Parameters:
    className - the class name to be used
    properties - the properties where each property is represented with two values: name of property and its value.
    
    Returns:
    a unified toString() output, .
  - isTransient
```
public static boolean isTransient(PropertyDescriptor desc)
```
    Returns true when given property is transient. A transient property has either a missing getter or setter or its getter is marked with Transient annotation.
    
    Parameters:
    desc - property descriptor
    
    Returns:
    true when property is transient and must not be persisted
  - isNoCopy
```
public static boolean isNoCopy(PropertyDescriptor desc)
```
    Returns true when given property is not allowed to be copied with IBean.copyTo(Object). A NoCopy property has either a missing getter or setter or its getter is marked with NoCopy annotation.
    
    Parameters:
    desc - property descriptor
    
    Returns:
    true when property is transient and must not be persisted
  - sleep
```
public static void sleep(long milliseconds)
```
    A wrapper for Thread.sleep(long) to avoid try/catch blocks. The method throws a RuntimeException in case of exceptions.
    
    Parameters:
    milliseconds - milliseconds to sleep

Class LangUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LangUtils

Method Detail

forName

forName

newInstance

newInstance

getClass

getTypeArguments

getString

getInt

getInt

getLong

getLong

getFloat

getFloat

getDouble

getDouble

getBoolean

getRsDate

getRsDate

getRsDate

getRsDate

getRsDate

getRsDate

getDate

getDate

getDate

getDate

getDate

getDate

isJava6

getLocale

getLocale

serializeBase64

serialize

unserialize

unserialize

toString

isTransient

isNoCopy

sleep