Util (JBoss Application Server: Build 7.1.2.Final API)

java.lang.Object
- org.infinispan.util.Util

```
public final class Util
extends Object
```
General utility methods used throughout the Infinispan code base.

Since:

4.0

Author:

Brian Stansberry, Galder ZamarreÃ±o

Field Summary

Fields
Modifier and Type Field and Description

static Object[] EMPTY_OBJECT_ARRAY

Fields
Modifier and Type	Field and Description
`static Object[]`	`EMPTY_OBJECT_ARRAY`

Method Summary

Methods
Modifier and Type	Method and Description
`static <T> Set<T>`	`asSet(T... a)`
`static <T> T`	`cloneWithMarshaller(Marshaller marshaller, T x)` Clones parameter x of type T with a given Marshaller reference;
`static void`	`close(Closeable... cls)`
`static void`	`close(Closeable cl)`
`static void`	`close(Context ctx)`
`static void`	`close(Socket s)`
`static Double`	`constructDouble(Class<?> type, Object o)`
`static long`	`currentMillisFromNanotime()` `System.nanoTime()` is less expensive than `System.currentTimeMillis()` and better suited to measure time intervals.
`static void`	`flushAndCloseOutput(ObjectOutput o)`
`static void`	`flushAndCloseStream(OutputStream o)`
`static String`	`formatString(Object message, Object... params)`
`static ClassLoader[]`	`getClassLoaders(ClassLoader appClassLoader)`
`static <T> T`	`getInstance(Class<T> clazz)` Instantiates a class by first attempting a static factory method named `getInstance()` on the class and then falling back to an empty constructor.
`static <T> T`	`getInstance(String classname, ClassLoader cl)` Instantiates a class based on the class name provided.
`static <T> T`	`getInstanceStrict(Class<T> clazz)` Similar to `getInstance(Class)` except that exceptions are propagated to the caller.
`static <T> T`	`getInstanceStrict(String classname, ClassLoader cl)` Similar to `getInstance(String, ClassLoader)` except that exceptions are propagated to the caller.
`static int`	`getNormalizedHash(Object key, Hash hashFct)`
`static String`	`hexDump(byte[] buffer)`
`static String`	`hexDump(ByteBuffer buffer)`
`static String`	`hexIdHashCode(Object o)` Prints the identity hash code of the object passed as parameter in an hexadecimal format in order to safe space.
`static <T> Class<T>`	`loadClass(String classname, ClassLoader cl)` Loads the specified class using the passed classloader, or, if it is `null` the Infinispan classes' classloader.
`static <T> Class<T>`	`loadClassStrict(String classname, ClassLoader userClassLoader)` Loads the specified class using the passed classloader, or, if it is `null` the Infinispan classes' classloader.
`static String`	`padString(String s, int minWidth)`
`static String`	`prettyPrintTime(long millis)` Prints a time for display
`static String`	`prettyPrintTime(long time, TimeUnit unit)`
`static String`	`printArray(byte[] array, boolean withHash)`
`static CacheException`	`rewrapAsCacheException(Throwable t)`
`static boolean`	`safeEquals(Object a, Object b)` Null-safe equality test.
`static String`	`threadDump()`
`static String`	`toHexString(byte[] input)`
`static String`	`toHexString(byte[] input, int limit)`

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

- Field Detail
  - EMPTY_OBJECT_ARRAY
```
public static final Object[] EMPTY_OBJECT_ARRAY
```
- Method Detail
  - loadClass
```
public static <T> Class<T> loadClass(String classname,
                     ClassLoader cl)
```
    Loads the specified class using the passed classloader, or, if it is null the Infinispan classes' classloader.
    
    If loadtime instrumentation via GenerateInstrumentedClassLoader is used, this class may be loaded by the bootstrap classloader.
    
    If the class is not found, the ClassNotFoundException or NoClassDefFoundError is wrapped as a CacheConfigurationException and is re-thrown.
    
    Parameters:
    classname - name of the class to load
    cl - the application classloader which should be used to load the class, or null if the class is always packaged with Infinispan
    
    Returns:
    the class
    
    Throws:
    
    CacheConfigurationException - if the class cannot be loaded
  - getClassLoaders
```
public static ClassLoader[] getClassLoaders(ClassLoader appClassLoader)
```
  - loadClassStrict
```
public static <T> Class<T> loadClassStrict(String classname,
                           ClassLoader userClassLoader)
                                throws ClassNotFoundException
```
    Loads the specified class using the passed classloader, or, if it is null the Infinispan classes' classloader.
    
    If loadtime instrumentation via GenerateInstrumentedClassLoader is used, this class may be loaded by the bootstrap classloader.
    
    Parameters:
    classname - name of the class to load
    userClassLoader - the application classloader which should be used to load the class, or null if the class is always packaged with Infinispan
    
    Returns:
    the class
    
    Throws:
    
    ClassNotFoundException - if the class cannot be loaded
  - getInstance
```
public static <T> T getInstance(Class<T> clazz)
```
    Instantiates a class by first attempting a static factory method named getInstance() on the class and then falling back to an empty constructor.
    Any exceptions encountered are wrapped in a CacheConfigurationException and rethrown.
    
    Parameters:
    clazz - class to instantiate
    
    Returns:
    an instance of the class
  - getInstanceStrict
```
public static <T> T getInstanceStrict(Class<T> clazz)
                           throws IllegalAccessException,
                                  InstantiationException
```
    Similar to getInstance(Class) except that exceptions are propagated to the caller.
    
    Parameters:
    clazz - class to instantiate
    
    Returns:
    an instance of the class
    
    Throws:
    
    IllegalAccessException
    
    InstantiationException
  - getInstance
```
public static <T> T getInstance(String classname,
                ClassLoader cl)
```
    Instantiates a class based on the class name provided. Instantiation is attempted via an appropriate, static factory method named getInstance() first, and failing the existence of an appropriate factory, falls back to an empty constructor.
    Any exceptions encountered loading and instantiating the class is wrapped in a CacheConfigurationException.
    
    Parameters:
    classname - class to instantiate
    
    Returns:
    an instance of classname
  - getInstanceStrict
```
public static <T> T getInstanceStrict(String classname,
                      ClassLoader cl)
                           throws ClassNotFoundException,
                                  InstantiationException,
                                  IllegalAccessException
```
    Similar to getInstance(String, ClassLoader) except that exceptions are propagated to the caller.
    
    Parameters:
    classname - class to instantiate
    
    Returns:
    an instance of classname
    
    Throws:
    
    ClassNotFoundException
    
    InstantiationException
    
    IllegalAccessException
  - cloneWithMarshaller
```
public static <T> T cloneWithMarshaller(Marshaller marshaller,
                        T x)
```
    Clones parameter x of type T with a given Marshaller reference;
    
    Returns:
    a deep clone of an object parameter x
  - safeEquals
```
public static boolean safeEquals(Object a,
                 Object b)
```
    Null-safe equality test.
    
    Parameters:
    a - first object to compare
    b - second object to compare
    
    Returns:
    true if the objects are equals or both null, false otherwise.
  - prettyPrintTime
```
public static String prettyPrintTime(long time,
                     TimeUnit unit)
```
  - currentMillisFromNanotime
```
public static final long currentMillisFromNanotime()
```
    System.nanoTime() is less expensive than System.currentTimeMillis() and better suited to measure time intervals. It's NOT suited to know the current time, for example to be compared with the time of other nodes.
    
    Returns:
    the value of System.nanoTime(), but converted in Milliseconds.
  - prettyPrintTime
```
public static String prettyPrintTime(long millis)
```
    Prints a time for display
    
    Parameters:
    millis - time in millis
    
    Returns:
    the time, represented as millis, seconds, minutes or hours as appropriate, with suffix
  - close
```
public static void close(Closeable cl)
```
  - close
```
public static void close(Socket s)
```
  - close
```
public static void close(Closeable... cls)
```
  - close
```
public static void close(Context ctx)
```
  - flushAndCloseStream
```
public static void flushAndCloseStream(OutputStream o)
```
  - flushAndCloseOutput
```
public static void flushAndCloseOutput(ObjectOutput o)
```
  - formatString
```
public static String formatString(Object message,
                  Object... params)
```
  - printArray
```
public static String printArray(byte[] array,
                boolean withHash)
```
  - toHexString
```
public static String toHexString(byte[] input)
```
  - toHexString
```
public static String toHexString(byte[] input,
                 int limit)
```
  - padString
```
public static String padString(String s,
               int minWidth)
```
  - threadDump
```
public static String threadDump()
```
  - rewrapAsCacheException
```
public static CacheException rewrapAsCacheException(Throwable t)
```
  - asSet
```
public static <T> Set<T> asSet(T... a)
```
  - hexIdHashCode
```
public static String hexIdHashCode(Object o)
```
    Prints the identity hash code of the object passed as parameter in an hexadecimal format in order to safe space.
  - hexDump
```
public static String hexDump(byte[] buffer)
```
  - hexDump
```
public static String hexDump(ByteBuffer buffer)
```
  - constructDouble
```
public static Double constructDouble(Class<?> type,
                     Object o)
```
  - getNormalizedHash
```
public static int getNormalizedHash(Object key,
                    Hash hashFct)
```

Class Util

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_OBJECT_ARRAY

Method Detail

loadClass

getClassLoaders

loadClassStrict

getInstance

getInstanceStrict

getInstance

getInstanceStrict

cloneWithMarshaller

safeEquals

prettyPrintTime

currentMillisFromNanotime

prettyPrintTime

close

close

close

close

flushAndCloseStream

flushAndCloseOutput

formatString

printArray

toHexString

toHexString

padString

threadDump

rewrapAsCacheException

asSet

hexIdHashCode

hexDump

hexDump

constructDouble

getNormalizedHash