Jackson 3.0.1 · tools.jackson.databind.util.ClassUtil

Modifier and Type	Class and Description
public static class	ClassUtil.Ctor Value class used for containing information about discovered Constructors
private static class	ClassUtil.EnumTypeLocator Inner class used to contain gory details of how we can determine details of instances of common JDK types like `EnumMap`s.

Modifier and Type	Field and Description
private static final Class<?>	CLS_OBJECT
private static final Iterator<Object>	EMPTY_ITERATOR
private static final List<String>	JDK_PREFIXES
private static final ClassUtil.Ctor[]	NO_CTORS

Access	Constructor and Description
public	ClassUtil()

Method Summary

Modifier and Type	Method and Description
private static void	_addRawSuperTypes(Class<?> cls, Class<?> endBefore, Collection<Class<?>> result, boolean addClassItself)
private static Method[]	_failGetClassMethods(Class<?> cls, Throwable rootCause)
public static String	apostrophed(String text) Returns either `'text'` (single-quoted) or `[null]`.
public static String	backticked(String text) Returns either `text` (backtick-quoted) or `[null]`.
public static String	Returns: Null if class might be a bean; type String (that identifies why it's not a bean) if not canBeABeanType(Class<?> type)
public static void	checkAndFixAccess(Member Accessor to call `setAccessible()` on. member, boolean Whether to always try to make accessor accessible, even if `public` (true), or only if needed to force by-pass of non-`public` access (false) evenIfAlreadyPublic) Method that is called if a `Member` may need forced access, to force a field, method or constructor to be accessible: this is done by calling `AccessibleObject#setAccessible(boolean)`.
public static String	classNameOf(Object inst) Helper method used to construct appropriate description when passed either type (Class) or an instance; in latter case, class of instance is to be used.
public static Class<?>	classOf(Object inst)
public static void	closeOnFailAndThrowAsJacksonE(JsonGenerator g, Exception fail) Helper method that encapsulate logic in trying to close output generator in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose.
public static void	closeOnFailAndThrowAsJacksonE(JsonGenerator g, AutoCloseable toClose, Exception fail) Helper method that encapsulate logic in trying to close given `Closeable` in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose.
public static <T> T	createInstance(Class<T> cls, boolean Whether it is possible to try to change access rights of the default constructor (in case it is not publicly accessible) or not. canFixAccess) Method that can be called to try to create an instantiate of specified type.
public static Object	defaultValue(Class<?> cls) Helper method used to get default value for wrappers used for primitive types (0 for Integer etc)
public static <T> Iterator<T>	emptyIterator()
public static <T> Stream<T>	emptyStream()
public static String	exceptionMessage(Throwable t) Helper method that returns `Throwable#getMessage()` for all other exceptions except for (a) `JacksonException`, for which `getOriginalMessage()` is returned, and (b) `InvocationTargetException`, for which the cause's message is returned, if available.
public static <T> Constructor<T>	findConstructor(Class<T> cls, boolean forceAccess)
public static Class<? extends Enum<?>>	findEnumType(EnumSet<?> s) Helper method that can be used to dynamically figure out enumeration type of given `EnumSet`, without having access to its declaration.
public static Class<? extends Enum<?>>	findEnumType(EnumMap<?, ?> m) Helper method that can be used to dynamically figure out enumeration type of given `EnumSet`, without having access to its declaration.
public static Class<? extends Enum<?>>	findEnumType(Enum<?> en) Helper method that can be used to dynamically figure out formal enumeration type (class) for given enumeration.
public static Class<? extends Enum<?>>	findEnumType(Class<?> cls) Helper method that can be used to dynamically figure out formal enumeration type (class) for given class of an enumeration value.
public static List<Class<?>>	findRawSuperTypes(Class<?> cls, Class<?> endBefore, boolean addClassItself)
public static List<Class<?>>	findSuperClasses(Class<?> cls, Class<?> endBefore, boolean addClassItself) Method for finding all super classes (but not super interfaces) of given class, starting with the immediate super class and ending in the most distant one.
public static String	getClassDescription(Object classOrInstance) Helper method used to construct appropriate description when passed either type (Class) or an instance; in latter case, class of instance is to be used.
public static Method[]	getClassMethods(Class<?> cls) Helper method that gets methods declared in given class; usually a simple thing, but sometimes (as per [databind#785]) more complicated, depending on classloader setup.
public static ClassUtil.Ctor[]	getConstructors(Class<?> cls)
public static Class<?>	getDeclaringClass(Class<?> cls)
public static Class<?>	getEnclosingClass(Class<?> cls)
public static int	Returns: Major version of JDK we are running on getJDKMajorVersion()
public static Class<?>	getOuterClass(Class<?> type) Method for finding enclosing class for non-static inner classes
public static Throwable	getRootCause(Throwable t) Method that can be used to find the "root cause", innermost of chained (wrapped) exceptions.
public static String	Returns: String description of type including generic type parameters, surrounded by backticks, if type passed; or string "null" if {code null} passed getTypeDescription(JavaType Fully resolved type or null fullType) Helper method to create and return "backticked" description of given resolved type (or, `"null"` if `null` passed), similar to return vaue of `getClassDescription(Object)`.
public static boolean	hasClass(Object inst, Class<?> raw)
public static boolean	hasEnclosingMethod(Class<?> cls)
public static boolean	isBogusClass(Class<?> cls)
public static boolean	isCollectionMapOrArray(Class<?> type)
public static boolean	isConcrete(Class<?> type) Helper method that checks if given class is a concrete one; that is, not an interface or abstract class.
public static boolean	isConcrete(Member member)
public static boolean	isEnumType(Class<?> rawType) Helper method that encapsulates reliable check on whether given raw type "is an Enum", that is, is or extends `java.lang.Enum`.
public static boolean	isJacksonStdImpl(Object impl) Method that can be called to determine if given Object is the default implementation Jackson uses; as opposed to a custom serializer installed by a module or calling application.
public static boolean	isJacksonStdImpl(Class<?> implClass)
public static boolean	Returns: `True` if we can determine that the code is running on JDK 17 or above; `false` otherwise. isJDK17OrAbove() Convenience method for: return getJDKMajorVersion() >= 17
public static boolean	isJDKClass(Class<?> rawType) Accessor for checking whether given `Class` is under Java package of `java.`, `javax.` or `sun.*` (including all sub-packages).
public static boolean	isJDKCoreClass(Class<?> rawType) Similar to `isJDKClass(Class)`, but for JDK core classes: those in packages under `java.` but NOT under `javax.` (or `sun.*`).
public static String	isLocalType(Class<?> type, boolean allowNonStatic)
public static boolean	isNonStaticInnerClass(Class<?> cls)
public static boolean	isObjectOrPrimitive(Class<?> cls)
public static boolean	isProxyType(Class<?> type) Helper method used to weed out dynamic Proxy types; types that do not expose concrete method API that we could use to figure out automatic Bean (property) based serialization.
public static boolean	isRecordType(Class<?> cls) Helper method for detecting Java14-added `Record` types
public static String	name(String name) Returns either single-quoted (apostrophe) `'name'` (if `name` not null), or "[null]" if `name` is null.
public static String	name(PropertyName name) Returns either single-quoted (apostrophe) `'name'` (if `name` not null), or "[null]" if `name` is null.
public static String	nameOf(Class<?> cls) Returns either `cls.getName()` (if `cls` not null), or "[null]" if `cls` is null.
public static String	nameOf(Named named) Returns either single-quoted (apostrophe) `'named.getName()'` (if `named` not null), or "[null]" if `named` is null.
public static <T> T	nonNull(T valueOrNull, T defaultValue)
public static String	nonNullString(String str)
public static String	nullOrToString(Object value)
public static Class<?>	primitiveType(Class<?> type) Method that can be used to find primitive type for given class if (but only if) it is either wrapper type or primitive type; returns `null` if type is neither.
public static String	quotedOr(Object str, String forNull)
public static Class<?>	rawClass(JavaType t)
public static <E extends Throwable> RuntimeException	sneakyThrow(Throwable throwable) Throw an exception even if it's checked and not declared.
public static void	throwAsIAE(Throwable t) Method that will wrap 't' as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is
public static void	throwAsIAE(Throwable t, String msg) Method that will wrap 't' as an `IllegalArgumentException` (and with specified message) if it is a checked exception; otherwise (runtime exception or error) throw as is
public static Throwable	throwIfError(Throwable t) Helper method that will check if argument is an `Error`, and if so, (re)throw it; otherwise just return
public static Throwable	throwIfJacksonE(Throwable t) Helper method that will check if argument is an `IOException`, and if so, (re)throw it; otherwise just return
public static Throwable	throwIfRTE(Throwable t) Helper method that will check if argument is an `RuntimeException`, and if so, (re)throw it; otherwise just return
public static Throwable	throwRootCauseIfJacksonE(Throwable t) Method that works like by calling `getRootCause` and then either throwing it (if instanceof `IOException`), or return.
public static void	unwrapAndThrowAsIAE(Throwable t) Method that will locate the innermost exception for given Throwable; and then wrap it as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is
public static void	unwrapAndThrowAsIAE(Throwable t, String msg) Method that will locate the innermost exception for given Throwable; and then wrap it as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is
public static void	verifyMustOverride(Class<?> expType, Object instance, String method)
public static Class<?>	wrapperType(Class<?> primitiveType) Helper method for finding wrapper type for given primitive type (why isn't there one in JDK?).

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

CLS_OBJECT	back to summary
private static final Class<?> CLS_OBJECT

EMPTY_ITERATOR	back to summary
private static final Iterator<Object> EMPTY_ITERATOR

JDK_PREFIXES	back to summary
private static final List<String> JDK_PREFIXES

NO_CTORS	back to summary
private static final ClassUtil.Ctor[] NO_CTORS

ClassUtil	back to summary
public ClassUtil()

Method Detail

_addRawSuperTypes	back to summary
private static void _addRawSuperTypes(Class<?> cls, Class<?> endBefore, Collection<Class<?>> result, boolean addClassItself)

_failGetClassMethods	back to summary
private static Method[] _failGetClassMethods(Class<?> cls, Throwable rootCause) throws IllegalArgumentException

apostrophed	back to summary
public static String apostrophed(String text) Returns either `'text'` (single-quoted) or `[null]`.

backticked	back to summary
public static String backticked(String text) Returns either `text` (backtick-quoted) or `[null]`.

canBeABeanType	back to summary
public static String canBeABeanType(Class<?> type) Returns:String Null if class might be a bean; type String (that identifies why it's not a bean) if not

checkAndFixAccess back to summary

checkAndFixAccess	back to summary
public static void checkAndFixAccess(Member member, boolean evenIfAlreadyPublic) Method that is called if a `Member` may need forced access, to force a field, method or constructor to be accessible: this is done by calling `AccessibleObject#setAccessible(boolean)`. Parameters member:Member Accessor to call `setAccessible()` on. evenIfAlreadyPublic:boolean Whether to always try to make accessor accessible, even if `public` (true), or only if needed to force by-pass of non-`public` access (false)

public static void checkAndFixAccess(Member member, boolean evenIfAlreadyPublic)

Method that is called if a Member may need forced access, to force a field, method or constructor to be accessible: this is done by calling AccessibleObject#setAccessible(boolean).

Parameters

member:Member: Accessor to call setAccessible() on.
evenIfAlreadyPublic:boolean: Whether to always try to make accessor accessible, even if public (true), or only if needed to force by-pass of non-public access (false)

classNameOf	back to summary
public static String classNameOf(Object inst) Helper method used to construct appropriate description when passed either type (Class) or an instance; in latter case, class of instance is to be used.

classOf	back to summary
public static Class<?> classOf(Object inst)

closeOnFailAndThrowAsJacksonE back to summary

closeOnFailAndThrowAsJacksonE	back to summary
public static void closeOnFailAndThrowAsJacksonE(JsonGenerator g, Exception fail) throws JacksonException Helper method that encapsulate logic in trying to close output generator in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose. However, it is often the case that output state may be corrupt so we need to be prepared for secondary exception without masking original one. Note that exception is thrown as-is if unchecked (likely case); if it is checked, however, `RuntimeException` is thrown (except for `IOException` which will be wrapped as `JacksonIOException`. Since 3.0 (with this name)

public static void closeOnFailAndThrowAsJacksonE(JsonGenerator g, Exception fail) throws JacksonException

Helper method that encapsulate logic in trying to close output generator in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose. However, it is often the case that output state may be corrupt so we need to be prepared for secondary exception without masking original one.

Note that exception is thrown as-is if unchecked (likely case); if it is checked, however, RuntimeException is thrown (except for IOException which will be wrapped as JacksonIOException.

Since: 3.0 (with this name)

closeOnFailAndThrowAsJacksonE back to summary

closeOnFailAndThrowAsJacksonE	back to summary
public static void closeOnFailAndThrowAsJacksonE(JsonGenerator g, AutoCloseable toClose, Exception fail) throws JacksonException Helper method that encapsulate logic in trying to close given `Closeable` in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose. However, it is often the case that output state may be corrupt so we need to be prepared for secondary exception without masking original one.

public static void closeOnFailAndThrowAsJacksonE(JsonGenerator g, AutoCloseable toClose, Exception fail) throws JacksonException

Helper method that encapsulate logic in trying to close given Closeable in case of failure; useful mostly in forcing flush()ing as otherwise error conditions tend to be hard to diagnose. However, it is often the case that output state may be corrupt so we need to be prepared for secondary exception without masking original one.

createInstance	back to summary
public static <T> T createInstance(Class<T> cls, boolean canFixAccess) throws IllegalArgumentException Method that can be called to try to create an instantiate of specified type. Instantiation is done using default no-argument constructor. Parameters canFixAccess:boolean Whether it is possible to try to change access rights of the default constructor (in case it is not publicly accessible) or not. Exceptions IllegalArgumentException: If instantiation fails for any reason; except for cases where constructor throws an unchecked exception (which will be passed as is)

createInstance

back to summary

public static <T> T createInstance(Class<T> cls, boolean canFixAccess) throws IllegalArgumentException

Method that can be called to try to create an instantiate of specified type. Instantiation is done using default no-argument constructor.

Parameters

canFixAccess:boolean: Whether it is possible to try to change access rights of the default constructor (in case it is not publicly accessible) or not.

Exceptions

IllegalArgumentException:: If instantiation fails for any reason; except for cases where constructor throws an unchecked exception (which will be passed as is)

defaultValue	back to summary
public static Object defaultValue(Class<?> cls) Helper method used to get default value for wrappers used for primitive types (0 for Integer etc)

emptyIterator	back to summary
public static <T> Iterator<T> emptyIterator() Annotations @SuppressWarnings:unchecked

emptyStream	back to summary
public static <T> Stream<T> emptyStream() Since 2.19

exceptionMessage back to summary

exceptionMessage	back to summary
public static String exceptionMessage(Throwable t) Helper method that returns `Throwable#getMessage()` for all other exceptions except for (a) `JacksonException`, for which `getOriginalMessage()` is returned, and (b) `InvocationTargetException`, for which the cause's message is returned, if available. Method is used to avoid accidentally including trailing location information twice in message when wrapping exceptions.

public static String exceptionMessage(Throwable t)

Helper method that returns Throwable#getMessage() for all other exceptions except for (a) JacksonException, for which getOriginalMessage() is returned, and (b) InvocationTargetException, for which the cause's message is returned, if available. Method is used to avoid accidentally including trailing location information twice in message when wrapping exceptions.

findConstructor	back to summary
public static <T> Constructor<T> findConstructor(Class<T> cls, boolean forceAccess) throws IllegalArgumentException

findEnumType	back to summary
public static Class<? extends Enum<?>> findEnumType(EnumSet<?> s) Helper method that can be used to dynamically figure out enumeration type of given `EnumSet`, without having access to its declaration. Code is needed to work around design flaw in JDK.

findEnumType	back to summary
public static Class<? extends Enum<?>> findEnumType(EnumMap<?, ?> m) Helper method that can be used to dynamically figure out enumeration type of given `EnumSet`, without having access to its declaration. Code is needed to work around design flaw in JDK.

findEnumType	back to summary
public static Class<? extends Enum<?>> findEnumType(Enum<?> en) Helper method that can be used to dynamically figure out formal enumeration type (class) for given enumeration. This is either class of enum instance (for "simple" enumerations), or its superclass (for enums with instance fields or methods)

findEnumType	back to summary
public static Class<? extends Enum<?>> findEnumType(Class<?> cls) Helper method that can be used to dynamically figure out formal enumeration type (class) for given class of an enumeration value. This is either class of enum instance (for "simple" enumerations), or its superclass (for enums with instance fields or methods) Annotations @SuppressWarnings:unchecked

findEnumType

back to summary

public static Class<? extends Enum<?>> findEnumType(Class<?> cls)

Helper method that can be used to dynamically figure out formal enumeration type (class) for given class of an enumeration value. This is either class of enum instance (for "simple" enumerations), or its superclass (for enums with instance fields or methods)

Annotations

@SuppressWarnings:unchecked

findRawSuperTypes	back to summary
public static List<Class<?>> findRawSuperTypes(Class<?> cls, Class<?> endBefore, boolean addClassItself)

findSuperClasses back to summary

findSuperClasses	back to summary
public static List<Class<?>> findSuperClasses(Class<?> cls, Class<?> endBefore, boolean addClassItself) Method for finding all super classes (but not super interfaces) of given class, starting with the immediate super class and ending in the most distant one. Class itself is included if `addClassItself` is true. Note mostly/only called to resolve mix-ins as that's where we do not care about fully-resolved types, just associated annotations.

public static List<Class<?>> findSuperClasses(Class<?> cls, Class<?> endBefore, boolean addClassItself)

Method for finding all super classes (but not super interfaces) of given class, starting with the immediate super class and ending in the most distant one. Class itself is included if addClassItself is true.

Note

mostly/only called to resolve mix-ins as that's where we do not care about fully-resolved types, just associated annotations.

getClassDescription	back to summary
public static String getClassDescription(Object classOrInstance) Helper method used to construct appropriate description when passed either type (Class) or an instance; in latter case, class of instance is to be used.

getClassMethods	back to summary
public static Method[] getClassMethods(Class<?> cls) Helper method that gets methods declared in given class; usually a simple thing, but sometimes (as per [databind#785]) more complicated, depending on classloader setup. Since 2.9

getClassMethods

back to summary

public static Method[] getClassMethods(Class<?> cls)

Helper method that gets methods declared in given class; usually a simple thing, but sometimes (as per [databind#785]) more complicated, depending on classloader setup.

Since: 2.9

getConstructors	back to summary
public static ClassUtil.Ctor[] getConstructors(Class<?> cls) Since 2.7

getDeclaringClass	back to summary
public static Class<?> getDeclaringClass(Class<?> cls)

getEnclosingClass	back to summary
public static Class<?> getEnclosingClass(Class<?> cls)

getJDKMajorVersion	back to summary
public static int getJDKMajorVersion() Returns:int Major version of JDK we are running on Exceptions IllegalStateException: If JDK version information cannot be determined Since 2.15

getOuterClass	back to summary
public static Class<?> getOuterClass(Class<?> type) Method for finding enclosing class for non-static inner classes

getRootCause	back to summary
public static Throwable getRootCause(Throwable t) Method that can be used to find the "root cause", innermost of chained (wrapped) exceptions.

getTypeDescription back to summary

getTypeDescription	back to summary
public static String getTypeDescription(JavaType fullType) Helper method to create and return "backticked" description of given resolved type (or, `"null"` if `null` passed), similar to return vaue of `getClassDescription(Object)`. Parameters fullType:JavaType Fully resolved type or null Returns:String String description of type including generic type parameters, surrounded by backticks, if type passed; or string "null" if {code null} passed

public static String getTypeDescription(JavaType fullType)

Helper method to create and return "backticked" description of given resolved type (or, "null" if null passed), similar to return vaue of getClassDescription(Object).

Parameters

fullType:JavaType: Fully resolved type or null

Returns:String

String description of type including generic type parameters, surrounded by backticks, if type passed; or string "null" if {code null} passed

hasClass	back to summary
public static boolean hasClass(Object inst, Class<?> raw)

hasEnclosingMethod	back to summary
public static boolean hasEnclosingMethod(Class<?> cls)

isBogusClass	back to summary
public static boolean isBogusClass(Class<?> cls)

isCollectionMapOrArray	back to summary
public static boolean isCollectionMapOrArray(Class<?> type)

isConcrete	back to summary
public static boolean isConcrete(Class<?> type) Helper method that checks if given class is a concrete one; that is, not an interface or abstract class.

isConcrete	back to summary
public static boolean isConcrete(Member member)

isEnumType	back to summary
public static boolean isEnumType(Class<?> rawType) Helper method that encapsulates reliable check on whether given raw type "is an Enum", that is, is or extends `java.lang.Enum`.

isJacksonStdImpl back to summary

isJacksonStdImpl	back to summary
public static boolean isJacksonStdImpl(Object impl) Method that can be called to determine if given Object is the default implementation Jackson uses; as opposed to a custom serializer installed by a module or calling application. Determination is done using `JacksonStdImpl` annotation on handler (serializer, deserializer etc) class. Note passing `null` is legal, and will result in `true` being returned.

public static boolean isJacksonStdImpl(Object impl)

Method that can be called to determine if given Object is the default implementation Jackson uses; as opposed to a custom serializer installed by a module or calling application. Determination is done using JacksonStdImpl annotation on handler (serializer, deserializer etc) class.

Note

passing `null` is legal, and will result in true being returned.

isJacksonStdImpl	back to summary
public static boolean isJacksonStdImpl(Class<?> implClass)

isJDK17OrAbove back to summary

isJDK17OrAbove	back to summary
public static boolean isJDK17OrAbove() Convenience method for: return getJDKMajorVersion() >= 17 that also catches any possible exceptions so it is safe to call from static contexts. Returns:boolean `True` if we can determine that the code is running on JDK 17 or above; `false` otherwise. Since 2.15

public static boolean isJDK17OrAbove()

Convenience method for:

   return getJDKMajorVersion() >= 17

that also catches any possible exceptions so it is safe to call from static contexts.

Returns:boolean: True if we can determine that the code is running on JDK 17 or above; false otherwise.
Since: 2.15

isJDKClass back to summary

public static boolean isJDKClass(Class<?> rawType)

Accessor for checking whether given Class is under Java package of java.*, javax.* or sun.* (including all sub-packages).

Added since some aspects of handling need to be changed for JDK types (and possibly some extensions under javax. and sun.: for example, forcing of access will not work well for future JDKs.

isJDKCoreClass back to summary

public static boolean isJDKCoreClass(Class<?> rawType)

Similar to isJDKClass(Class), but for JDK core classes: those in packages under java.* but NOT under javax.* (or sun.*).

Since: 2.20

isLocalType	back to summary
public static String isLocalType(Class<?> type, boolean allowNonStatic)

isNonStaticInnerClass	back to summary
public static boolean isNonStaticInnerClass(Class<?> cls)

isObjectOrPrimitive	back to summary
public static boolean isObjectOrPrimitive(Class<?> cls)

isProxyType	back to summary
public static boolean isProxyType(Class<?> type) Helper method used to weed out dynamic Proxy types; types that do not expose concrete method API that we could use to figure out automatic Bean (property) based serialization.

isRecordType	back to summary
public static boolean isRecordType(Class<?> cls) Helper method for detecting Java14-added `Record` types

name	back to summary
public static String name(String name) Returns either single-quoted (apostrophe) `'name'` (if `name` not null), or "[null]" if `name` is null.

name	back to summary
public static String name(PropertyName name) Returns either single-quoted (apostrophe) `'name'` (if `name` not null), or "[null]" if `name` is null.

nameOf	back to summary
public static String nameOf(Class<?> cls) Returns either `cls.getName()` (if `cls` not null), or "[null]" if `cls` is null.

nameOf	back to summary
public static String nameOf(Named named) Returns either single-quoted (apostrophe) `'named.getName()'` (if `named` not null), or "[null]" if `named` is null.

nonNull	back to summary
public static <T> T nonNull(T valueOrNull, T defaultValue)

nonNullString	back to summary
public static String nonNullString(String str)

nullOrToString	back to summary
public static String nullOrToString(Object value)

primitiveType back to summary

public static Class<?> primitiveType(Class<?> type)

Method that can be used to find primitive type for given class if (but only if) it is either wrapper type or primitive type; returns null if type is neither.

Since: 2.7

quotedOr	back to summary
public static String quotedOr(Object str, String forNull)

rawClass	back to summary
public static Class<?> rawClass(JavaType t)

sneakyThrow

back to summary

public static <E extends Throwable> RuntimeException sneakyThrow(Throwable throwable) throws Throwable-:E

Throw an exception even if it's checked and not declared.

Annotations

@SuppressWarnings:unchecked

throwAsIAE	back to summary
public static void throwAsIAE(Throwable t) Method that will wrap 't' as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is

throwAsIAE	back to summary
public static void throwAsIAE(Throwable t, String msg) Method that will wrap 't' as an `IllegalArgumentException` (and with specified message) if it is a checked exception; otherwise (runtime exception or error) throw as is

throwIfError	back to summary
public static Throwable throwIfError(Throwable t) Helper method that will check if argument is an `Error`, and if so, (re)throw it; otherwise just return

throwIfJacksonE	back to summary
public static Throwable throwIfJacksonE(Throwable t) throws JacksonException Helper method that will check if argument is an `IOException`, and if so, (re)throw it; otherwise just return

throwIfRTE	back to summary
public static Throwable throwIfRTE(Throwable t) Helper method that will check if argument is an `RuntimeException`, and if so, (re)throw it; otherwise just return

throwRootCauseIfJacksonE	back to summary
public static Throwable throwRootCauseIfJacksonE(Throwable t) throws JacksonException Method that works like by calling `getRootCause` and then either throwing it (if instanceof `IOException`), or return.

unwrapAndThrowAsIAE	back to summary
public static void unwrapAndThrowAsIAE(Throwable t) Method that will locate the innermost exception for given Throwable; and then wrap it as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is

unwrapAndThrowAsIAE	back to summary
public static void unwrapAndThrowAsIAE(Throwable t, String msg) Method that will locate the innermost exception for given Throwable; and then wrap it as an `IllegalArgumentException` if it is a checked exception; otherwise (runtime exception or error) throw as is

verifyMustOverride	back to summary
public static void verifyMustOverride(Class<?> expType, Object instance, String method)

wrapperType	back to summary
public static Class<?> wrapperType(Class<?> primitiveType) Helper method for finding wrapper type for given primitive type (why isn't there one in JDK?). Note throws `IllegalArgumentException` if given type is NOT primitive type (caller has to check).

Modifier and Type	Field and Description
private transient Annotation[]	_annotations
public final Constructor<?>	_ctor
private transient Annotation[][]	_paramAnnotations
private int	_paramCount

Modifier and Type	Method and Description
public Constructor<?>	getConstructor()
public Annotation[]	getDeclaredAnnotations()
public Class<?>	getDeclaringClass()
public int	getParamCount()
public Annotation[][]	getParameterAnnotations()

Modifier and Type	Field and Description
private final Field	enumMapTypeField
private final Field	enumSetTypeField
private final String	failForEnumMap
private final String	failForEnumSet
pack-priv static final ClassUtil.EnumTypeLocator	instance

Modifier and Type	Method and Description
public Class<? extends Enum<?>>	enumTypeFor(EnumSet<?> set)
public Class<? extends Enum<?>>	enumTypeFor(EnumMap<?, ?> set)
private Object	get(Object bean, Field field)
private static Field	locateField(Class<?> fromClass, String expectedName, Class<?> type)

public final Class ClassUtil

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Class ClassUtil.Ctor

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ClassUtil.EnumTypeLocator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail