Misc (Orchestra :: Administration client using JMX 4.9.0-M4 API)

java.lang.Object
- org.ow2.orchestra.util.Misc

```
public abstract class Misc
extends Object
```
Author:

Marc Blachon, Guillaume Porcher, Charles Souillard, Miguel Valdes, Pierre Vigneras

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Misc.NullCheckResult
Represents null value returned by findNull(Object...).

Nested Classes
Modifier and Type	Class and Description
`static class`	`Misc.NullCheckResult` Represents null value returned by `findNull(Object...)`.

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DAY` Number of milleseconds in a given day
`static String`	`LINE_SEPARATOR` The line separator as defined by the property `line.separator`.
`static Random`	`RANDOM` A RANDOM instance.
`static File`	`TMP_DIR` The file that represents the temporary directory.

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`badStateIfEquals(Object a, Object b, String msg)` This method throw an IllegalStateException if the given parameters are equals (using `Object.equals(Object)`
`static void`	`badStateIfFalse(boolean valueToCheck, String msg)` This method throw an IllegalStateException if the given parameter is false
`static void`	`badStateIfNotNull(Object valueToCheck, String msg)` This method throw an IllegalStateException if the given parameter is not null
`static void`	`badStateIfNull(Object valueToCheck, String msg)` This method throw an IllegalStateException if the given parameter is null
`static void`	`badStateIfTrue(boolean valueToCheck, String msg)` This method throw an IllegalStateException if the given parameter is true
`static void`	`checkArgsNotNull(int offset, Object... params)` Check that the given parameters are not null.
`static void`	`checkArgsNotNull(Object... params)` Check that the given parameters are not null.
`static <T extends Serializable> Exception`	`checkReallySerializable(T object)` Check that the given object is actually serializable.
`static Exception`	`close(Closeable closeable)` Equivalent to `#reflectClose(closeable)`
`static Exception`	`close(XMLDecoder decoder)` Equivalent to {@link #reflectClose(decoder)
`static Exception`	`close(XMLEncoder encoder)` Equivalent to {@link #reflectClose(encoder)
`static String`	`componentsToString(Object[] args, boolean deepToString)` Smart toString() implementation of arrays.
`static LogRecord`	`createLogRecord(Logger logger, Level level, String className, String methodName, String msg, Object... args)` This method creates a `LogRecord` and fills it with the given parameters
`static File`	`createTempFile(String prefix, String suffix, File directory)` Perform java.io.File.createTempFile with retries when it fail (limit of 10 retries) (Use to by-pass bug #6325169 on SUN JDK 1.5 on windows) Sames parameter as `File.createTempFile` method
`static String`	`deepToString(Object o)`
`static boolean`	`deleteDir(File dir)` Delete a given directory and all its contents (whether they are file or directory) WARNING: this method unconditionally modifies the underlying filesystem by erasing files and directories.
`static Serializable`	`deserialize(byte[] buf)`
`static void`	`dynamicLog(int offset, Level level, String msg, Object... args)` Log a message through the logger of the caller at the given offset in the stack trace.
`static void`	`fastDynamicLog(int offset, Logger logger, Level level, String msg, Object... args)` Log a message through the given logger for the caller at the given offset in the stack trace.
`static void`	`fastDynamicLog(Logger logger, Level level, String msg, Object... args)` Equivalent to {@link Misc#fastDynamicLog(int, Logger, Level, String, Object...)
`static Set<Class<?>>`	`findAllInterfaces(Class<?> type)` Return the list of `Class` objects representing all interfaces a given class implements.
`static Set<Class<?>>`	`findAllSuperTypes(Class<?> type)` Return the list of `Class` objects representing all super type a given class implements.
`static Set<Class<?>>`	`findAllTypes(Class<?> type)` Return the list of `Class` objects representing every types a given class implements.
`static Class<?>[]`	`findConstructorClassArgs(Class<?>[] subClasses, Class<?> classToTest)` Return the `Class[]` array representing the types a constructor take as parameters.
`static Class<?>[]`	`findMethodClassArgs(Class<?>[] subClasses, Class<?> classToTest, String methodName)` Return the `Class[]` array representing the types a given method take as parameters.
`static Misc.NullCheckResult`	`findNull(Object... params)` Find null parameters in the given list.
`static String`	`formatDelay(double delay)` Equivalent to `formatDelay(long)`.
`static String`	`formatDelay(long delay)` Format a delay.
`static byte[]`	`generateJar(Class<?>... classes)`
`static byte[]`	`generateJar(Map<String,byte[]> resources)` Generates Jar from resources
`static byte[]`	`getAllContentFrom(File file)` Equivalent to `getAllContentFrom(new FileInputStream(file))`;
`static byte[]`	`getAllContentFrom(InputSource source)` Equivalent to `getAllContentFrom(source.getByteStream(source))`;
`static byte[]`	`getAllContentFrom(InputStream in)` Return the whole underlying stream content into a single String.
`static byte[]`	`getAllContentFrom(Reader in)` Return the whole underlying stream content into a single String.
`static byte[]`	`getAllContentFrom(URL url)` Return the whole underlying stream content into a single String.
`static StackTraceElement`	`getCaller(int offset)` Return the StackTraceElement at the given offset from this method invocation.
`static <T> T`	`getChainOf(List<T> elements)` Return a proxy that forward void-method invocations to each object specified in the list `elements`.
`static String`	`getCurrentThreadStackTrace()`
`static Map<String,byte[]>`	`getDirContentFrom(File dir)` Get all files in this directory.
`static String`	`getGenericFullName(Class<?> clazz)` Return the generic name of a given class.
`static long`	`getHumanReadableId()` Generates a human readable id as a long.
`static String`	`getHumanReadableId(String prefix)` Generates a human readable id prefixed by the given String.
`static <T> T`	`getLoggerProxyFor(T target, Logger logger)` Return a proxy that log method invocations through the provided logger.
`static <T> T`	`getMBeanProxy(Class<T> mbeanInterface, String jmxServiceUrl, String jmxObjectName)` Return a proxy implementing all the interfaces specified that forward method invocations to the specified MBean.
`static int`	`getPermissionsSize(Permissions permissions)`
`static String`	`getRandomString(int size)` Generate a RANDOM String of the given size.
`static Map<String,byte[]>`	`getResources(Class<?>... classes)`
`static Map<String,byte[]>`	`getResourcesFromZip(byte[] zipContent)`
`static StringBuilder`	`getStackTraceFrom(StackTraceElement[] stes)`
`static String`	`getStackTraceFrom(Throwable t)`
`static List<String>`	`getStringFrom(Misc.NullCheckResult nullCheckResult, String... names)` Return strings mapped to null values in a given @{link `Misc.NullCheckResult`. .
`static String`	`getUniqueId(String prefix)` Generate a unique identifier prefixed by the given String.
`static String`	`identityToString(Object o)` Return an "identity string" for a given object.
`static <T> T`	`lookup(String name, Properties environment)`
`static String`	`prefixAllLines(String message, String prefix)` Return a new string based on the given message string where all lines are prefixed by the given prefix.
`static String`	`primitiveComponentsToString(Object array)` Smart toString() implementation of an array of primitive types.
`static int`	`random(int min, int max)` Returns a random number between min and max value
`static Exception`	`reflectClose(Object o)` Invoke the close() method on the given object.
`static byte[]`	`serialize(Serializable object)`
`static void`	`slowLog(Level level, String msg, Object... args)` Equivalent to {@link Misc#dynamicLog(int, Level, String, Object...)
`static <E extends Enum<E>> E`	`stringToEnum(Class<E> c, String s)`
`static void`	`unreachableStatement()`
`static void`	`unreachableStatement(String reason)`
`static void`	`warnIfEquals(Level level, Object a, Object b)` This method logs at the given level a "warning" if the given parameter are equals
`static void`	`warnIfFalse(Level level, boolean valueToCheck, String variableName)` This method logs at the given level a "warning" if the given parameter is false
`static void`	`warnIfNotEquals(Level level, Object a, Object b)` This method logs at the given level a "warning" if the given parameter are not equals
`static void`	`warnIfNotNull(Level level, Object valueToCheck, String variableName)` This method logs at the given level a "warning" if the given parameter is not null
`static void`	`warnIfNull(Level level, Object valueToCheck, String variableName)` This method logs at the given level a "warning message" if the given parameter is null
`static void`	`warnIfTrue(Level level, boolean valueToCheck, String variableName)` This method logs at the given level a "warning" if the given parameter is true
`static void`	`write(byte[] fileContent, File file)`
`static void`	`write(String s, File f)` Write the given String to the given file using the default encoding.

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

- Field Detail
  - RANDOM
```
public static final Random RANDOM
```
    A RANDOM instance. Prevent creation of many instances.
  - LINE_SEPARATOR
```
public static final String LINE_SEPARATOR
```
    The line separator as defined by the property line.separator.
  - TMP_DIR
```
public static final File TMP_DIR
```
    The file that represents the temporary directory. Usually, it is /tmp on Unix platform and C:/TMP on MS Windows.
  - DAY
```
public static final long DAY
```
    Number of milleseconds in a given day
    
    See Also:
    Constant Field Values
- Method Detail
  - getUniqueId
```
public static String getUniqueId(String prefix)
```
    Generate a unique identifier prefixed by the given String.
    
    Parameters:
    prefix - the prefix String
    
    Returns:
    an UUID String prefixed by prefix
    See Also:
    UUID
  - getHumanReadableId
```
public static String getHumanReadableId(String prefix)
```
    Generates a human readable id prefixed by the given String. The generated identifier is unique only for the duration of the existence of this class.
    
    Parameters:
    prefix - the string prefiy
    
    Returns:
    a human readable id prefixed by prefix.
  - getHumanReadableId
```
public static long getHumanReadableId()
```
    Generates a human readable id as a long. The generated identifier is unique only for the duration of the existence of this class.
    
    Returns:
    a unique id as a long.
  - random
```
public static int random(int min,
         int max)
```
    Returns a random number between min and max value
    
    Parameters:
    min - a positive integer
    max - a positive integer
    
    Returns:
    a random number between min and max value
    
    Throws:
    
    IllegalArgumentException - if min >= max
  - getRandomString
```
public static String getRandomString(int size)
```
    Generate a RANDOM String of the given size.
    
    Parameters:
    size - the size of the generated string
    
    Returns:
    the RANDOM String
  - formatDelay
```
public static final String formatDelay(long delay)
```
    Format a delay.
    
    This method returns a human readable string for delay such as the one used in benchmarks. This method is thread safe.
    
    Parameters:
    delay - a long value
    
    Returns:
    a String value
  - formatDelay
```
public static final String formatDelay(double delay)
```
    Equivalent to formatDelay(long).
    
    Parameters:
    delay - a double value
    
    Returns:
    a String value
  - findAllTypes
```
public static Set<Class<?>> findAllTypes(Class<?> type)
```
    Return the list of Class objects representing every types a given class implements.
    
    Parameters:
    type - a Class value
    
    Returns:
    a Set value
  - getGenericFullName
```
public static String getGenericFullName(Class<?> clazz)
```
    Return the generic name of a given class. For example, given java.util.Map.class, it returns string java.util.Map
    
    Parameters:
    clazz - the class
    
    Returns:
    the generic name of a given class.
  - findAllSuperTypes
```
public static Set<Class<?>> findAllSuperTypes(Class<?> type)
```
    Return the list of Class objects representing all super type a given class implements.
    
    Parameters:
    type - a Class value
    
    Returns:
    a Set value
  - findAllInterfaces
```
public static Set<Class<?>> findAllInterfaces(Class<?> type)
```
    Return the list of Class objects representing all interfaces a given class implements.
    
    Parameters:
    type - a Class value
    
    Returns:
    a List value
  - findMethodClassArgs
```
public static Class<?>[] findMethodClassArgs(Class<?>[] subClasses,
                             Class<?> classToTest,
                             String methodName)
                                      throws NoSuchMethodException
```
    Return the Class[] array representing the types a given method take as parameters.
    
    Parameters:
    subClasses - the classes which are to be subclasses of parameters
    classToTest - the class which declares the given method
    methodName - the method name
    
    Returns:
    the formal parameters class array
    
    Throws:
    
    NoSuchMethodException - if a method cannot be found.
  - findConstructorClassArgs
```
public static Class<?>[] findConstructorClassArgs(Class<?>[] subClasses,
                                  Class<?> classToTest)
                                           throws NoSuchMethodException
```
    Return the Class[] array representing the types a constructor take as parameters.
    
    Parameters:
    subClasses - the classes which are to be subclasses of parameters
    classToTest - the class which declares the constructor
    
    Returns:
    the formal parameters class array
    
    Throws:
    
    NoSuchMethodException - if a constructor cannot be found
  - identityToString
```
public static String identityToString(Object o)
```
    Return an "identity string" for a given object.
    
    The string returned is:
    - "null" if o == null
    - Otherwize, o.getClass().getName() + "#" + System.identityHashCode(o)
    Parameters: o - the object to return the identity string of Returns: the identity string as defined above
  componentsToString public static String componentsToString(Object[] args, boolean deepToString) Smart toString() implementation of arrays. Parameters: args - the array to return a smart string of. Returns: the smart string of the given array. primitiveComponentsToString public static String primitiveComponentsToString(Object array) Smart toString() implementation of an array of primitive types. Parameters: array - the array to return a smart string of. Returns: the smart string of the given array. getAllContentFrom public static byte[] getAllContentFrom(File file) throws IOException Equivalent to getAllContentFrom(new FileInputStream(file)); Parameters: file - the file to read Returns: the whole content of the file in a single String. Throws: IOException - If an I/O exception occured getDirContentFrom public static Map<String,byte[]> getDirContentFrom(File dir) throws IOException Get all files in this directory. Files in sub-directories are added too. Parameters: dir - Returns: a map containing: relative path of the file (relative to dir) as key, content of file as value. Throws: IOException getAllContentFrom public static byte[] getAllContentFrom(InputSource source) throws IOException Equivalent to getAllContentFrom(source.getByteStream(source)); Parameters: file - the file to read Returns: the whole content of the file in a single String. Throws: IOException - If an I/O exception occured getAllContentFrom public static byte[] getAllContentFrom(URL url) throws IOException Return the whole underlying stream content into a single String. Warning: the whole content of stream will be kept in memory!! Use with care! Parameters: in - the stream to read Returns: the whole content of the stream in a single String. Throws: IOException - if an I/O exception occured getAllContentFrom public static byte[] getAllContentFrom(InputStream in) throws IOException Return the whole underlying stream content into a single String. Warning: the whole content of stream will be kept in memory!! Use with care! Parameters: in - the stream to read Returns: the whole content of the stream in a single String. Throws: IOException - if an I/O exception occured getAllContentFrom public static byte[] getAllContentFrom(Reader in) throws IOException Return the whole underlying stream content into a single String. Warning: the whole content of stream will be kept in memory!! Use with care! Parameters: in - the stream to read Returns: the whole content of the stream in a single String. Throws: IOException - if an I/O exception occured close public static Exception close(Closeable closeable) Equivalent to #reflectClose(closeable) close public static Exception close(XMLEncoder encoder) Equivalent to {@link #reflectClose(encoder) close public static Exception close(XMLDecoder decoder) Equivalent to {@link #reflectClose(decoder) reflectClose public static Exception reflectClose(Object o) Invoke the close() method on the given object. This method uses the reflection API to find a close() method with no arguments. Any exception thrown (including NoSuchMethodException) will be both logged using LOG and returned. If the parameter is null, nothing is done and null is returned. Parameters: o - the object to call the close() method on. Returns: the exception thrown if any, null otherwise. getPermissionsSize public static int getPermissionsSize(Permissions permissions) Parameters: permissions - Returns: getMBeanProxy public static <T> T getMBeanProxy(Class<T> mbeanInterface, String jmxServiceUrl, String jmxObjectName) throws IOException, MalformedObjectNameException, InstanceNotFoundException, MBeanException, ReflectionException Return a proxy implementing all the interfaces specified that forward method invocations to the specified MBean. Type Parameters: T - Parameters: mbeanInterface - the interface the proxy should implement (the MBean should obviously also implement that interface). jmxServiceUrl - the JMX service URL jmxObjectName - the name the MBean has been registered to Returns: a proxy implementing the specified interface and that forward method invocations to the specified MBean. Throws: IOException - for any IO problem MalformedObjectNameException - for any JMX Naming problem MBeanException - for any MBean problem ReflectionException - for any problem related to reflection InstanceNotFoundException getChainOf public static <T> T getChainOf(List<T> elements) Return a proxy that forward void-method invocations to each object specified in the list elements. The invocation order follows the given list order. Type Parameters: T - the interface type of the returned proxy and of each elements. Parameters: elements - the elements to forward method invocations to Returns: the forwarding chaining proxy See Also: Chainer, InvocationHandler, Proxy getLoggerProxyFor public static <T> T getLoggerProxyFor(T target, Logger logger) Return a proxy that log method invocations through the provided logger. Type Parameters: T - the target object type Parameters: target - the target object method invocations should be forwarded to logger - the logger to use for logging Returns: a proxy that log method invocations through the provided logger. See Also: LoggingInvocationHandler, InvocationHandler, Proxy findNull public static Misc.NullCheckResult findNull(Object... params) Find null parameters in the given list. This method returns a Misc.NullCheckResult. Parameters: params - the parameters to check Returns: a Misc.NullCheckResult representing null parameters. See Also: Misc.NullCheckResult checkArgsNotNull public static void checkArgsNotNull(Object... params) Check that the given parameters are not null. This method should only be used to check that some parameters given to a given method are not null. The exception message tries its best to produce a helpful message by scanning the stack trace. Parameters: params - the parameters to check Throws: an - IllegalArgumentException if at least one of the parameters is null checkArgsNotNull public static void checkArgsNotNull(int offset, Object... params) Check that the given parameters are not null. This method should only be used to check that some parameters given to a given method are not null. The exception message tries its best to produce a helpful message by scanning the stack trace. Parameters: offset - the offset to use in the stack trace to produce error message params - the parameters to check Throws: an - IllegalArgumentException if at least one of the parameters is null getCaller public static StackTraceElement getCaller(int offset) Return the StackTraceElement at the given offset from this method invocation. Parameters: offset - Returns: a StackTraceElement getStringFrom public static List<String> getStringFrom(Misc.NullCheckResult nullCheckResult, String... names) Return strings mapped to null values in a given @{link Misc.NullCheckResult. . If the returned @{link List} of String is called l then, it verifies: l.contains(names[i]) if and only if nullCheckResult.isNull(i) returns true. Note that the number of String names given should be of the same size that the one used to get the given Misc.NullCheckResult using findNull(Object...). An IllegalArgumentException is thrown otherwise. Parameters: nullCheckResult - the result as returned by findNull(Object...) names - the strings that should be mapped to null values Returns: a List of string mapped to the given Misc.NullCheckResult. Throws: IllegalArgumentException - if the number of given names is different that NullCheckResult#size() See Also: findNull(Object...), Misc.NullCheckResult badStateIfNull public static void badStateIfNull(Object valueToCheck, String msg) This method throw an IllegalStateException if the given parameter is null Parameters: valueToCheck - the value to check msg - the message for the thrown exception See Also: IllegalStateException badStateIfNotNull public static void badStateIfNotNull(Object valueToCheck, String msg) This method throw an IllegalStateException if the given parameter is not null Parameters: valueToCheck - the value to check msg - the message for the thrown exception See Also: IllegalStateException badStateIfTrue public static void badStateIfTrue(boolean valueToCheck, String msg) This method throw an IllegalStateException if the given parameter is true Parameters: valueToCheck - the value to check msg - the message for the thrown exception See Also: IllegalStateException badStateIfFalse public static void badStateIfFalse(boolean valueToCheck, String msg) This method throw an IllegalStateException if the given parameter is false Parameters: valueToCheck - the value to check msg - the message for the thrown exception See Also: IllegalStateException badStateIfEquals public static void badStateIfEquals(Object a, Object b, String msg) This method throw an IllegalStateException if the given parameters are equals (using Object.equals(Object) Parameters: a - the first object b - the second object msg - the message for the thrown exception See Also: IllegalStateException dynamicLog public static void dynamicLog(int offset, Level level, String msg, Object... args) Log a message through the logger of the caller at the given offset in the stack trace. If A.f() calls B.g() that finally calls dynamicLog(1, msg) then, the msg will be logged with a code similar to: Logger.getLogger(B.getClass().getName()).log(level, msg); If the call was dynamicLog(2, msg) then, the code would be similar to: Logger.getLogger(A.getClass().getName()).log(level, msg); Note that even if the message construction (using String.format(String, Object...) is done only when Logger.isLoggable(Level) returns true for efficiency reasons, this method tries to find the caller (in order to get the Logger) using string comparisons in the caller stack trace. Therefore, it might not be as efficient as one would like it to be! ;-) (Note that a profiler should always be used to determine potential bottlenecks! Remember the Pareto principle: 80% of the time in spent in only 20% of the code). If you found (by profiling, as advised, or by just guessing as often ;-)) that this method is far too slow for your application, use the fastDynamicLog(int, Logger, Level, String, Object...) where the Logger is given directly. Parameters: offset - the offset in the stack trace where the caller should be found (to get the Logger) level - the level to log the message to msg - the string to use when calling String.format(String, Object...) in order to create the final message args - the parameters to use when calling String.format(String, Object...) in order to create the final message slowLog public static void slowLog(Level level, String msg, Object... args) Equivalent to Misc.dynamicLog(2, level, msg, args) See Also: dynamicLog(int, Level, String, Object...) createLogRecord public static LogRecord createLogRecord(Logger logger, Level level, String className, String methodName, String msg, Object... args) This method creates a LogRecord and fills it with the given parameters Parameters: logger - the logger to set the LogRecord.setLoggerName(String) to. level - the level to set the LogRecord.setLevel(Level) to. className - the class name to set the LogRecord.setSourceClassName(String) to. methodName - the method name to set the LogRecord.setSourceMethodName(String) to. msg - the string to use when calling String.format(String, Object...) in order to create the message passed to LogRecord.setMessage(String). args - the parameters to use when calling String.format(String, Object...) in order to create the message passed to LogRecord.setMessage(String). Returns: a LogRecord filled, ready to be logged. fastDynamicLog public static void fastDynamicLog(int offset, Logger logger, Level level, String msg, Object... args) Log a message through the given logger for the caller at the given offset in the stack trace. This method is similar to dynamicLog(int, Level, String, Object...) except that it does not have to search for the Logger. Therefore, it can check directly the result of Logger.isLoggable(Level) preventing the call to getCaller(int) (used to get the class name and the method name of the caller) and to String.format(String, Object...) (to create the actual message) which may be time consuming. Parameters: offset - the offset in the stack trace where the caller should be found level - the level to log the message to msg - the string to use when calling String.format(String, Object...) in order to create the final message args - the parameters to use when calling String.format(String, Object...) in order to create the final message fastDynamicLog public static void fastDynamicLog(Logger logger, Level level, String msg, Object... args) Equivalent to Misc.fastDynamicLog(2, logger, level, msg, args) See Also: fastDynamicLog(int, Logger, Level, String, Object...) warnIfNull public static void warnIfNull(Level level, Object valueToCheck, String variableName) This method logs at the given level a "warning message" if the given parameter is null Parameters: level - a log level valueToCheck - the value to check variableName - the variable name holding valueToCheck. Can be null. warnIfNotNull public static void warnIfNotNull(Level level, Object valueToCheck, String variableName) This method logs at the given level a "warning" if the given parameter is not null Parameters: level - a log level valueToCheck - the value to check variableName - the variable name holding valueToCheck. Can be null. warnIfTrue public static void warnIfTrue(Level level, boolean valueToCheck, String variableName) This method logs at the given level a "warning" if the given parameter is true Parameters: level - a log level valueToCheck - the value to check variableName - the variable name holding valueToCheck. Can be null. warnIfFalse public static void warnIfFalse(Level level, boolean valueToCheck, String variableName) This method logs at the given level a "warning" if the given parameter is false Parameters: level - a log level valueToCheck - the value to check variableName - the variable name holding valueToCheck. Can be null. warnIfEquals public static void warnIfEquals(Level level, Object a, Object b) This method logs at the given level a "warning" if the given parameter are equals Parameters: level - a log level a - an object b - another object warnIfNotEquals public static void warnIfNotEquals(Level level, Object a, Object b) This method logs at the given level a "warning" if the given parameter are not equals Parameters: level - a log level a - an object b - another object getCurrentThreadStackTrace public static String getCurrentThreadStackTrace() getStackTraceFrom public static String getStackTraceFrom(Throwable t) getStackTraceFrom public static StringBuilder getStackTraceFrom(StackTraceElement[] stes) deepToString public static String deepToString(Object o) deleteDir public static boolean deleteDir(File dir) Delete a given directory and all its contents (whether they are file or directory) WARNING: this method unconditionally modifies the underlying filesystem by erasing files and directories. Use with care! Parameters: dir - the directory to delete unreachableStatement public static void unreachableStatement() unreachableStatement public static void unreachableStatement(String reason) stringToEnum public static <E extends Enum<E>> E stringToEnum(Class<E> c, String s) serialize public static byte[] serialize(Serializable object) throws IOException, ClassNotFoundException Throws: IOException ClassNotFoundException deserialize public static Serializable deserialize(byte[] buf) throws IOException, ClassNotFoundException Throws: IOException ClassNotFoundException checkReallySerializable public static <T extends Serializable> Exception checkReallySerializable(T object) Check that the given object is actually serializable. Implementation tries to serialize and deserialize the given object (in memory). Note that null is returned when the given object is serializable. It returns the exception thrown by either the serialization or the deserialization process. This means, that the object is not really serializable. Therefore the pattern for checking should be written like: final Exception error = checkReallySerializable(myObject); if (error == null) { // success } else { // failure, do something with error... error.printStackTrace(); } Type Parameters: T - A type (usually extending Serializable Parameters: object - the object to check Returns: null on success, the exception thrown on error write public static void write(String s, File f) throws IOException Write the given String to the given file using the default encoding. Parameters: s - the string to be written f - the file to write the given string to Throws: IOException - if an IO error is encoutered (file not found, read-only file, and so on). write public static void write(byte[] fileContent, File file) throws IOException Throws: IOException createTempFile public static File createTempFile(String prefix, String suffix, File directory) throws IOException Perform java.io.File.createTempFile with retries when it fail (limit of 10 retries) (Use to by-pass bug #6325169 on SUN JDK 1.5 on windows) Sames parameter as File.createTempFile method Parameters: prefix - Prefix of the file suffix - Suffix of the file directory - Target directory Returns: An abstract pathname denoting a newly-created empty file Throws: IOException - If a file could not be created generateJar public static byte[] generateJar(Class<?>... classes) throws IOException Throws: IOException getResources public static Map<String,byte[]> getResources(Class<?>... classes) throws IOException Throws: IOException generateJar public static byte[] generateJar(Map<String,byte[]> resources) throws IOException Generates Jar from resources Parameters: resources: - map of resources: key is the file name, value the content. Returns: content of generated jar. Throws: IOException getResourcesFromZip public static Map<String,byte[]> getResourcesFromZip(byte[] zipContent) throws IOException Throws: IOException lookup public static <T> T lookup(String name, Properties environment) throws NamingException Throws: NamingException prefixAllLines public static String prefixAllLines(String message, String prefix) Return a new string based on the given message string where all lines are prefixed by the given prefix. Parameters: message - the message to transform prefix - the prefix to use Returns: the prefixed string

Class Misc

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

RANDOM

LINE_SEPARATOR

TMP_DIR

DAY

Method Detail

getUniqueId

getHumanReadableId

getHumanReadableId

random

getRandomString

formatDelay

formatDelay

findAllTypes

getGenericFullName

findAllSuperTypes

findAllInterfaces

findMethodClassArgs

findConstructorClassArgs

identityToString

componentsToString

primitiveComponentsToString

getAllContentFrom

getDirContentFrom

getAllContentFrom

getAllContentFrom

getAllContentFrom

getAllContentFrom

close

close

close

reflectClose

getPermissionsSize

getMBeanProxy

getChainOf

getLoggerProxyFor

findNull

checkArgsNotNull

checkArgsNotNull

getCaller

getStringFrom

badStateIfNull

badStateIfNotNull

badStateIfTrue

badStateIfFalse

badStateIfEquals

dynamicLog

slowLog

createLogRecord

fastDynamicLog

fastDynamicLog

warnIfNull

warnIfNotNull

warnIfTrue

warnIfFalse

warnIfEquals

warnIfNotEquals

getCurrentThreadStackTrace

getStackTraceFrom

getStackTraceFrom

deepToString

deleteDir

unreachableStatement

unreachableStatement

stringToEnum

serialize

deserialize

checkReallySerializable

write

write

createTempFile

generateJar

getResources

generateJar

getResourcesFromZip