org.springframework.data.gemfire.util

Class SpringExtensions

java.lang.Object

org.springframework.data.gemfire.util.SpringExtensions

Direct Known Subclasses:

DistributedSystemUtils

public abstract class SpringExtensions
extends java.lang.Object

Abstract utility class encapsulating functionality common to Objects, Class types and Spring beans.

Since:

1.8.0

See Also:

Class, Object, Function, Stream, BeanFactory, FactoryBean, BeanDefinition, RuntimeBeanReference, Ordered, AnnotationAwareOrderComparator, Order

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SpringExtensions.OrderedBeanWrapper<T>
static interface	SpringExtensions.ValueReturningThrowableOperation<T>
static interface	SpringExtensions.VoidReturningThrowableOperation

Constructor Summary

Constructors

Constructor and Description
SpringExtensions()

Method Summary

Modifier and Type	Method and Description
static org.springframework.beans.factory.config.BeanDefinition	addDependsOn(org.springframework.beans.factory.config.BeanDefinition beanDefinition, java.lang.String... beanNames) Adds an array of bean dependencies (by name) to the given BeanDefinition.
static boolean	areNotNull(java.lang.Object... values) Determines whether all the Object values in the array are non-null
static java.lang.String	defaultIfEmpty(java.lang.String value, java.lang.String defaultValue)
static java.lang.String	defaultIfEmpty(java.lang.String value, java.util.function.Supplier<java.lang.String> supplier)
static <T> T	defaultIfNull(T value, java.util.function.Supplier<T> supplier)
static <T> T	defaultIfNull(T value, T defaultValue)
static java.lang.String	dereferenceBean(java.lang.String beanName)
static boolean	equalsIgnoreNull(java.lang.Object obj1, java.lang.Object obj2)
static <T> java.util.List<T>	getBeansOfTypeOrdered(org.springframework.beans.factory.config.ConfigurableListableBeanFactory beanFactory, java.lang.Class<T> beanType) Returns a List of beans by the given type in order.
static <T> java.util.List<T>	getBeansOfTypeOrdered(org.springframework.beans.factory.config.ConfigurableListableBeanFactory beanFactory, java.lang.Class<T> beanType, boolean includeNonSingletons, boolean allowEagerInit) Returns a List of beans by the given type in order.
static java.lang.Integer	getOrder(java.lang.Object target) Null-safe operation to return the order of the given Object if it is Ordered or null if the given Object is not Ordered.
static <T> java.util.stream.Stream<T>	getOrderedStreamOfBeansByType(org.springframework.beans.factory.BeanFactory beanFactory, java.lang.Class<T> beanType) Returns bean of the given type in an ordered Stream.
static java.util.Optional<java.lang.Object>	getPropertyValue(org.springframework.beans.factory.config.BeanDefinition beanDefinition, java.lang.String propertyName)
static boolean	isMatchingBean(org.springframework.beans.factory.BeanFactory beanFactory, java.lang.String beanName, java.lang.Class<?> beanType) Determines whether a given bean registered in the Spring container matches by both name and type.
static boolean	nullOrEquals(java.lang.Object obj1, java.lang.Object obj2)
static boolean	nullSafeEquals(java.lang.Object obj1, java.lang.Object obj2)
static java.lang.String	nullSafeName(java.lang.Class<?> type)
static java.lang.String	nullSafeSimpleName(java.lang.Class<?> type)
static java.lang.Class<?>	nullSafeType(java.lang.Object target)
static java.lang.Class<?>	nullSafeType(java.lang.Object target, java.lang.Class<?> defaultType)
static <T> T	requireObject(java.util.function.Supplier<T> objectSupplier, java.lang.String message)
static <T> T	requireObject(T object, java.lang.String message)
static boolean	safeDoOperation(SpringExtensions.VoidReturningThrowableOperation operation)
static boolean	safeDoOperation(SpringExtensions.VoidReturningThrowableOperation operation, java.lang.Runnable backupOperation)
static <T> T	safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation)
static <T> T	safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation, java.util.function.Function<java.lang.Throwable,T> exceptionHandler)
static <T> T	safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation, java.util.function.Supplier<T> defaultValueSupplier)
static <T> T	safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation, T defaultValue)
static void	safeRunOperation(SpringExtensions.VoidReturningThrowableOperation operation)
static void	safeRunOperation(SpringExtensions.VoidReturningThrowableOperation operation, java.util.function.Function<java.lang.Throwable,java.lang.RuntimeException> exceptionConverter)
static org.springframework.beans.factory.config.BeanDefinition	setPropertyReference(org.springframework.beans.factory.config.BeanDefinition beanDefinition, java.lang.String propertyName, java.lang.String beanName)
static org.springframework.beans.factory.config.BeanDefinition	setPropertyValue(org.springframework.beans.factory.config.BeanDefinition beanDefinition, java.lang.String propertyName, java.lang.Object propertyValue)

Methods inherited from class java.lang.Object

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

Constructor Detail

SpringExtensions

public SpringExtensions()

Method Detail

areNotNull

public static boolean areNotNull(java.lang.Object... values)

Determines whether all the Object values in the array are non-null

Parameters:

values - array of Objects to evaluate.

Returns:

a boolean value indicating whether all of the Object values in the array are non-null.

isMatchingBean

public static boolean isMatchingBean(@NonNull
                                     org.springframework.beans.factory.BeanFactory beanFactory,
                                     java.lang.String beanName,
                                     java.lang.Class<?> beanType)

Determines whether a given bean registered in the Spring container matches by both name and type.

Parameters:

beanFactory - Spring container in which to resolve the bean; must not be null.

beanName - name of the bean.

beanType - type of the bean.

Returns:

a boolean value indicating whether the Spring container contains a bean matching by both name and type.

See Also:

BeanFactory, Class, String

addDependsOn

@NonNull
public static org.springframework.beans.factory.config.BeanDefinition addDependsOn(@NonNull
                                                                                            org.springframework.beans.factory.config.BeanDefinition beanDefinition,
                                                                                            @Nullable
                                                                                            java.lang.String... beanNames)

Adds an array of bean dependencies (by name) to the given BeanDefinition.

Parameters:

beanDefinition - BeanDefinition to add the bean dependencies to; must not be null.

beanNames - String array containing names of beans for which the BeanDefinition depends on (or has a dependency).

Returns:

the given BeanDefinition.

See Also:

BeanDefinition

getBeansOfTypeOrdered

@NonNull
public static <T> java.util.List<T> getBeansOfTypeOrdered(@NonNull
                                                                   org.springframework.beans.factory.config.ConfigurableListableBeanFactory beanFactory,
                                                                   @NonNull
                                                                   java.lang.Class<T> beanType)

Returns a List of beans by the given type in order.

Type Parameters:

T - type of the bean.

Parameters:

beanFactory - Spring container used to acquire the ordered beans.

beanType - type of beans to acquire.

Returns:

a List of beans of the given type in order.

See Also:

getBeansOfTypeOrdered(ConfigurableListableBeanFactory, Class, boolean, boolean), ConfigurableListableBeanFactory, Class, List

getBeansOfTypeOrdered

@NonNull
public static <T> java.util.List<T> getBeansOfTypeOrdered(@NonNull
                                                                   org.springframework.beans.factory.config.ConfigurableListableBeanFactory beanFactory,
                                                                   @NonNull
                                                                   java.lang.Class<T> beanType,
                                                                   boolean includeNonSingletons,
                                                                   boolean allowEagerInit)

Returns a List of beans by the given type in order.

Type Parameters:

T - type of the bean.

Parameters:

beanFactory - Spring container used to acquire the ordered beans.

beanType - type of beans to acquire.

includeNonSingletons - boolean indicating whether to include non-Singleton beans from the Spring container.

allowEagerInit - boolean indicating whether to eagerly initialize FactoryBeans.

Returns:

a List of beans of the given type in order.

See Also:

ConfigurableListableBeanFactory, Class, List

getOrder

@Nullable
public static java.lang.Integer getOrder(@Nullable
                                                   java.lang.Object target)

Null-safe operation to return the order of the given Object if it is Ordered or null if the given Object is not Ordered.

Parameters:

target - Object to evaluate; may be null.

Returns:

the order of the given Object if Ordered, otherwise return null.

See Also:

Ordered

getOrderedStreamOfBeansByType

public static <T> java.util.stream.Stream<T> getOrderedStreamOfBeansByType(@NonNull
                                                                           org.springframework.beans.factory.BeanFactory beanFactory,
                                                                           @NonNull
                                                                           java.lang.Class<T> beanType)

Returns bean of the given type in an ordered Stream.

Type Parameters:

T - type of the beans.

Parameters:

beanFactory - BeanFactory from which to acquire the beans.

beanType - type of the beans.

Returns:

an ordered Stream of beans from the BeanFactory of the given type.

See Also:

BeanFactory, Stream, Class

getPropertyValue

public static java.util.Optional<java.lang.Object> getPropertyValue(org.springframework.beans.factory.config.BeanDefinition beanDefinition,
                                                                    java.lang.String propertyName)

setPropertyReference

public static org.springframework.beans.factory.config.BeanDefinition setPropertyReference(org.springframework.beans.factory.config.BeanDefinition beanDefinition,
                                                                                           java.lang.String propertyName,
                                                                                           java.lang.String beanName)

setPropertyValue

public static org.springframework.beans.factory.config.BeanDefinition setPropertyValue(org.springframework.beans.factory.config.BeanDefinition beanDefinition,
                                                                                       java.lang.String propertyName,
                                                                                       java.lang.Object propertyValue)

defaultIfEmpty

public static java.lang.String defaultIfEmpty(java.lang.String value,
                                              java.lang.String defaultValue)

defaultIfEmpty

public static java.lang.String defaultIfEmpty(java.lang.String value,
                                              java.util.function.Supplier<java.lang.String> supplier)

defaultIfNull

public static <T> T defaultIfNull(T value,
                                  T defaultValue)

defaultIfNull

public static <T> T defaultIfNull(T value,
                                  java.util.function.Supplier<T> supplier)

dereferenceBean

public static java.lang.String dereferenceBean(java.lang.String beanName)

equalsIgnoreNull

public static boolean equalsIgnoreNull(java.lang.Object obj1,
                                       java.lang.Object obj2)

nullOrEquals

public static boolean nullOrEquals(java.lang.Object obj1,
                                   java.lang.Object obj2)

nullSafeEquals

public static boolean nullSafeEquals(java.lang.Object obj1,
                                     java.lang.Object obj2)

nullSafeName

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

nullSafeSimpleName

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

nullSafeType

public static java.lang.Class<?> nullSafeType(java.lang.Object target)

nullSafeType

public static java.lang.Class<?> nullSafeType(java.lang.Object target,
                                              java.lang.Class<?> defaultType)

requireObject

public static <T> T requireObject(@Nullable
                                  T object,
                                  java.lang.String message)

requireObject

public static <T> T requireObject(@NonNull
                                  java.util.function.Supplier<T> objectSupplier,
                                  java.lang.String message)

safeDoOperation

public static boolean safeDoOperation(SpringExtensions.VoidReturningThrowableOperation operation)

safeDoOperation

public static boolean safeDoOperation(SpringExtensions.VoidReturningThrowableOperation operation,
                                      java.lang.Runnable backupOperation)

safeGetValue

public static <T> T safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation)

safeGetValue

public static <T> T safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation,
                                 T defaultValue)

safeGetValue

public static <T> T safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation,
                                 java.util.function.Supplier<T> defaultValueSupplier)

safeGetValue

public static <T> T safeGetValue(SpringExtensions.ValueReturningThrowableOperation<T> operation,
                                 java.util.function.Function<java.lang.Throwable,T> exceptionHandler)

safeRunOperation

public static void safeRunOperation(SpringExtensions.VoidReturningThrowableOperation operation)

safeRunOperation

public static void safeRunOperation(SpringExtensions.VoidReturningThrowableOperation operation,
                                    java.util.function.Function<java.lang.Throwable,java.lang.RuntimeException> exceptionConverter)