net.openhft.chronicle.core.util

Enum ObjectUtils

java.lang.Object

java.lang.Enum<ObjectUtils>

net.openhft.chronicle.core.util.ObjectUtils

All Implemented Interfaces:

Serializable, Comparable<ObjectUtils>

public enum ObjectUtils
extends Enum<ObjectUtils>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ObjectUtils.Immutability

Method Summary

Modifier and Type	Method and Description
static <T> T[]	addAll(T first, T... additional)
static @NotNull ClassCastException	asCCE(Exception e)
static void	checkNonNull(Object obj) Checks that the provided object reference is not null throwing an IllegalArgumentException.
static <E> E	convertTo(@Nullable Class<E> eClass, @Nullable Object o)
static void	defaultObjectForInterface(ThrowingFunction<Class,Class,ClassNotFoundException> defaultObjectForInterface)
static Object	defaultValue(Class<?> type)
static Class<?>[]	getAllInterfaces(Object o)
static void	getAllInterfaces(Object o, Function<Class<?>,Boolean> accumulator)
static <E extends Enum<E>> E	getSingletonForEnum(Class<E> eClass)
static @NotNull Class	getTypeFor(@NotNull Class clazz, @NotNull Class interfaceClass) Deprecated.
static @NotNull Class	getTypeFor(@NotNull Class clazz, @NotNull Class interfaceClass, int index) Deprecated.
static void	immutabile(Class clazz, boolean isImmutable)
static <T> Class<T>	implementationToUse(Class<T> tClass)
static boolean	isConcreteClass(@NotNull Class tClass)
static boolean	isFalse(CharSequence s)
static ObjectUtils.Immutability	isImmutable(@NotNull Class clazz)
static boolean	isTrue(CharSequence s)
protected static @NotNull Class	lookForImplEnum(Class c2)
static boolean	matchingClass(@NotNull Class base, @NotNull Class toMatch)
static <T> T	newInstance(@NotNull Class<T> clazz)
static <T> T	newInstance(@NotNull String className)
static @Nullable Object	newInstanceOrNull(Class type)
static <T> T	onMethodCall(@NotNull BiFunction<Method,Object[],Object> biFunction, @NotNull Class<T> tClass, Class... additional)
static Class	primToWrapper(Class eClass) If the class is a primitive type, change it to the equivalent wrapper.
static Object	readResolve(@NotNull Object o)
static <T> T	requireNonNull(T o) Standard mechanism to determine objects as not null.
static @NotNull Boolean	toBoolean(String s)
static ObjectUtils	valueOf(String name) Returns the enum constant of this type with the specified name.
static <E extends Enum<E>> E	valueOfIgnoreCase(@NotNull Class<E> eClass, @NotNull String name)
static ObjectUtils[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

values

public static ObjectUtils[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ObjectUtils c : ObjectUtils.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ObjectUtils valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

immutabile

public static void immutabile(Class clazz,
                              boolean isImmutable)

isImmutable

public static ObjectUtils.Immutability isImmutable(@NotNull
                                                   @NotNull Class clazz)

isTrue

public static boolean isTrue(CharSequence s)

isFalse

public static boolean isFalse(CharSequence s)

primToWrapper

public static Class primToWrapper(Class eClass)

If the class is a primitive type, change it to the equivalent wrapper.

Parameters:

eClass - to check

Returns:

the wrapper class if eClass is a primitive type, or the eClass if not.

convertTo

@Nullable
public static <E> E convertTo(@Nullable
                                        @Nullable Class<E> eClass,
                                        @Nullable
                                        @Nullable Object o)
                                 throws ClassCastException,
                                        IllegalArgumentException

Throws:

ClassCastException

IllegalArgumentException

valueOfIgnoreCase

@NotNull
public static <E extends Enum<E>> E valueOfIgnoreCase(@NotNull
                                                               @NotNull Class<E> eClass,
                                                               @NotNull
                                                               @NotNull String name)

getSingletonForEnum

public static <E extends Enum<E>> E getSingletonForEnum(Class<E> eClass)

asCCE

@NotNull
public static @NotNull ClassCastException asCCE(Exception e)

newInstance

@NotNull
public static <T> T newInstance(@NotNull
                                         @NotNull String className)

newInstance

@NotNull
public static <T> T newInstance(@NotNull
                                         @NotNull Class<T> clazz)

newInstanceOrNull

@Nullable
public static @Nullable Object newInstanceOrNull(Class type)

addAll

public static <T> T[] addAll(@NotNull
                             T first,
                             @NotNull
                             T... additional)

matchingClass

public static boolean matchingClass(@NotNull
                                    @NotNull Class base,
                                    @NotNull
                                    @NotNull Class toMatch)

defaultValue

public static Object defaultValue(Class<?> type)

onMethodCall

@NotNull
public static <T> T onMethodCall(@NotNull
                                          @NotNull BiFunction<Method,Object[],Object> biFunction,
                                          @NotNull
                                          @NotNull Class<T> tClass,
                                          Class... additional)
                                   throws IllegalArgumentException

Throws:

IllegalArgumentException

getTypeFor

@Deprecated
 @NotNull
public static @NotNull Class getTypeFor(@NotNull
                                                              @NotNull Class clazz,
                                                              @NotNull
                                                              @NotNull Class interfaceClass)
                                                       throws IllegalArgumentException

Deprecated.

Throws:

IllegalArgumentException

getTypeFor

@Deprecated
 @NotNull
public static @NotNull Class getTypeFor(@NotNull
                                                              @NotNull Class clazz,
                                                              @NotNull
                                                              @NotNull Class interfaceClass,
                                                              int index)
                                                       throws IllegalArgumentException

Deprecated.

Throws:

IllegalArgumentException

isConcreteClass

public static boolean isConcreteClass(@NotNull
                                      @NotNull Class tClass)

readResolve

public static Object readResolve(@NotNull
                                 @NotNull Object o)

toBoolean

@NotNull
public static @NotNull Boolean toBoolean(String s)

getAllInterfaces

public static Class<?>[] getAllInterfaces(Object o)

getAllInterfaces

public static void getAllInterfaces(Object o,
                                    Function<Class<?>,Boolean> accumulator)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

defaultObjectForInterface

public static void defaultObjectForInterface(ThrowingFunction<Class,Class,ClassNotFoundException> defaultObjectForInterface)

lookForImplEnum

@NotNull
protected static @NotNull Class lookForImplEnum(Class c2)

implementationToUse

public static <T> Class<T> implementationToUse(Class<T> tClass)

requireNonNull

public static <T> T requireNonNull(@NotNull
                                   T o)

Standard mechanism to determine objects as not null. Same method contract as Objects.requireNonNull(Object) and also decorated with NotNull so that IntelliJ and other static analysis tools can work their magic.

Parameters:

o - reference to check for nullity

Throws:

NullPointerException - if o is null

See Also:

throwing an {@link IllegalArgumentException} instead

checkNonNull

public static void checkNonNull(Object obj)

Checks that the provided object reference is not null throwing an IllegalArgumentException. if it is. By default, instrumented classes will throw an IllegalArgumentException if annotated with NotNull and this method can be used to mimic that behaviour. This method is designed primarily for doing parameter validation in methods and constructors, as demonstrated below:

 public Foo(Bar bar) {
     checkNonNull(bar);
 }
 

Parameters:

obj - the object reference to check for nullity

Throws:

IllegalArgumentException - if obj is null

See Also:

throwing a {@link NullPointerException} instead