ObjectHelper (Camel :: Core 2.18.5 API)

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

```
public final class ObjectHelper
extends Object
```
A number of useful helper methods for working with Objects

Version:

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static String`	`after(String text, String after)` Returns the string after the given token
`static <T> Optional<T>`	`after(String text, String after, Function<String,T> mapper)` Returns an object after the given token
`static int`	`arrayLength(Object[] pojo)`
`static String`	`asString(Object[] objects)` Turns the given object arrays into a meaningful string
`static String`	`before(String text, String before)` Returns the string before the given token
`static <T> Optional<T>`	`before(String text, String before, Function<String,T> mapper)` Returns an object before the given token
`static String`	`between(String text, String after, String before)` Returns the string between the given tokens
`static <T> Optional<T>`	`between(String text, String after, String before, Function<String,T> mapper)` Returns an object between the given token
`static String`	`betweenOuterPair(String text, char before, char after)` Returns the string between the most outer pair of tokens The number of token pairs must be evenly, eg there must be same number of before and after tokens, otherwise `null` is returned This implementation skips matching when the text is either single or double quoted.
`static <T> Optional<T>`	`betweenOuterPair(String text, char before, char after, Function<String,T> mapper)` Returns an object between the most outer pair of tokens
`static Object`	`callWithTCCL(Callable<?> call, ClassLoader classloader)` Calling the Callable with the setting of TCCL with a given classloader.
`static Object`	`callWithTCCL(Callable<?> call, Exchange exchange)` Calling the Callable with the setting of TCCL with the camel context application classloader.
`static String`	`capitalize(String text)`
`static <T> T`	`cast(Class<T> toType, Object value)` Converts the given value to the required type or throw a meaningful exception
`static String`	`classCanonicalName(Object value)` Returns the canonical type name of the given value
`static String`	`className(Object value)` Returns the type name of the given value
`static void`	`close(Closeable closeable, 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(Object a, 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(Object a, 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(Object collectionOrArray, Object value)` Returns true if the collection contains the specified value
`static Class<?>`	`convertPrimitiveTypeToWrapperType(Class<?> type)` Converts primitive types such as int to its wrapper type like `Integer`
`static Iterable<Throwable>`	`createExceptionIterable(Throwable exception)` Creates an Iterable to walk the exception from the bottom up (the last caused by going upwards to the root exception).
`static Iterator<Throwable>`	`createExceptionIterator(Throwable exception)` Creates an Iterator to walk the exception from the bottom up (the last caused by going upwards to the root exception).
`static Iterable<Object>`	`createIterable(Object value)` Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by comma, 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 Iterable<Object>`	`createIterable(Object value, String delimiter)` Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value This method does not allow empty values
`static Iterable<Object>`	`createIterable(Object value, String delimiter, boolean allowEmptyValues)` Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
`static Iterable<Object>`	`createIterable(Object value, String delimiter, boolean allowEmptyValues, boolean pattern)` Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
`static Iterator<Object>`	`createIterator(Object value)` Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by comma, 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 Iterator<Object>`	`createIterator(Object value, String delimiter)` Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value This method does not allow empty values
`static Iterator<Object>`	`createIterator(Object value, String delimiter, boolean allowEmptyValues)` Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
`static Iterator<Object>`	`createIterator(Object value, String delimiter, boolean allowEmptyValues, boolean pattern)` Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, 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(Object a, Object b)` A helper method for comparing objects for equality while handling nulls
`static boolean`	`equal(Object a, Object b, boolean ignoreCase)` 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(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 List<Method>`	`findMethodsWithAnnotation(Class<?> type, Class<? extends Annotation> annotationType)` Returns a list of methods which are annotated with the given annotation
`static List<Method>`	`findMethodsWithAnnotation(Class<?> type, Class<? extends Annotation> annotationType, boolean checkMetaAnnotations)` Returns a list of methods which are annotated with the given annotation
`static <A extends Annotation> A`	`getAnnotation(Object instance, Class<A> type)` Gets the annotation from the given instance.
`static Properties`	`getCamelPropertiesWithPrefix(String prefix, CamelContext camelContext)` A helper method to access a camel context properties with a prefix
`static String`	`getDefaultCharacterSet()` Helper method to return the default character set name
`static <T> T`	`getException(Class<T> type, Throwable exception)` Retrieves the given exception type from the exception.
`static String`	`getIdentityHashCode(Object object)`
`static String`	`getPropertyName(Method method)` Returns the Java Bean property name of the given method, if it is a setter
`static Scanner`	`getScanner(Exchange exchange, Object value)` Creates a `Scanner` for scanning the given value.
`static boolean`	`getSystemProperty(String name, Boolean defaultValue)` A helper method to access a boolean system property, catching any security exceptions
`static String`	`getSystemProperty(String name, String defaultValue)` A helper method to access a system property, catching any security exceptions
`static boolean`	`hasAnnotation(AnnotatedElement elem, Class<? extends Annotation> annotationType, boolean checkMetaAnnotations)` Checks if a Class or Method are annotated with the given annotation
`static boolean`	`hasAnnotation(Annotation[] annotations, Class<?> type)` Returns true if the given collection of annotations matches the given type
`static boolean`	`hasDefaultPublicNoArgConstructor(Class<?> type)` Does the given class have a default public no-arg constructor.
`static <T> void`	`ifNotEmpty(T value, Consumer<T> consumer)` Tests whether the value is not `null`, an empty string or an empty collection.
`static Object`	`invokeMethod(Method method, Object instance, Object... parameters)` A helper method to invoke a method via reflection and wrap any exceptions as `RuntimeCamelException` instances
`static boolean`	`isAssignableFrom(Class<?> a, 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(Object value)` Tests whether the value is `null` or an empty string.
`static boolean`	`isEqualToAny(Object object, Object... values)` Returns true if the given object is equal to any of the expected value
`static boolean`	`isJavaIdentifier(String name)` Returns true if the given name is a valid java identifier
`static boolean`	`isNaN(Object value)` Is the given value a numeric NaN type
`static boolean`	`isNotEmpty(Object value)` Tests whether the value is not `null`, an empty string or an empty collection.
`static boolean`	`isOverridingMethod(Method source, Method target)` Tests whether the target method overrides the source method.
`static boolean`	`isOverridingMethod(Method source, Method target, boolean exact)` Tests whether the target method overrides the source method.
`static boolean`	`isPrimitiveArrayType(Class<?> clazz)` Returns if the given `clazz` type is a Java primitive array type.
`static Class<?>`	`loadClass(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 Class<?>`	`loadClass(String name, ClassLoader loader)` Attempts to load the given class name using the thread context class loader or the given class loader
`static Class<?>`	`loadClass(String name, ClassLoader loader, boolean needToWarn)` Attempts to load the given class name using the thread context class loader or the given class loader
`static InputStream`	`loadResourceAsStream(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 InputStream`	`loadResourceAsStream(String name, ClassLoader loader)` 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 URL`	`loadResourceAsURL(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 URL`	`loadResourceAsURL(String name, ClassLoader loader)` 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 Enumeration<URL>`	`loadResourcesAsURL(String packageName)` Attempts to load the given resources from the given package name using the thread context class loader or the class loader used to load this class
`static Enumeration<URL>`	`loadResourcesAsURL(String packageName, ClassLoader loader)` Attempts to load the given resources from the given package name using the thread context class loader or the class loader used to load this class
`static Class<?>`	`loadSimpleType(String name)` Load a simple type
`static String`	`lookupConstantFieldValue(Class<?> clazz, String name)` Lookup the constant field on the given class with the given name
`static boolean`	`matches(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 String`	`name(Class<?> type)` Returns the type name of the given type or null if the type variable is null
`static <T> T`	`newInstance(Class<?> actualType, Class<T> expectedType)` A helper method to create a new instance of a type using the default constructor arguments.
`static <T> T`	`newInstance(Class<T> type)` A helper method to create a new instance of a type using the default constructor arguments.
`static String`	`normalizeClassName(String name)` Cleans the string to a pure Java identifier so we can use it for loading class names.
`static String`	`notEmpty(String value, String name)` Asserts whether the string is not empty.
`static String`	`notEmpty(String value, String name, Object on)` Asserts whether the string is not empty.
`static <T> T`	`notNull(T value, String name)` Asserts whether the value is not `null`
`static <T> T`	`notNull(T value, String name, Object on)` Asserts whether the value is not `null`
`static String`	`removeStartingCharacters(String text, char ch)` Removes any starting characters on the given text which match the given character
`static String[]`	`splitOnCharacter(String value, String needle, int count)`
`static Boolean`	`toBoolean(Object value)`
`static Object`	`type(Object bean)` Returns the type of the given object or null if the value is null
`static int`	`typeCoerceCompare(TypeConverter converter, Object leftValue, Object rightValue)` A helper method for comparing objects ordering in which it uses type coercion to coerce types between the left and right values.
`static boolean`	`typeCoerceEquals(TypeConverter converter, Object leftValue, Object rightValue)` A helper method for comparing objects for equality in which it uses type coercion to coerce types between the left and right values.
`static boolean`	`typeCoerceEquals(TypeConverter converter, Object leftValue, Object rightValue, boolean ignoreCase)` A helper method for comparing objects for equality in which it uses type coercion to coerce types between the left and right values.
`static boolean`	`typeCoerceNotEquals(TypeConverter converter, Object leftValue, Object rightValue)` A helper method for comparing objects for inequality in which it uses type coercion to coerce types between the left and right values.
`static CamelExecutionException`	`wrapCamelExecutionException(Exchange exchange, Throwable e)` Wraps the caused exception in a `CamelExecutionException` if its not already such an exception.
`static RuntimeCamelException`	`wrapRuntimeCamelException(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,
                                       Object leftValue,
                                       Object rightValue)
```
    A helper method for comparing objects for equality in which it uses type coercion to coerce types between the left and right values. This allows you test for equality for example with a String and Integer type as Camel will be able to coerce the types.
  - typeCoerceEquals
```
public static boolean typeCoerceEquals(TypeConverter converter,
                                       Object leftValue,
                                       Object rightValue,
                                       boolean ignoreCase)
```
    A helper method for comparing objects for equality in which it uses type coercion to coerce types between the left and right values. This allows you test for equality for example with a String and Integer type as Camel will be able to coerce the types.
  - typeCoerceNotEquals
```
public static boolean typeCoerceNotEquals(TypeConverter converter,
                                          Object leftValue,
                                          Object rightValue)
```
    A helper method for comparing objects for inequality in which it uses type coercion to coerce types between the left and right values. This allows you test for inequality for example with a String and Integer type as Camel will be able to coerce the types.
  - typeCoerceCompare
```
public static int typeCoerceCompare(TypeConverter converter,
                                    Object leftValue,
                                    Object rightValue)
```
    A helper method for comparing objects ordering in which it uses type coercion to coerce types between the left and right values. This allows you test for ordering for example with a String and Integer type as Camel will be able to coerce the types.
  - equal
```
public static boolean equal(Object a,
                            Object b)
```
    A helper method for comparing objects for equality while handling nulls
  - equal
```
public static boolean equal(Object a,
                            Object b,
                            boolean ignoreCase)
```
    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(Object object,
                                   Object... values)
```
    Returns true if the given object is equal to any of the expected value
  - compare
```
public static int compare(Object a,
                          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(Object a,
                          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 Boolean toBoolean(Object value)
```
  - notNull
```
public static <T> T notNull(T value,
                            String name)
```
    Asserts whether the value is not null
    
    Parameters:
    
    value - the value to test
    
    name - the key that resolved the value
    
    Returns:
    
    the passed value as is
    
    Throws:
    
    IllegalArgumentException - is thrown if assertion fails
  - notNull
```
public static <T> T notNull(T value,
                            String name,
                            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
    
    Returns:
    
    the passed value as is
    
    Throws:
    
    IllegalArgumentException - is thrown if assertion fails
  - notEmpty
```
public static String notEmpty(String value,
                              String name)
```
    Asserts whether the string is not empty.
    
    Parameters:
    
    value - the string to test
    
    name - the key that resolved the value
    
    Returns:
    
    the passed value as is
    
    Throws:
    
    IllegalArgumentException - is thrown if assertion fails
  - notEmpty
```
public static String notEmpty(String value,
                              String name,
                              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
    
    Returns:
    
    the passed value as is
    
    Throws:
    
    IllegalArgumentException - is thrown if assertion fails
  - isEmpty
```
public static boolean isEmpty(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(Object value)
```
    Tests whether the value is not null, an empty string or an empty collection.
    
    Parameters:
    
    value - the value, if its a String it will be tested for text length as well
    
    Returns:
    
    true if not empty
  - ifNotEmpty
```
public static <T> void ifNotEmpty(T value,
                                  Consumer<T> consumer)
```
    Tests whether the value is not null, an empty string or an empty collection.
    
    Parameters:
    
    value - the value, if its a String it will be tested for text length as well
    
    consumer - the consumer, the operation to be executed against value if not empty
  - splitOnCharacter
```
public static String[] splitOnCharacter(String value,
                                        String needle,
                                        int count)
```
  - removeStartingCharacters
```
public static String removeStartingCharacters(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 String capitalize(String text)
```
  - after
```
public static String after(String text,
                           String after)
```
    Returns the string after the given token
    
    Parameters:
    
    text - the text
    
    after - the token
    
    Returns:
    
    the text after the token, or null if text does not contain the token
  - after
```
public static <T> Optional<T> after(String text,
                                    String after,
                                    Function<String,T> mapper)
```
    Returns an object after the given token
    
    Parameters:
    
    text - the text
    
    after - the token
    
    mapper - a mapping function to convert the string after the token to type T
    
    Returns:
    
    an Optional describing the result of applying a mapping function to the text after the token.
  - before
```
public static String before(String text,
                            String before)
```
    Returns the string before the given token
    
    Parameters:
    
    text - the text
    
    before - the token
    
    Returns:
    
    the text before the token, or null if text does not contain the token
  - before
```
public static <T> Optional<T> before(String text,
                                     String before,
                                     Function<String,T> mapper)
```
    Returns an object before the given token
    
    Parameters:
    
    text - the text
    
    before - the token
    
    mapper - a mapping function to convert the string before the token to type T
    
    Returns:
    
    an Optional describing the result of applying a mapping function to the text before the token.
  - between
```
public static String between(String text,
                             String after,
                             String before)
```
    Returns the string between the given tokens
    
    Parameters:
    
    text - the text
    
    after - the before token
    
    before - the after token
    
    Returns:
    
    the text between the tokens, or null if text does not contain the tokens
  - between
```
public static <T> Optional<T> between(String text,
                                      String after,
                                      String before,
                                      Function<String,T> mapper)
```
    Returns an object between the given token
    
    Parameters:
    
    text - the text
    
    after - the before token
    
    before - the after token
    
    mapper - a mapping function to convert the string between the token to type T
    
    Returns:
    
    an Optional describing the result of applying a mapping function to the text between the token.
  - betweenOuterPair
```
public static String betweenOuterPair(String text,
                                      char before,
                                      char after)
```
    Returns the string between the most outer pair of tokens
    The number of token pairs must be evenly, eg there must be same number of before and after tokens, otherwise null is returned
    This implementation skips matching when the text is either single or double quoted. For example: ${body.matches("foo('bar')") Will not match the parenthesis from the quoted text.
    
    Parameters:
    
    text - the text
    
    after - the before token
    
    before - the after token
    
    Returns:
    
    the text between the outer most tokens, or null if text does not contain the tokens
  - betweenOuterPair
```
public static <T> Optional<T> betweenOuterPair(String text,
                                               char before,
                                               char after,
                                               Function<String,T> mapper)
```
    Returns an object between the most outer pair of tokens
    
    Parameters:
    
    text - the text
    
    after - the before token
    
    before - the after token
    
    mapper - a mapping function to convert the string between the most outer pair of tokens to type T
    
    Returns:
    
    an Optional describing the result of applying a mapping function to the text between the most outer pair of tokens.
  - contains
```
public static boolean contains(Object collectionOrArray,
                               Object value)
```
    Returns true if the collection contains the specified value
  - createIterable
```
public static Iterable<Object> createIterable(Object value)
```
    Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by comma, 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. This method does not allow empty values
    
    Parameters:
    
    value - the value
    
    Returns:
    
    the iterable
  - createIterable
```
public static Iterable<Object> createIterable(Object value,
                                              String delimiter)
```
    Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    This method does not allow empty values
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    Returns:
    
    the iterable
  - createIterator
```
public static Iterator<Object> createIterator(Object value)
```
    Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by comma, 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. This method does not allow empty values
    
    Parameters:
    
    value - the value
    
    Returns:
    
    the iterator
  - createIterator
```
public static Iterator<Object> createIterator(Object value,
                                              String delimiter)
```
    Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    This method does not allow empty values
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    Returns:
    
    the iterator
  - createIterator
```
public static Iterator<Object> createIterator(Object value,
                                              String delimiter,
                                              boolean allowEmptyValues)
```
    Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    In case of primitive type arrays the returned Iterator iterates over the corresponding Java primitive wrapper objects of the given elements inside the value array. That's we get an autoboxing of the primitive types here for free as it's also the case in Java language itself.
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    allowEmptyValues - whether to allow empty values
    
    Returns:
    
    the iterator
  - createIterator
```
public static Iterator<Object> createIterator(Object value,
                                              String delimiter,
                                              boolean allowEmptyValues,
                                              boolean pattern)
```
    Creates an iterator over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    In case of primitive type arrays the returned Iterator iterates over the corresponding Java primitive wrapper objects of the given elements inside the value array. That's we get an autoboxing of the primitive types here for free as it's also the case in Java language itself.
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    allowEmptyValues - whether to allow empty values
    
    pattern - whether the delimiter is a pattern
    
    Returns:
    
    the iterator
  - createIterable
```
public static Iterable<Object> createIterable(Object value,
                                              String delimiter,
                                              boolean allowEmptyValues)
```
    Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    In case of primitive type arrays the returned Iterable iterates over the corresponding Java primitive wrapper objects of the given elements inside the value array. That's we get an autoboxing of the primitive types here for free as it's also the case in Java language itself.
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    allowEmptyValues - whether to allow empty values
    
    Returns:
    
    the iterable
    
    See Also:
    
    Iterable
  - createIterable
```
public static Iterable<Object> createIterable(Object value,
                                              String delimiter,
                                              boolean allowEmptyValues,
                                              boolean pattern)
```
    Creates an iterable over the value if the value is a collection, an Object[], a String with values separated by the given delimiter, or a primitive type array; otherwise to simplify the caller's code, we just create a singleton collection iterator over a single value
    In case of primitive type arrays the returned Iterable iterates over the corresponding Java primitive wrapper objects of the given elements inside the value array. That's we get an autoboxing of the primitive types here for free as it's also the case in Java language itself.
    
    Parameters:
    
    value - the value
    
    delimiter - delimiter for separating String values
    
    allowEmptyValues - whether to allow empty values
    
    pattern - whether the delimiter is a pattern
    
    Returns:
    
    the iterable
    
    See Also:
    
    Iterable
  - matches
```
public static boolean matches(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 String getSystemProperty(String name,
                                       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(String name,
                                        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 Properties getCamelPropertiesWithPrefix(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 String name(Class<?> type)
```
    Returns the type name of the given type or null if the type variable is null
  - className
```
public static String className(Object value)
```
    Returns the type name of the given value
  - classCanonicalName
```
public static String classCanonicalName(Object value)
```
    Returns the canonical type name of the given value
  - loadClass
```
public static Class<?> loadClass(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 Class<?> loadClass(String name,
                                 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 Class<?> loadClass(String name,
                                 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 Class<?> loadSimpleType(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 InputStream loadResourceAsStream(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
  - loadResourceAsStream
```
public static InputStream loadResourceAsStream(String name,
                                               ClassLoader loader)
```
    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
    
    loader - optional classloader to attempt first
    
    Returns:
    
    the stream or null if it could not be loaded
  - loadResourceAsURL
```
public static URL loadResourceAsURL(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 URL loadResourceAsURL(String name,
                                    ClassLoader loader)
```
    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
    
    loader - optional classloader to attempt first
    
    Returns:
    
    the stream or null if it could not be loaded
  - loadResourcesAsURL
```
public static Enumeration<URL> loadResourcesAsURL(String packageName)
```
    Attempts to load the given resources from the given package name using the thread context class loader or the class loader used to load this class
    
    Parameters:
    
    packageName - the name of the package to load its resources
    
    Returns:
    
    the URLs for the resources or null if it could not be loaded
  - loadResourcesAsURL
```
public static Enumeration<URL> loadResourcesAsURL(String packageName,
                                                  ClassLoader loader)
```
    Attempts to load the given resources from the given package name using the thread context class loader or the class loader used to load this class
    
    Parameters:
    
    packageName - the name of the package to load its resources
    
    loader - optional classloader to attempt first
    
    Returns:
    
    the URLs for the resources or null if it could not be loaded
  - invokeMethod
```
public static Object invokeMethod(Method method,
                                  Object instance,
                                  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(Method source,
                                         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
  - isOverridingMethod
```
public static boolean isOverridingMethod(Method source,
                                         Method target,
                                         boolean exact)
```
    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
    
    exact - true if the override must be exact same types, false if the types should be assignable
    
    Returns:
    
    true if it override, false otherwise
  - findMethodsWithAnnotation
```
public static List<Method> findMethodsWithAnnotation(Class<?> type,
                                                     Class<? extends 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 List<Method> findMethodsWithAnnotation(Class<?> type,
                                                     Class<? extends 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(AnnotatedElement elem,
                                    Class<? extends 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 String asString(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(Class<?> a,
                                       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
  - isPrimitiveArrayType
```
public static boolean isPrimitiveArrayType(Class<?> clazz)
```
    Returns if the given clazz type is a Java primitive array type.
    
    Parameters:
    
    clazz - the Java type to be checked
    
    Returns:
    
    true if the given type is a Java primitive array type
  - arrayLength
```
public static int arrayLength(Object[] pojo)
```
  - convertPrimitiveTypeToWrapperType
```
public static Class<?> convertPrimitiveTypeToWrapperType(Class<?> type)
```
    Converts primitive types such as int to its wrapper type like Integer
  - getDefaultCharacterSet
```
public static String getDefaultCharacterSet()
```
    Helper method to return the default character set name
  - getPropertyName
```
public static String getPropertyName(Method method)
```
    Returns the Java Bean property name of the given method, if it is a setter
  - hasAnnotation
```
public static boolean hasAnnotation(Annotation[] annotations,
                                    Class<?> type)
```
    Returns true if the given collection of annotations matches the given type
  - getAnnotation
```
public static <A extends Annotation> A getAnnotation(Object instance,
                                                     Class<A> type)
```
    Gets the annotation from the given instance.
    
    Parameters:
    
    instance - the instance
    
    type - the annotation
    
    Returns:
    
    the annotation, or null if the instance does not have the given annotation
  - close
```
@Deprecated
public static void close(Closeable closeable,
                                     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(Class<T> toType,
                         Object value)
```
    Converts the given value to the required type or throw a meaningful exception
  - newInstance
```
public static <T> T newInstance(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(Class<?> actualType,
                                Class<T> expectedType)
```
    A helper method to create a new instance of a type using the default constructor arguments.
  - hasDefaultPublicNoArgConstructor
```
public static boolean hasDefaultPublicNoArgConstructor(Class<?> type)
```
    Does the given class have a default public no-arg constructor.
  - isJavaIdentifier
```
public static boolean isJavaIdentifier(String name)
```
    Returns true if the given name is a valid java identifier
  - type
```
public static Object type(Object bean)
```
    Returns the type of the given object or null if the value is null
  - evaluateValuePredicate
```
public static boolean evaluateValuePredicate(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(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,
                                                                  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 String normalizeClassName(String name)
```
    Cleans the string to a 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.
  - createExceptionIterable
```
public static Iterable<Throwable> createExceptionIterable(Throwable exception)
```
    Creates an Iterable to walk the exception from the bottom up (the last caused by going upwards to the root exception).
    
    Parameters:
    
    exception - the exception
    
    Returns:
    
    the Iterable
    
    See Also:
    
    Iterable
  - createExceptionIterator
```
public static Iterator<Throwable> createExceptionIterator(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
    
    See Also:
    
    Iterator
  - getException
```
public static <T> T getException(Class<T> type,
                                 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 Scanner getScanner(Exchange exchange,
                                 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 String getIdentityHashCode(Object object)
```
  - lookupConstantFieldValue
```
public static String lookupConstantFieldValue(Class<?> clazz,
                                              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
  - isNaN
```
public static boolean isNaN(Object value)
```
    Is the given value a numeric NaN type
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true if its a Float.NaN or Double.NaN.
  - callWithTCCL
```
public static Object callWithTCCL(Callable<?> call,
                                  Exchange exchange)
                           throws Exception
```
    Calling the Callable with the setting of TCCL with the camel context application classloader.
    
    Parameters:
    
    call - the Callable instance
    
    exchange - the exchange
    
    Returns:
    
    the result of Callable return
    
    Throws:
    
    Exception
  - callWithTCCL
```
public static Object callWithTCCL(Callable<?> call,
                                  ClassLoader classloader)
                           throws Exception
```
    Calling the Callable with the setting of TCCL with a given classloader.
    
    Parameters:
    
    call - the Callable instance
    
    classloader - the class loader
    
    Returns:
    
    the result of Callable return
    
    Throws:
    
    Exception

Class ObjectHelper

Method Summary

Methods inherited from class java.lang.Object

Method Detail

typeCoerceEquals

typeCoerceEquals

typeCoerceNotEquals

typeCoerceCompare

equal

equal

equalByteArray

isEqualToAny

compare

compare

toBoolean

notNull

notNull

notEmpty

notEmpty

isEmpty

isNotEmpty

ifNotEmpty

splitOnCharacter

removeStartingCharacters

capitalize

after

after

before

before

between

between

betweenOuterPair

betweenOuterPair

contains

createIterable

createIterable

createIterator

createIterator

createIterator

createIterator

createIterable

createIterable

matches

getSystemProperty

getSystemProperty

getCamelPropertiesWithPrefix

name

className

classCanonicalName

loadClass

loadClass

loadClass

loadSimpleType

loadResourceAsStream

loadResourceAsStream

loadResourceAsURL

loadResourceAsURL

loadResourcesAsURL

loadResourcesAsURL

invokeMethod

isOverridingMethod

isOverridingMethod

findMethodsWithAnnotation

findMethodsWithAnnotation

hasAnnotation

asString

isAssignableFrom

isPrimitiveArrayType

arrayLength

convertPrimitiveTypeToWrapperType

getDefaultCharacterSet

getPropertyName

hasAnnotation

getAnnotation

close

cast

newInstance

newInstance

hasDefaultPublicNoArgConstructor

isJavaIdentifier