Package fmpp.util

Class MiscUtil

java.lang.Object

fmpp.util.MiscUtil

public class MiscUtil
extends Object

Miscellaneous utility methods.

Field Summary

Fields

Modifier and Type	Field	Description
static final Class[]	EMPTY_CLASS_ARRAY
static final Object[]	EMPTY_OBJECT_ARRAY
static final String[]	EMPTY_STRING_ARRAY

Constructor Summary

Constructors

Constructor	Description
MiscUtil()

Method Summary

Modifier and Type	Method	Description
static String[]	add(String[] a1, String[] a2)	Concatenates two arrays.
static String	causeMessages(Throwable e)	This is the same as causeTrace(java.lang.Throwable), but it doesn't print the exception class name if the class is inside an fmpp package.
static String	causeTrace(Throwable e)	Returns the cause trace of an exception.
static void	checkXmlSupportAvailability(String requiredForThis)	Checks if XML API-s (JAXP, SAX2, DOM) are present.
static Class	classForName(String className)	Tries to load the class with the current context class loader, and only then with the current defining class loader.
static Map	dictionaryToMap(Dictionary dict)
static int	findObject(List list, Object o)	Returns the first index of the given object (exactly the same instance) in the list.
static Throwable	getCauseException(Throwable e)
static boolean	listContainsObject(List<?> list, Object o)	Checks if the list contains the given object (exactly the same instance).
static boolean	mapContainsObject(Map<?,?> map, Object o)	Checks if the map contains the given object (exactly the same instance) as value.
static int	numberToInt(Number value)	Loseless convertion to int.

Methods inherited from class java.lang.Object

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

Field Details

EMPTY_CLASS_ARRAY

public static final Class[] EMPTY_CLASS_ARRAY

EMPTY_OBJECT_ARRAY

public static final Object[] EMPTY_OBJECT_ARRAY

EMPTY_STRING_ARRAY

public static final String[] EMPTY_STRING_ARRAY

Constructor Details

MiscUtil

public MiscUtil()

Method Details

causeMessages

public static String causeMessages(Throwable e)

This is the same as causeTrace(java.lang.Throwable), but it doesn't print the exception class name if the class is inside an fmpp package.

causeTrace

public static String causeTrace(Throwable e)

Returns the cause trace of an exception. This is similar to a J2SE 1.4+ stack-trace, but it's shorter, because it does not contain the "at" lines.

classForName

public static Class classForName(String className)
                          throws ClassNotFoundException

Tries to load the class with the current context class loader, and only then with the current defining class loader.

Throws:

ClassNotFoundException

dictionaryToMap

public static Map dictionaryToMap(Dictionary dict)

getCauseException

public static Throwable getCauseException(Throwable e)

listContainsObject

public static boolean listContainsObject(List<?> list,
 Object o)

Checks if the list contains the given object (exactly the same instance).

mapContainsObject

public static boolean mapContainsObject(Map<?,?> map,
 Object o)

Checks if the map contains the given object (exactly the same instance) as value.

findObject

public static int findObject(List list,
 Object o)

Returns the first index of the given object (exactly the same instance) in the list.

Returns:

the index of the first occurrence, or -1 if not found.

checkXmlSupportAvailability

public static void checkXmlSupportAvailability(String requiredForThis)
                                        throws InstallationException

Checks if XML API-s (JAXP, SAX2, DOM) are present. Can be a bit slow depending on the actual class loader setup.

Parameters:

requiredForThis - a short sentence that describes for human reader if for what do we need the XML support (e.g. "Usage of xml data loader." or "Set XML entity resolver."). This sentence is used in error message of the InstallationException. Can be null.

Throws:

InstallationException

numberToInt

public static int numberToInt(Number value)

Loseless convertion to int.

Throws:

IllegalArgumentException - if the loseless conversion is not possible. The error message contains the details.

add

public static String[] add(String[] a1,
 String[] a2)

Concatenates two arrays.