com.technia.tvc.core.util

Class ObjectUtils

java.lang.Object

com.technia.tvc.core.util.ObjectUtils

public final class ObjectUtils
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static java.lang.String	concat(java.util.Collection<?> c, java.lang.String sep) Concatenates a collections of anything into a string, using the provided separator.
static java.lang.String	concat(java.lang.Object[] arr, java.lang.String sep) Concatenates a array of anything into a string, using the provided separator.
static <T> T	createInstance(java.lang.String className, java.lang.Class<T> type) Creates a new instance of a class whose classname is provided as argument to this method.
static <T> T	createInstance(java.lang.String className, java.lang.Class<T> type, java.lang.ClassLoader classLoader)
static java.lang.Object	deserialize(java.lang.String b64) De-serializes a base64 string into a Java object.
static <T> int	indexOf(T[] arr, T value) Returns the index of an item within an array.
static boolean	isHavingClass(java.lang.String className) Checks if the specified class exists on the specified package.
static boolean	isHavingMethod(java.lang.String className, java.lang.String methodName) Checks if the specified method exists on the specified class.
static boolean	isHavingMethodWithArgCount(java.lang.String className, java.lang.String methodName, int argCount) This method safely checks if a class with the provided name has a method signature of the specified name taking the specified number of arguments.
static <T> T	npeSafeCast(java.lang.Object obj)
static java.lang.String	serialize(java.io.Serializable s) Serializes an object and encode the generated byte array with base64 encoder.
static <T> java.util.Enumeration<T>	toEnumeration(T object) Creates an Enumeration containing the given object.
static <T extends java.lang.Enum<T>> T	valueOf(java.lang.Class<T> type, java.lang.String name, T defaultValue) This method provides a safer way to return an enum constant than using Enum.valueOf.

Methods inherited from class java.lang.Object

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

Method Detail

valueOf

public static <T extends java.lang.Enum<T>> T valueOf(java.lang.Class<T> type,
                                                      java.lang.String name,
                                                      T defaultValue)

This method provides a safer way to return an enum constant than using Enum.valueOf.

The name is converted to upper-case, and space or dash chars are converted to under-score before we look-up the enum constant.

This method will not throw any exception.

Parameters:

type - The enum type

name - The name of the enum constant

defaultValue - The default value to return

Returns:

The enum constant according to the rules above. This method will only return null if the defaultValue argument is null.

Since:

2014.3.0

npeSafeCast

public static <T> T npeSafeCast(java.lang.Object obj)

Parameters:

obj - The object to cast

Returns:

The object casted

Since:

2013.2.0

concat

public static java.lang.String concat(java.lang.Object[] arr,
                                      java.lang.String sep)

Concatenates a array of anything into a string, using the provided separator. Note: the string representation of each object is retrieved by calling the toString() on the returned item.

Parameters:

arr - The array of objects.

sep - The separator

Returns:

A string

Since:

2010.1.0

concat

public static java.lang.String concat(java.util.Collection<?> c,
                                      java.lang.String sep)

Concatenates a collections of anything into a string, using the provided separator. Note: the string representation of each object is retrieved by calling the toString() on the returned item.

Parameters:

c - The collection

sep - The separator

Returns:

A string

Since:

2010.1.0

serialize

public static java.lang.String serialize(java.io.Serializable s)

Serializes an object and encode the generated byte array with base64 encoder. The returned value is a base64 encoded string representing the object.

Parameters:

s - The Serializable object. if null, then null is returned.

Returns:

The object as a base64 encoded string.

Since:

2010.1.0

deserialize

public static java.lang.Object deserialize(java.lang.String b64)

De-serializes a base64 string into a Java object.

Parameters:

b64 - The string containing the base64 data.

Returns:

The object. Note that if any exceptions occurs during the conversion, null will be returned. This method doesn't throw anything. If you need better error handling, don't use this method.

Since:

2010.1.0

indexOf

public static <T> int indexOf(T[] arr,
                              T value)

Returns the index of an item within an array.

We use the equals method on the object to check the equality.

Parameters:

arr - The array of items. May be null.

value - The value itself. May be null.

Returns:

The index of the item in the array; or -1 if not in the array.

createInstance

public static <T> T createInstance(java.lang.String className,
                                   java.lang.Class<T> type)

Creates a new instance of a class whose classname is provided as argument to this method.

The class name argument can contain arguments that are passed to the constructor. Example:

className = com.acme.foo.MyClass('string arg',true,2,3);

This will result in that the constructor that takes 4 arguments (string, boolean, integer, integer) is used when creating the instance.

Type Parameters:

T - The type of class to instantiate.

Parameters:

className - The class name or the classname including additional arguments.

type - The type of class that is expected

Returns:

The created instance; or null if no such instance could be created.

Since:

2011.2.0

createInstance

public static <T> T createInstance(java.lang.String className,
                                   java.lang.Class<T> type,
                                   java.lang.ClassLoader classLoader)

Type Parameters:

T - The type of class to instantiate.

Parameters:

className - The class name or the classname including additional arguments.

type - The type of class that is expected

classLoader - The class loader to use when loading the class. If null, the class loader used to load this class will be used.

Returns:

The created instance; or null if no such instance could be created.

Since:

2013.2.0

isHavingMethodWithArgCount

public static boolean isHavingMethodWithArgCount(java.lang.String className,
                                                 java.lang.String methodName,
                                                 int argCount)

This method safely checks if a class with the provided name has a method signature of the specified name taking the specified number of arguments.

This method catches all exceptions so you can safely use this method against a class that doesn't exist at runtime etc.

Parameters:

className - The name of the class to look into

methodName - The name of the method to search for

argCount - The number of arguments to look for

Returns:

True if the specified method exists.

Since:

2014.2.1

isHavingMethod

public static boolean isHavingMethod(java.lang.String className,
                                     java.lang.String methodName)

Checks if the specified method exists on the specified class.

Parameters:

className - The name of the class to check

methodName - The name of the method to look for.

Returns:

True if the class exists and has at least one method with the given name.

Since:

2014.2.0

isHavingClass

public static boolean isHavingClass(java.lang.String className)

Checks if the specified class exists on the specified package.

Parameters:

className - The name of the class to check

Returns:

True if the class exists

Since:

2018.2.0

toEnumeration

public static <T> java.util.Enumeration<T> toEnumeration(T object)

Creates an Enumeration containing the given object.

Parameters:

object - The object to Enumerate over.

Returns:

An Enumeration instance.

Since:

2016.1.0