org.jboss.portal.common.util
Class Tools

java.lang.Object
  org.jboss.portal.common.util.Tools

public class Tools
extends java.lang.Object

Version:

$Revision: 7377 $

Author:

Julien Viet, Thomas Heute, Boleslaw Dawidowicz, Chris Laprun

Field Summary

static int	DEFAULT_BUFFER_SIZE
static java.util.ResourceBundle	EMPTY_BUNDLE
static java.util.Enumeration	EMPTY_ENUMERATION
static java.util.Iterator	EMPTY_ITERATOR
static Logger	log
static java.lang.String	VMID 16 chars long VMID.

Constructor Summary

Tools()

Method Summary

static java.lang.Object[]	appendTo(java.lang.Object[] array, java.lang.Object o) Append an object to an array of objects.
static java.lang.String	buildClassLoaderInfo(java.lang.ClassLoader loader)
static int	computeStringHash(int hash, java.lang.String s)
static boolean	confirmTemporaryHash(java.lang.String hash, java.lang.String value, long time)
static java.lang.String	dumpClassLoaderHierarchyInfo(java.lang.ClassLoader loader)
static void	dumpClassLoaderHierarchyInfo(Logger log, Level level, java.lang.ClassLoader loader)
static void	dumpClassLoaderHierarchyInfo(java.io.Writer writer, java.lang.ClassLoader loader)
static byte[]	fromHexString(java.lang.String hex) Returns a byte array converted from the hexadecimal format.
static java.lang.String	generateTemporaryHash(java.lang.String value, long time)
static java.lang.String	getPackageOf(java.lang.Class clazz)
static java.lang.String	getShortNameOf(java.lang.Class clazz)
static java.lang.String	hashAndEncodeString(java.lang.String text, java.lang.String algorithm, java.lang.String encoding) Computes a hash with specified algorighm and returns the result as a string in hexadecimal format
static boolean	isContainedIn(java.lang.Object value, java.lang.Object[] array) Determines if value is contained in array.
static java.util.Iterator	iterator(java.lang.Object o) Returns a singleton iterator.
static java.util.Iterator	iterator(java.lang.Object[] objects) Returns an iterator over the array elements.
static java.util.Iterator	iterator(java.lang.Object[] objects, int from, int to) Returns an iterator over the array elements within the specified range.
static byte[]	md5(java.lang.String text) Computes an md5 hash of a string.
static java.lang.String	md5AsHexString(java.lang.String text) Computes an md5 hash and returns the result as a string in hexadecimal format.
static java.lang.String	replace(java.lang.String string, java.lang.String pattern, java.lang.String replacement) Replace occurence in a string.
static java.lang.String	replaceAllInstancesOfBoundedString(java.lang.String initial, java.lang.String prefix, java.lang.String suffix, java.lang.String replacement)
static java.lang.String	replaceBoundedString(java.lang.String initial, java.lang.String prefix, java.lang.String suffix, java.lang.String replacement, boolean replaceIfBoundedStringEmpty, boolean keepBoundaries)
static boolean	safeEquals(java.lang.Object o1, java.lang.Object o2) Return true if o1 is null and o2 is nullequals(Object o) on o1 wit o2 as argument returns true
static java.lang.Object[]	toArray(java.util.Iterator i)
static java.util.Enumeration	toEnumeration(java.util.Iterator iterator)
static java.util.Enumeration	toEnumeration(java.lang.Object o)
static java.util.Enumeration	toEnumeration(java.lang.Object[] objects)
static java.lang.String	toHexString(byte[] bytes) Returns a string in the hexadecimal format.
static java.util.List	toList(java.util.Enumeration e)
static java.util.List	toList(java.util.Iterator iterator)
static java.util.List	toList(java.lang.Object[] objects)
static java.util.Set	toSet(java.util.Enumeration e)
static java.util.Set	toSet(java.util.Iterator iterator)
static java.util.Set	toSet(java.lang.Object[] objects)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE

See Also:

Constant Field Values

log

public static final Logger log

VMID

public static final java.lang.String VMID

16 chars long VMID.

EMPTY_ENUMERATION

public static final java.util.Enumeration EMPTY_ENUMERATION

EMPTY_ITERATOR

public static final java.util.Iterator EMPTY_ITERATOR

EMPTY_BUNDLE

public static final java.util.ResourceBundle EMPTY_BUNDLE

Constructor Detail

Tools

public Tools()

Method Detail

toEnumeration

public static java.util.Enumeration toEnumeration(java.util.Iterator iterator)

toEnumeration

public static java.util.Enumeration toEnumeration(java.lang.Object[] objects)

toEnumeration

public static java.util.Enumeration toEnumeration(java.lang.Object o)

toSet

public static java.util.Set toSet(java.util.Enumeration e)

toArray

public static java.lang.Object[] toArray(java.util.Iterator i)

toList

public static java.util.List toList(java.util.Enumeration e)

toSet

public static java.util.Set toSet(java.lang.Object[] objects)

toSet

public static java.util.Set toSet(java.util.Iterator iterator)

toList

public static java.util.List toList(java.lang.Object[] objects)

toList

public static java.util.List toList(java.util.Iterator iterator)

iterator

public static java.util.Iterator iterator(java.lang.Object o)

Returns a singleton iterator.

Parameters:

o - the singleton object

Returns:

the iterator

iterator

public static java.util.Iterator iterator(java.lang.Object[] objects)
                                   throws java.lang.IllegalArgumentException

Returns an iterator over the array elements.

Parameters:

objects - the array containing the objects to iterate on

Returns:

the iterator

Throws:

java.lang.IllegalArgumentException - if the object array is null or the specified range is not valid

iterator

public static java.util.Iterator iterator(java.lang.Object[] objects,
                                          int from,
                                          int to)
                                   throws java.lang.IllegalArgumentException

Returns an iterator over the array elements within the specified range.

Parameters:

objects - the array containing the objects to iterate on

from - the inclusive start index

to - the exclusive stop index

Returns:

the iterator

Throws:

java.lang.IllegalArgumentException - if the object array is null or the specified range is not valid

computeStringHash

public static int computeStringHash(int hash,
                                    java.lang.String s)

md5

public static byte[] md5(java.lang.String text)

Computes an md5 hash of a string.

Parameters:

text - the hashed string

Returns:

the string hash

Throws:

java.lang.NullPointerException - if text is null

md5AsHexString

public static java.lang.String md5AsHexString(java.lang.String text)

Computes an md5 hash and returns the result as a string in hexadecimal format.

Parameters:

text - the hashed string

Returns:

the string hash

Throws:

java.lang.NullPointerException - if text is null

hashAndEncodeString

public static java.lang.String hashAndEncodeString(java.lang.String text,
                                                   java.lang.String algorithm,
                                                   java.lang.String encoding)
                                            throws java.security.NoSuchAlgorithmException

Computes a hash with specified algorighm and returns the result as a string in hexadecimal format

Parameters:

text -

algorithm -

encoding -

Returns:

Throws:

java.security.NoSuchAlgorithmException

toHexString

public static java.lang.String toHexString(byte[] bytes)

Returns a string in the hexadecimal format.

Parameters:

bytes - the converted bytes

Returns:

the hexadecimal string representing the bytes data

Throws:

java.lang.IllegalArgumentException - if the byte array is null

fromHexString

public static byte[] fromHexString(java.lang.String hex)

Returns a byte array converted from the hexadecimal format.

Parameters:

hex - the string to convert

Returns:

the byte array corresponding

Throws:

java.lang.IllegalArgumentException - if the string is null or does not have the good format

generateTemporaryHash

public static java.lang.String generateTemporaryHash(java.lang.String value,
                                                     long time)

confirmTemporaryHash

public static boolean confirmTemporaryHash(java.lang.String hash,
                                           java.lang.String value,
                                           long time)

getShortNameOf

public static java.lang.String getShortNameOf(java.lang.Class clazz)

getPackageOf

public static java.lang.String getPackageOf(java.lang.Class clazz)

buildClassLoaderInfo

public static java.lang.String buildClassLoaderInfo(java.lang.ClassLoader loader)

dumpClassLoaderHierarchyInfo

public static java.lang.String dumpClassLoaderHierarchyInfo(java.lang.ClassLoader loader)

dumpClassLoaderHierarchyInfo

public static void dumpClassLoaderHierarchyInfo(java.io.Writer writer,
                                                java.lang.ClassLoader loader)

dumpClassLoaderHierarchyInfo

public static void dumpClassLoaderHierarchyInfo(Logger log,
                                                Level level,
                                                java.lang.ClassLoader loader)

replace

public static java.lang.String replace(java.lang.String string,
                                       java.lang.String pattern,
                                       java.lang.String replacement)

Replace occurence in a string.

Parameters:

string - the source string

pattern - the replaced pattern

replacement - the replacement text

Returns:

the new string

appendTo

public static java.lang.Object[] appendTo(java.lang.Object[] array,
                                          java.lang.Object o)
                                   throws java.lang.IllegalArgumentException,
                                          java.lang.ClassCastException

Append an object to an array of objects. The original array is not modified. The returned array will be of the same component type of the provided array and its first n elements where n is the size of the provided array will be the elements of the provided array. The last element of the array will be the provided object to append.

Parameters:

array - the array to augment

o - the object to append

Returns:

a new array

Throws:

java.lang.IllegalArgumentException - if the array is null

java.lang.ClassCastException - if the appended object class prevents it from being added to the array

safeEquals

public static boolean safeEquals(java.lang.Object o1,
                                 java.lang.Object o2)

Return true if

• o1 is null and o2 is nullo1 is not null and the invocation of equals(Object o) on o1 wit o2 as argument returns true

Parameters:

o1 - the first argument

o2 - the second argument

Returns:

if arguments are equals according to the semantic defined by the method contract

replaceAllInstancesOfBoundedString

public static java.lang.String replaceAllInstancesOfBoundedString(java.lang.String initial,
                                                                  java.lang.String prefix,
                                                                  java.lang.String suffix,
                                                                  java.lang.String replacement)

replaceBoundedString

public static java.lang.String replaceBoundedString(java.lang.String initial,
                                                    java.lang.String prefix,
                                                    java.lang.String suffix,
                                                    java.lang.String replacement,
                                                    boolean replaceIfBoundedStringEmpty,
                                                    boolean keepBoundaries)

isContainedIn

public static boolean isContainedIn(java.lang.Object value,
                                    java.lang.Object[] array)

Determines if value is contained in array.

Parameters:

value -

array -

Returns:

Since:

2.4.2