org.apache.camel.util
Class ObjectHelper

java.lang.Object
  org.apache.camel.util.ObjectHelper

public final class ObjectHelper
extends java.lang.Object

A number of useful helper methods for working with Objects

Version:

Method Summary

static java.lang.String	after(java.lang.String text, java.lang.String after)
static java.lang.String	asString(java.lang.Object[] objects) Turns the given object arrays into a meaningful string
static java.lang.String	before(java.lang.String text, java.lang.String before)
static java.lang.String	between(java.lang.String text, java.lang.String after, java.lang.String before)
static java.lang.String	capitalize(java.lang.String text)
static <T> T	cast(java.lang.Class<T> toType, java.lang.Object value) Converts the given value to the required type or throw a meaningful exception
static java.lang.String	classCanonicalName(java.lang.Object value) Returns the canonical type name of the given value
static java.lang.String	className(java.lang.Object value) Returns the type name of the given value
static void	close(java.io.Closeable closeable, java.lang.String name, org.slf4j.Logger log) Deprecated. will be removed in Camel 3.0. Instead use IOHelper.close(java.io.Closeable, String, org.slf4j.Logger) instead
static int	compare(java.lang.Object a, java.lang.Object b) A helper method for performing an ordered comparison on the objects handling nulls and objects which do not handle sorting gracefully
static int	compare(java.lang.Object a, java.lang.Object b, boolean ignoreCase) A helper method for performing an ordered comparison on the objects handling nulls and objects which do not handle sorting gracefully
static boolean	contains(java.lang.Object collectionOrArray, java.lang.Object value) Returns true if the collection contains the specified value
static java.lang.Class<?>	convertPrimitiveTypeToWrapperType(java.lang.Class<?> type) Converts primitive types such as int to its wrapper type like Integer
static java.util.Iterator<java.lang.Throwable>	createExceptionIterator(java.lang.Throwable exception) Creates an iterator to walk the exception from the bottom up (the last caused by going upwards to the root exception).
static java.util.Iterator<java.lang.Object>	createIterator(java.lang.Object value) Creates an iterator over the value if the value is a collection, an Object[] or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value Will default use comma for String separating String values.
static java.util.Iterator<java.lang.Object>	createIterator(java.lang.Object value, java.lang.String delimiter) Creates an iterator over the value if the value is a collection, an Object[] or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
static boolean	equal(java.lang.Object a, java.lang.Object b) A helper method for comparing objects for equality while handling nulls
static boolean	equalByteArray(byte[] a, byte[] b) A helper method for comparing byte arrays for equality while handling nulls
static boolean	evaluateValuePredicate(java.lang.Object value) Evaluate the value as a predicate which attempts to convert the value to a boolean otherwise true is returned if the value is not null
static java.util.List<java.lang.reflect.Method>	findMethodsWithAnnotation(java.lang.Class<?> type, java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Returns a list of methods which are annotated with the given annotation
static java.util.List<java.lang.reflect.Method>	findMethodsWithAnnotation(java.lang.Class<?> type, java.lang.Class<? extends java.lang.annotation.Annotation> annotationType, boolean checkMetaAnnotations) Returns a list of methods which are annotated with the given annotation
static java.util.Properties	getCamelPropertiesWithPrefix(java.lang.String prefix, CamelContext camelContext) A helper method to access a camel context properties with a prefix
static java.lang.String	getDefaultCharacterSet() Helper method to return the default character set name
static <T> T	getException(java.lang.Class<T> type, java.lang.Throwable exception) Retrieves the given exception type from the exception.
static java.lang.String	getIdentityHashCode(java.lang.Object object)
static java.lang.String	getPropertyName(java.lang.reflect.Method method) Returns the Java Bean property name of the given method, if it is a setter
static java.util.Scanner	getScanner(Exchange exchange, java.lang.Object value) Creates a Scanner for scanning the given value.
static boolean	getSystemProperty(java.lang.String name, java.lang.Boolean defaultValue) A helper method to access a boolean system property, catching any security exceptions
static java.lang.String	getSystemProperty(java.lang.String name, java.lang.String defaultValue) A helper method to access a system property, catching any security exceptions
static boolean	hasAnnotation(java.lang.reflect.AnnotatedElement elem, java.lang.Class<? extends java.lang.annotation.Annotation> annotationType, boolean checkMetaAnnotations) Checks if a Class or Method are annotated with the given annotation
static boolean	hasAnnotation(java.lang.annotation.Annotation[] annotations, java.lang.Class<?> type) Returns true if the given collection of annotations matches the given type
static boolean	hasDefaultPublicNoArgConstructor(java.lang.Class type) Does the given class have a default public no-arg constructor.
static java.lang.Object	invokeMethod(java.lang.reflect.Method method, java.lang.Object instance, java.lang.Object... parameters) A helper method to invoke a method via reflection and wrap any exceptions as RuntimeCamelException instances
static boolean	isAssignableFrom(java.lang.Class<?> a, java.lang.Class<?> b) Returns true if a class is assignable from another class like the Class.isAssignableFrom(Class) method but which also includes coercion between primitive types to deal with Java 5 primitive type wrapping
static boolean	isEmpty(java.lang.Object value) Tests whether the value is null or an empty string.
static boolean	isEqualToAny(java.lang.Object object, java.lang.Object... values) Returns true if the given object is equal to any of the expected value
static boolean	isJavaIdentifier(java.lang.String name) Returns true if the given name is a valid java identifier
static boolean	isNotEmpty(java.lang.Object value) Tests whether the value is not null or an empty string.
static boolean	isOverridingMethod(java.lang.reflect.Method source, java.lang.reflect.Method target) Tests whether the target method overrides the source method.
static java.lang.Class<?>	loadClass(java.lang.String name) Attempts to load the given class name using the thread context class loader or the class loader used to load this class
static java.lang.Class<?>	loadClass(java.lang.String name, java.lang.ClassLoader loader) Attempts to load the given class name using the thread context class loader or the given class loader
static java.lang.Class<?>	loadClass(java.lang.String name, java.lang.ClassLoader loader, boolean needToWarn) Attempts to load the given class name using the thread context class loader or the given class loader
static java.io.InputStream	loadResourceAsStream(java.lang.String name) Attempts to load the given resource as a stream using the thread context class loader or the class loader used to load this class
static java.net.URL	loadResourceAsURL(java.lang.String name) Attempts to load the given resource as a stream using the thread context class loader or the class loader used to load this class
static java.lang.Class<?>	loadSimpleType(java.lang.String name) Load a simple type
static java.lang.String	lookupConstantFieldValue(java.lang.Class clazz, java.lang.String name) Lookup the constant field on the given class with the given name
static boolean	matches(java.util.List list) Returns the predicate matching boolean on a List result set where if the first element is a boolean its value is used otherwise this method returns true if the collection is not empty
static java.lang.String	name(java.lang.Class<?> type) Returns the type name of the given type or null if the type variable is null
static <T> T	newInstance(java.lang.Class<?> actualType, java.lang.Class<T> expectedType) A helper method to create a new instance of a type using the default constructor arguments.
static <T> T	newInstance(java.lang.Class<T> type) A helper method to create a new instance of a type using the default constructor arguments.
static java.lang.String	normalizeClassName(java.lang.String name) Cleans the string to pure java identifier so we can use it for loading class names.
static void	notEmpty(java.lang.String value, java.lang.String name) Asserts whether the string is not empty.
static void	notEmpty(java.lang.String value, java.lang.String name, java.lang.Object on) Asserts whether the string is not empty.
static void	notNull(java.lang.Object value, java.lang.String name) Asserts whether the value is not null
static void	notNull(java.lang.Object value, java.lang.String name, java.lang.Object on) Asserts whether the value is not null
static java.lang.String	removeStartingCharacters(java.lang.String text, char ch) Removes any starting characters on the given text which match the given character
static java.lang.String[]	splitOnCharacter(java.lang.String value, java.lang.String needle, int count)
static java.lang.Boolean	toBoolean(java.lang.Object value)
static java.lang.Object	type(java.lang.Object bean) Returns the type of the given object or null if the value is null
static int	typeCoerceCompare(TypeConverter converter, java.lang.Object leftValue, java.lang.Object rightValue) A helper method for comparing objects ordering in which it uses type coerce to coerce types between the left and right values.
static boolean	typeCoerceEquals(TypeConverter converter, java.lang.Object leftValue, java.lang.Object rightValue) A helper method for comparing objects for equality in which it uses type coerce to coerce types between the left and right values.
static boolean	typeCoerceNotEquals(TypeConverter converter, java.lang.Object leftValue, java.lang.Object rightValue) A helper method for comparing objects for equality in which it uses type coerce to coerce types between the left and right values.
static CamelExecutionException	wrapCamelExecutionException(Exchange exchange, java.lang.Throwable e) Wraps the caused exception in a CamelExecutionException if its not already such an exception.
static RuntimeCamelException	wrapRuntimeCamelException(java.lang.Throwable e) Wraps the caused exception in a RuntimeCamelException if its not already such an exception.

Methods inherited from class java.lang.Object

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

Method Detail

typeCoerceEquals

public static boolean typeCoerceEquals(TypeConverter converter,
                                       java.lang.Object leftValue,
                                       java.lang.Object rightValue)

A helper method for comparing objects for equality in which it uses type coerce to coerce types between the left and right values. This allows you to equal test eg String and Integer as Camel will be able to coerce the types.

typeCoerceNotEquals

public static boolean typeCoerceNotEquals(TypeConverter converter,
                                          java.lang.Object leftValue,
                                          java.lang.Object rightValue)

A helper method for comparing objects for equality in which it uses type coerce to coerce types between the left and right values. This allows you to equal test eg String and Integer as Camel will be able to coerce the types

typeCoerceCompare

public static int typeCoerceCompare(TypeConverter converter,
                                    java.lang.Object leftValue,
                                    java.lang.Object rightValue)

A helper method for comparing objects ordering in which it uses type coerce to coerce types between the left and right values. This allows you to equal test eg String and Integer as Camel will be able to coerce the types

equal

public static boolean equal(java.lang.Object a,
                            java.lang.Object b)

A helper method for comparing objects for equality while handling nulls

equalByteArray

public static boolean equalByteArray(byte[] a,
                                     byte[] b)

A helper method for comparing byte arrays for equality while handling nulls

isEqualToAny

public static boolean isEqualToAny(java.lang.Object object,
                                   java.lang.Object... values)

Returns true if the given object is equal to any of the expected value

compare

public static int compare(java.lang.Object a,
                          java.lang.Object b)

A helper method for performing an ordered comparison on the objects handling nulls and objects which do not handle sorting gracefully

compare

public static int compare(java.lang.Object a,
                          java.lang.Object b,
                          boolean ignoreCase)

A helper method for performing an ordered comparison on the objects handling nulls and objects which do not handle sorting gracefully

Parameters:

a - the first object

b - the second object

ignoreCase - ignore case for string comparison

toBoolean

public static java.lang.Boolean toBoolean(java.lang.Object value)

notNull

public static void notNull(java.lang.Object value,
                           java.lang.String name)

Asserts whether the value is not null

Parameters:

value - the value to test

name - the key that resolved the value

Throws:

java.lang.IllegalArgumentException - is thrown if assertion fails

notNull

public static void notNull(java.lang.Object value,
                           java.lang.String name,
                           java.lang.Object on)

Asserts whether the value is not null

Parameters:

value - the value to test

on - additional description to indicate where this problem occurred (appended as toString())

name - the key that resolved the value

Throws:

java.lang.IllegalArgumentException - is thrown if assertion fails

notEmpty

public static void notEmpty(java.lang.String value,
                            java.lang.String name)

Asserts whether the string is not empty.

Parameters:

value - the string to test

name - the key that resolved the value

Throws:

java.lang.IllegalArgumentException - is thrown if assertion fails

notEmpty

public static void notEmpty(java.lang.String value,
                            java.lang.String name,
                            java.lang.Object on)

Asserts whether the string is not empty.

Parameters:

value - the string to test

on - additional description to indicate where this problem occurred (appended as toString())

name - the key that resolved the value

Throws:

java.lang.IllegalArgumentException - is thrown if assertion fails

isEmpty

public static boolean isEmpty(java.lang.Object value)

Tests whether the value is null or an empty string.

Parameters:

value - the value, if its a String it will be tested for text length as well

Returns:

true if empty

isNotEmpty

public static boolean isNotEmpty(java.lang.Object value)

Tests whether the value is not null or an empty string.

Parameters:

value - the value, if its a String it will be tested for text length as well

Returns:

true if not empty

splitOnCharacter

public static java.lang.String[] splitOnCharacter(java.lang.String value,
                                                  java.lang.String needle,
                                                  int count)

removeStartingCharacters

public static java.lang.String removeStartingCharacters(java.lang.String text,
                                                        char ch)

Removes any starting characters on the given text which match the given character

Parameters:

text - the string

ch - the initial characters to remove

Returns:

either the original string or the new substring

capitalize

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

after

public static java.lang.String after(java.lang.String text,
                                     java.lang.String after)

before

public static java.lang.String before(java.lang.String text,
                                      java.lang.String before)

between

public static java.lang.String between(java.lang.String text,
                                       java.lang.String after,
                                       java.lang.String before)

contains

public static boolean contains(java.lang.Object collectionOrArray,
                               java.lang.Object value)

Returns true if the collection contains the specified value

createIterator

public static java.util.Iterator<java.lang.Object> createIterator(java.lang.Object value)

Creates an iterator over the value if the value is a collection, an Object[] or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value

Will default use comma for String separating String values.

Parameters:

value - the value

Returns:

the iterator

createIterator

public static java.util.Iterator<java.lang.Object> createIterator(java.lang.Object value,
                                                                  java.lang.String delimiter)

Creates an iterator over the value if the value is a collection, an Object[] or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value

Parameters:

value - the value

delimiter - delimiter for separating String values

Returns:

the iterator

matches

public static boolean matches(java.util.List list)

Returns the predicate matching boolean on a List result set where if the first element is a boolean its value is used otherwise this method returns true if the collection is not empty

Returns:

true if the first element is a boolean and its value is true or if the list is non empty

getSystemProperty

public static java.lang.String getSystemProperty(java.lang.String name,
                                                 java.lang.String defaultValue)

A helper method to access a system property, catching any security exceptions

Parameters:

name - the name of the system property required

defaultValue - the default value to use if the property is not available or a security exception prevents access

Returns:

the system property value or the default value if the property is not available or security does not allow its access

getSystemProperty

public static boolean getSystemProperty(java.lang.String name,
                                        java.lang.Boolean defaultValue)

A helper method to access a boolean system property, catching any security exceptions

Parameters:

name - the name of the system property required

defaultValue - the default value to use if the property is not available or a security exception prevents access

Returns:

the boolean representation of the system property value or the default value if the property is not available or security does not allow its access

getCamelPropertiesWithPrefix

public static java.util.Properties getCamelPropertiesWithPrefix(java.lang.String prefix,
                                                                CamelContext camelContext)

A helper method to access a camel context properties with a prefix

Parameters:

prefix - the prefix

camelContext - the camel context

Returns:

the properties which holds the camel context properties with the prefix, and the key omit the prefix part

name

public static java.lang.String name(java.lang.Class<?> type)

Returns the type name of the given type or null if the type variable is null

className

public static java.lang.String className(java.lang.Object value)

Returns the type name of the given value

classCanonicalName

public static java.lang.String classCanonicalName(java.lang.Object value)

Returns the canonical type name of the given value

loadClass

public static java.lang.Class<?> loadClass(java.lang.String name)

Attempts to load the given class name using the thread context class loader or the class loader used to load this class

Parameters:

name - the name of the class to load

Returns:

the class or null if it could not be loaded

loadClass

public static java.lang.Class<?> loadClass(java.lang.String name,
                                           java.lang.ClassLoader loader)

Attempts to load the given class name using the thread context class loader or the given class loader

Parameters:

name - the name of the class to load

loader - the class loader to use after the thread context class loader

Returns:

the class or null if it could not be loaded

loadClass

public static java.lang.Class<?> loadClass(java.lang.String name,
                                           java.lang.ClassLoader loader,
                                           boolean needToWarn)

Attempts to load the given class name using the thread context class loader or the given class loader

Parameters:

name - the name of the class to load

loader - the class loader to use after the thread context class loader

needToWarn - when true logs a warning when a class with the given name could not be loaded

Returns:

the class or null if it could not be loaded

loadSimpleType

public static java.lang.Class<?> loadSimpleType(java.lang.String name)

Load a simple type

Parameters:

name - the name of the class to load

Returns:

the class or null if it could not be loaded

loadResourceAsStream

public static java.io.InputStream loadResourceAsStream(java.lang.String name)

Attempts to load the given resource as a stream using the thread context class loader or the class loader used to load this class

Parameters:

name - the name of the resource to load

Returns:

the stream or null if it could not be loaded

loadResourceAsURL

public static java.net.URL loadResourceAsURL(java.lang.String name)

Attempts to load the given resource as a stream using the thread context class loader or the class loader used to load this class

Parameters:

name - the name of the resource to load

Returns:

the stream or null if it could not be loaded

invokeMethod

public static java.lang.Object invokeMethod(java.lang.reflect.Method method,
                                            java.lang.Object instance,
                                            java.lang.Object... parameters)

A helper method to invoke a method via reflection and wrap any exceptions as RuntimeCamelException instances

Parameters:

method - the method to invoke

instance - the object instance (or null for static methods)

parameters - the parameters to the method

Returns:

the result of the method invocation

isOverridingMethod

public static boolean isOverridingMethod(java.lang.reflect.Method source,
                                         java.lang.reflect.Method target)

Tests whether the target method overrides the source method.

Tests whether they have the same name, return type, and parameter list.

Parameters:

source - the source method

target - the target method

Returns:

true if it override, false otherwise

findMethodsWithAnnotation

public static java.util.List<java.lang.reflect.Method> findMethodsWithAnnotation(java.lang.Class<?> type,
                                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Returns a list of methods which are annotated with the given annotation

Parameters:

type - the type to reflect on

annotationType - the annotation type

Returns:

a list of the methods found

findMethodsWithAnnotation

public static java.util.List<java.lang.reflect.Method> findMethodsWithAnnotation(java.lang.Class<?> type,
                                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> annotationType,
                                                                                 boolean checkMetaAnnotations)

Returns a list of methods which are annotated with the given annotation

Parameters:

type - the type to reflect on

annotationType - the annotation type

checkMetaAnnotations - check for meta annotations

Returns:

a list of the methods found

hasAnnotation

public static boolean hasAnnotation(java.lang.reflect.AnnotatedElement elem,
                                    java.lang.Class<? extends java.lang.annotation.Annotation> annotationType,
                                    boolean checkMetaAnnotations)

Checks if a Class or Method are annotated with the given annotation

Parameters:

elem - the Class or Method to reflect on

annotationType - the annotation type

checkMetaAnnotations - check for meta annotations

Returns:

true if annotations is present

asString

public static java.lang.String asString(java.lang.Object[] objects)

Turns the given object arrays into a meaningful string

Parameters:

objects - an array of objects or null

Returns:

a meaningful string

isAssignableFrom

public static boolean isAssignableFrom(java.lang.Class<?> a,
                                       java.lang.Class<?> b)

Returns true if a class is assignable from another class like the Class.isAssignableFrom(Class) method but which also includes coercion between primitive types to deal with Java 5 primitive type wrapping

convertPrimitiveTypeToWrapperType

public static java.lang.Class<?> convertPrimitiveTypeToWrapperType(java.lang.Class<?> type)

Converts primitive types such as int to its wrapper type like Integer

getDefaultCharacterSet

public static java.lang.String getDefaultCharacterSet()

Helper method to return the default character set name

getPropertyName

public static java.lang.String getPropertyName(java.lang.reflect.Method method)

Returns the Java Bean property name of the given method, if it is a setter

hasAnnotation

public static boolean hasAnnotation(java.lang.annotation.Annotation[] annotations,
                                    java.lang.Class<?> type)

Returns true if the given collection of annotations matches the given type

close

@Deprecated
public static void close(java.io.Closeable closeable,
                                    java.lang.String name,
                                    org.slf4j.Logger log)

Deprecated. will be removed in Camel 3.0. Instead use IOHelper.close(java.io.Closeable, String, org.slf4j.Logger) instead

Closes the given resource if it is available, logging any closing exceptions to the given log

Parameters:

closeable - the object to close

name - the name of the resource

log - the log to use when reporting closure warnings

cast

public static <T> T cast(java.lang.Class<T> toType,
                         java.lang.Object value)

Converts the given value to the required type or throw a meaningful exception

newInstance

public static <T> T newInstance(java.lang.Class<T> type)

A helper method to create a new instance of a type using the default constructor arguments.

newInstance

public static <T> T newInstance(java.lang.Class<?> actualType,
                                java.lang.Class<T> expectedType)

A helper method to create a new instance of a type using the default constructor arguments.

hasDefaultPublicNoArgConstructor

public static boolean hasDefaultPublicNoArgConstructor(java.lang.Class type)

Does the given class have a default public no-arg constructor.

isJavaIdentifier

public static boolean isJavaIdentifier(java.lang.String name)

Returns true if the given name is a valid java identifier

type

public static java.lang.Object type(java.lang.Object bean)

Returns the type of the given object or null if the value is null

evaluateValuePredicate

public static boolean evaluateValuePredicate(java.lang.Object value)

Evaluate the value as a predicate which attempts to convert the value to a boolean otherwise true is returned if the value is not null

wrapRuntimeCamelException

public static RuntimeCamelException wrapRuntimeCamelException(java.lang.Throwable e)

Wraps the caused exception in a RuntimeCamelException if its not already such an exception.

Parameters:

e - the caused exception

Returns:

the wrapper exception

wrapCamelExecutionException

public static CamelExecutionException wrapCamelExecutionException(Exchange exchange,
                                                                  java.lang.Throwable e)

Wraps the caused exception in a CamelExecutionException if its not already such an exception.

Parameters:

e - the caused exception

Returns:

the wrapper exception

normalizeClassName

public static java.lang.String normalizeClassName(java.lang.String name)

Cleans the string to pure java identifier so we can use it for loading class names.

Especially from Spring DSL people can have \n \t or other characters that otherwise would result in ClassNotFoundException

Parameters:

name - the class name

Returns:

normalized classname that can be load by a class loader.

createExceptionIterator

public static java.util.Iterator<java.lang.Throwable> createExceptionIterator(java.lang.Throwable exception)

Creates an iterator to walk the exception from the bottom up (the last caused by going upwards to the root exception).

Parameters:

exception - the exception

Returns:

the iterator

getException

public static <T> T getException(java.lang.Class<T> type,
                                 java.lang.Throwable exception)

Retrieves the given exception type from the exception.

Is used to get the caused exception that typically have been wrapped in some sort of Camel wrapper exception

The strategy is to look in the exception hierarchy to find the first given cause that matches the type. Will start from the bottom (the real cause) and walk upwards.

Parameters:

type - the exception type wanted to retrieve

exception - the caused exception

Returns:

the exception found (or null if not found in the exception hierarchy)

getScanner

public static java.util.Scanner getScanner(Exchange exchange,
                                           java.lang.Object value)

Creates a Scanner for scanning the given value.

Parameters:

exchange - the current exchange

value - the value, typically the message IN body

Returns:

the scanner, is newer null

getIdentityHashCode

public static java.lang.String getIdentityHashCode(java.lang.Object object)

lookupConstantFieldValue

public static java.lang.String lookupConstantFieldValue(java.lang.Class clazz,
                                                        java.lang.String name)

Lookup the constant field on the given class with the given name

Parameters:

clazz - the class

name - the name of the field to lookup

Returns:

the value of the constant field, or null if not found