MetaUtil (utils 2.0.1 API)

java.lang.Object
- com.bluejeans.utils.MetaUtil

```
public class MetaUtil
extends Object
```
Meta utility.

Author:

Dinesh Ilindra

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class MetaUtil.LogicTransformer
Logic transformer

Nested Classes
Modifier and Type	Class and Description
`static class`	`MetaUtil.LogicTransformer` Logic transformer

Field Summary

Fields
Modifier and Type Field and Description

static Map<String,Object> META_MAP
Generic meta data map

static List<Class<?>> SIMPLE_RETURN_TYPE_LIST
The simple return type list

Fields
Modifier and Type	Field and Description
`static Map<String,Object>`	`META_MAP` Generic meta data map
`static List<Class<?>>`	`SIMPLE_RETURN_TYPE_LIST` The simple return type list

Constructor Summary

Constructors
Constructor and Description

MetaUtil()

Constructors
Constructor and Description
`MetaUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addLogic(Instrumentation instr, String fqcn, String methodName, String argLength, String mode, String logic)`
`static void`	`addSourceToJarStream(String prefix, File source, JarOutputStream jarStream, String jarName)` add source to jar stream
`static List<Class<?>>`	`allExtendedClassesOf(Class<?> classz)` All classes that the given class extends
`static List<Field>`	`allFieldsOf(Class<?> classz)` All fields that can be found on an object of the given class
`static List<Method>`	`allMethodsOf(Class<?> classz)` All methods that can be invoked on an object of the given class
`static List<Field>`	`allSuperFieldsOf(Class<?> classz)` All fields that can be found on an object's hierarchy other than itself of the given class
`static void`	`assignFromHierarchy(Object obj)` For each field that the subclass has, if superclasses also have it, then fetch that value from hierarchy and set here.
`static int`	`availablePort(int startPort, int maxCount)` Get available server port from the given port inclusive, until the max count.
`static Map<String,Object>`	`classNameObjectMap(Object... objects)` Returns a map containing the object's class name as key with the object itself as value.
`static void`	`copyFields(Object dst, Object src)` For each field that the destination has, if source also have it, then fetch that value from source and set in destination.
`static File`	`createJarFromClasses(Class<?> loader, String folder, String jarName, Map<String,String> attributes, Class<?>... clazzes)` create jar from class definitions
`static File`	`createJarFromClasses(Class<?> loader, String folder, String jarName, Map<String,String> attributes, List<Class<?>> clazzes)` create jar from class definitions
`static File`	`createJarFromClasses(String folder, String jarName, Map<String,String> attributes, Class<?>... clazzes)` create jar from class definitions
`static File`	`createJarFromDir(String srcDir, String dstDir, String name, Map<String,String> attributes)` create jar from source dir into destination dir
`static Map<String,Object>`	`createMap(String key, Object value)` Returns a new map which has single entry with the given key and value.
`static <T> Map<String,T>`	`createMap(String key, Object value, Class<T> clazz)` Returns a new map which has single entry with the given key and value.
`static Map<String,Object>`	`createParamMap(Object... params)` Create a params map from given varargs.
`static Map<String,String>`	`createPropsMap(String... args)` Create a property map from given varargs.
`static String`	`decompileClass(String className)` Decompile class
`static void`	`disableSslCertificates()` Disables SSL certificates checks
`static int`	`enableJmx()` Enable JMX
`static void`	`enableJmx(int port)` Enable JMX
`static com.fasterxml.jackson.databind.JsonNode`	`encodeForHTML(com.fasterxml.jackson.databind.JsonNode node)` Encode the json node text values for HTML
`static String`	`encodeForHTML(String text)` Encode given text
`static void`	`extractResource(Class<?> loader, String resourceName, String folder)` extract a resource
`static byte[]`	`fetchClassDefinitionBytes(Class<?> clazz)` Fetch the class definition bytes
`static byte[]`	`fetchClassDefinitionBytes(Class<?> loader, Class<?> clazz)` Fetch the class definition bytes
`static Map<String,Object>`	`fieldDataMap(Object target, boolean prependClassName, String methodPrefix, List<Class<?>> returnTypeList)` Get the map of all the return values of all the methods starting with given prefix with the given return types of the given bean.
`static List<Class<?>>`	`findClasses(File directory, String packageName)` Recursive method used to find all classes in a given directory and sub dirs.
`static Field`	`findFirstField(Class<?> clazz, String fieldName)` Finds the first field by this name or null if not found.
`static Field`	`findFirstFieldByType(Class<?> clazz, String typeName)` Finds the first field by its type name or null if not found.
`static Method`	`findFirstMethod(Class<?> clazz, String methodName)` Finds the first method by this name or null if not found.
`static Method`	`findFirstMethod(Class<?> classz, String methodName, int totalArguments)` Find first method matching name and no.
`static Method`	`findFirstMethodEndsWithAndReturns(Class<?> clazz, String methodName, Class<?> returnType)` Finds the first method ending by this name and having this return type or null if not found.
`static Method`	`findFirstMethodStartsWith(Class<?> clazz, String methodName)` Finds the first method starting by this name or null if not found.
`static Field`	`findFirstSuperField(Class<?> clazz, String fieldName)` Finds the first super field by this name or null if not found.
`static Method`	`findSetter(Class<?> classz, String propertyName)` Finds the setter method for the property or null if not found.
`static boolean`	`ftpUpload(org.apache.commons.net.ftp.FTPClient ftpClient, File local, String remote, boolean recursive)` ftp upload recursive
`static boolean`	`ftpUpload(String ftpUrl, String local, String remote)` upload to ftp
`static boolean`	`ftpUpload(String ftpUrl, String local, String remote, boolean recursive)` upload to ftp
`static List<Class<?>>`	`getClasses(String packageName)` Scans all classes accessible from the context class loader which belong to the given package and sub packages.
`static List<Class<?>>`	`getLoadedClassesByName(Instrumentation instr, String className)` get loaded classes by name from instrumentation
`static byte[]`	`getResourceAsBytes(Class<?> loader, String resourceName)` Get the resource as bytes.
`static byte[]`	`getResourceAsBytes(String resourceName)` Get the resource as bytes.
`static String`	`getResourceAsString(String resourceName)` Get the resource as string.
`static long`	`hash(String string)` Computes a long hash for this string.
`static void`	`registerAsMBean(Object bean)` Register the instance as MBean.
`static void`	`registerAsMBean(Object bean, String objectName)` Register the instance as MBean with given name.
`static Object`	`runNestedMethod(Object target, String nestedMethod)` Run the nested method on the target object.
`static Map<String,Object>`	`runNestedMethodsSilently(Object target, String nestedMethods)` Run the nested methods silently on the target object.
`static void`	`setPropertyIfExists(Object obj, String propertyName, Object propertyValue)` Sets the given property if exists with the given value.
`static void`	`shuffleArray(Object array)` Shuffles the given array, if it is array.
`static Map<String,Object>`	`simpleFieldDataMap(Object target, boolean prependClassName)` Get the map of all the return values of all the methods with no arguments with simple return types of the given bean.
`static File`	`writeClassDefinition(Class<?> loader, String folder, Class<?> clazz)` Write class definition to file
`static File`	`writeClassDefinition(String folder, Class<?> clazz)` Write class definition to file
`static void`	`writeClassDefinitions(Class<?> loader, String folder, Class<?>... clazzes)` Write class definition to file
`static void`	`writeClassDefinitions(Class<?> loader, String folder, List<Class<?>> clazzes)` Write class definition to file
`static void`	`writeClassDefinitions(String folder, Class<?>... clazzes)` Write class definition to file

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

Field Detail

META_MAP

public static final Map<String,Object> META_MAP

Generic meta data map

SIMPLE_RETURN_TYPE_LIST

public static final List<Class<?>> SIMPLE_RETURN_TYPE_LIST

The simple return type list

Constructor Detail
- MetaUtil
```
public MetaUtil()
```

Method Detail

createParamMap
```
public static Map<String,Object> createParamMap(Object... params)
```
Create a params map from given varargs.

Parameters:

params - the params

Returns:

the param map

getResourceAsString
```
public static String getResourceAsString(String resourceName)
```
Get the resource as string.

Parameters:

resourceName - the resource name

Returns:

the string value

getResourceAsBytes
```
public static byte[] getResourceAsBytes(String resourceName)
```
Get the resource as bytes.

Parameters:

resourceName - the resource name

Returns:

the bytes value

getResourceAsBytes

public static byte[] getResourceAsBytes(Class<?> loader,
                                        String resourceName)

Get the resource as bytes.

Parameters:: resourceName - the resource name; loader - the class loader
Returns:: the bytes value

registerAsMBean

public static void registerAsMBean(Object bean)
                            throws JMException

Parameters:: bean - the bean
Throws:: JMException - implicit

registerAsMBean

public static void registerAsMBean(Object bean,
                                   String objectName)
                            throws JMException

Parameters:: bean - the bean; objectName - the object name
Throws:: JMException - implicit

findFirstMethodStartsWith

public static Method findFirstMethodStartsWith(Class<?> clazz,
                                               String methodName)

Finds the first method starting by this name or null if not found.

Parameters:: clazz - the class; methodName - the method name
Returns:: the first method found / null

findFirstMethodEndsWithAndReturns

public static Method findFirstMethodEndsWithAndReturns(Class<?> clazz,
                                                       String methodName,
                                                       Class<?> returnType)

Finds the first method ending by this name and having this return type or null if not found.

Parameters:: clazz - the class; methodName - the method name; returnType - the return type
Returns:: the first method found / null

findFirstMethod
```
public static Method findFirstMethod(Class<?> clazz,
                                     String methodName)
```
Finds the first method by this name or null if not found.

Parameters:

clazz - the class

methodName - the method name

Returns:

the first method found / null

findFirstMethod
```
public static Method findFirstMethod(Class<?> classz,
                                     String methodName,
                                     int totalArguments)
```
Find first method matching name and no. of arguments or null if none found.

Parameters:

classz - the class

methodName - the method name

totalArguments - the total no. of arguments

Returns:

the first method found / null

allExtendedClassesOf
```
public static List<Class<?>> allExtendedClassesOf(Class<?> classz)
```
All classes that the given class extends

Parameters:

classz - the class

Returns:

the set of all classes that this extends

allMethodsOf
```
public static List<Method> allMethodsOf(Class<?> classz)
```
All methods that can be invoked on an object of the given class

Parameters:

classz - the class

Returns:

the list of all methods that can be invoked

findFirstField
```
public static Field findFirstField(Class<?> clazz,
                                   String fieldName)
```
Finds the first field by this name or null if not found.

Parameters:

clazz - the class

fieldName - the field name

Returns:

the first field found / null

findFirstSuperField
```
public static Field findFirstSuperField(Class<?> clazz,
                                        String fieldName)
```
Finds the first super field by this name or null if not found.

Parameters:

clazz - the class

fieldName - the field name

Returns:

the first field found / null

findFirstFieldByType
```
public static Field findFirstFieldByType(Class<?> clazz,
                                         String typeName)
```
Finds the first field by its type name or null if not found.

Parameters:

clazz - the class

typeName - the field type simple name

Returns:

the first field found / null

allFieldsOf
```
public static List<Field> allFieldsOf(Class<?> classz)
```
All fields that can be found on an object of the given class

Parameters:

classz - the class

Returns:

the list of all fields that can be accessed

allSuperFieldsOf
```
public static List<Field> allSuperFieldsOf(Class<?> classz)
```
All fields that can be found on an object's hierarchy other than itself of the given class

Parameters:

classz - the class

Returns:

the list of all fields that can be accessed

findSetter
```
public static Method findSetter(Class<?> classz,
                                String propertyName)
```
Finds the setter method for the property or null if not found.

Parameters:

classz - the class

propertyName - the property name

Returns:

the setter

setPropertyIfExists

public static void setPropertyIfExists(Object obj,
                                       String propertyName,
                                       Object propertyValue)

Sets the given property if exists with the given value.

Parameters:: obj - the object; propertyName - the property name; propertyValue - the property value

fieldDataMap

public static Map<String,Object> fieldDataMap(Object target,
                                              boolean prependClassName,
                                              String methodPrefix,
                                              List<Class<?>> returnTypeList)

Get the map of all the return values of all the methods starting with given prefix with the given return types of the given bean.

Parameters:: target - the target object; prependClassName - the prepend class name; methodPrefix - the method prefix; returnTypeList - the return types list
Returns:: the field data map

simpleFieldDataMap
```
public static Map<String,Object> simpleFieldDataMap(Object target,
                                                    boolean prependClassName)
```
Get the map of all the return values of all the methods with no arguments with simple return types of the given bean.

Parameters:

target - the target object

prependClassName - the prepend class name

Returns:

the field data map

classNameObjectMap
```
public static Map<String,Object> classNameObjectMap(Object... objects)
```
Returns a map containing the object's class name as key with the object itself as value.

Parameters:

objects - the objects

Returns:

the name map

createMap

public static Map<String,Object> createMap(String key,
                                           Object value)

Returns a new map which has single entry with the given key and value.

Parameters:: key - the key; value - the value
Returns:: the map

createMap

public static <T> Map<String,T> createMap(String key,
                                          Object value,
                                          Class<T> clazz)

Returns a new map which has single entry with the given key and value.

Type Parameters:: T - the type of values
Parameters:: key - the key; value - the value
Returns:: the map

createPropsMap
```
public static Map<String,String> createPropsMap(String... args)
```
Create a property map from given varargs.

Parameters:

args - the arguments

Returns:

the prop map

shuffleArray
```
public static void shuffleArray(Object array)
```
Shuffles the given array, if it is array.

Parameters:

array - the array to shuffle

availablePort
```
public static int availablePort(int startPort,
                                int maxCount)
```
Get available server port from the given port inclusive, until the max count.

Parameters:

startPort - the start port

maxCount - the max count

Returns:

the available port

runNestedMethod

public static Object runNestedMethod(Object target,
                                     String nestedMethod)
                              throws ReflectiveOperationException,
                                     ScriptException

Run the nested method on the target object.

Parameters:: target - the target object; nestedMethod - the nested method
Throws:: ScriptException - when there is a problem in script; ReflectiveOperationException - when a problem in reflection

runNestedMethodsSilently

public static Map<String,Object> runNestedMethodsSilently(Object target,
                                                          String nestedMethods)

Run the nested methods silently on the target object.

Parameters:: target - the target object; nestedMethods - the nested methods separated by ;;

disableSslCertificates

public static void disableSslCertificates()
                                   throws GeneralSecurityException

Disables SSL certificates checks

Throws:: GeneralSecurityException - if anything wrong happens

hash
```
public static long hash(String string)
```
Computes a long hash for this string.

Parameters:

string - the string

Returns:

the long hash

assignFromHierarchy
```
public static void assignFromHierarchy(Object obj)
```
For each field that the subclass has, if superclasses also have it, then fetch that value from hierarchy and set here.

Parameters:

obj - the object

copyFields
```
public static void copyFields(Object dst,
                              Object src)
```
For each field that the destination has, if source also have it, then fetch that value from source and set in destination.

Parameters:

dst - the destination object

src - the source object

enableJmx

public static int enableJmx()
                     throws IOException

Enable JMX

Throws:: IOException

enableJmx

public static void enableJmx(int port)
                      throws IOException

Enable JMX

Throws:: IOException - if anything goes wrong

fetchClassDefinitionBytes

public static byte[] fetchClassDefinitionBytes(Class<?> loader,
                                               Class<?> clazz)
                                        throws IOException

Fetch the class definition bytes

Parameters:: loader - the loader; clazz - the class
Returns:: the bytes
Throws:: IOException - if problem

fetchClassDefinitionBytes
```
public static byte[] fetchClassDefinitionBytes(Class<?> clazz)
                                        throws IOException
```
Fetch the class definition bytes

Parameters:

clazz - the class

Returns:

the bytes

Throws:

IOException - if problem