org.optaplanner.core.config.util

Class ConfigUtils

java.lang.Object

org.optaplanner.core.config.util.ConfigUtils

public class ConfigUtils
extends Object

Method Summary

Methods

Modifier and Type	Method and Description
static int	ceilDivide(int dividend, int divisor) Divides and ceils the result without using floating point arithmetic.
static long	floorDivide(long dividend, long divisor) Divides and floors the result without using floating point arithmetic.
static <C extends AbstractConfig<C>> C	inheritConfig(C original, C inherited)
static <C extends AbstractConfig<C>> List<C>	inheritMergeableListConfig(List<C> originalList, List<C> inheritedList)
static <T> List<T>	inheritMergeableListProperty(List<T> originalList, List<T> inheritedList)
static <K,T> Map<K,T>	inheritMergeableMapProperty(Map<K,T> originalMap, Map<K,T> inheritedMap)
static <T> T	inheritOverwritableProperty(T original, T inherited)
static boolean	isEmptyCollection(Collection<?> collection)
static <T> T	meldProperty(T a, T b) A relaxed version of mergeProperty(Object, Object).
static <T> T	mergeProperty(T a, T b)
static <T> T	newInstance(Object bean, String propertyName, Class<T> clazz)

Methods inherited from class java.lang.Object

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

Method Detail

newInstance

public static <T> T newInstance(Object bean,
                String propertyName,
                Class<T> clazz)

inheritConfig

public static <C extends AbstractConfig<C>> C inheritConfig(C original,
                                            C inherited)

inheritMergeableListConfig

public static <C extends AbstractConfig<C>> List<C> inheritMergeableListConfig(List<C> originalList,
                                                               List<C> inheritedList)

inheritOverwritableProperty

public static <T> T inheritOverwritableProperty(T original,
                                T inherited)

inheritMergeableListProperty

public static <T> List<T> inheritMergeableListProperty(List<T> originalList,
                                       List<T> inheritedList)

inheritMergeableMapProperty

public static <K,T> Map<K,T> inheritMergeableMapProperty(Map<K,T> originalMap,
                                         Map<K,T> inheritedMap)

mergeProperty

public static <T> T mergeProperty(T a,
                  T b)

meldProperty

public static <T> T meldProperty(T a,
                 T b)

A relaxed version of mergeProperty(Object, Object). Used primarily for merging failed benchmarks, where a property remains the same over benchmark runs (for example: dataset problem size), but the property in the failed benchmark isn't initialized, therefore null. When merging, we can still use the correctly initialized property of the benchmark that didn't fail.

Null-handling:

• if both properties are null, returns null
• if only one of the properties is not null, returns that property
• if both properties are not null, returns mergeProperty(Object, Object)

Type Parameters:

T - the type of property a and b

Parameters:

a - property a

b - property b

Returns:

sometimes null

See Also:

mergeProperty(Object, Object)

isEmptyCollection

public static boolean isEmptyCollection(Collection<?> collection)

ceilDivide

public static int ceilDivide(int dividend,
             int divisor)

Divides and ceils the result without using floating point arithmetic. For floor division, see floorDivide(long, long).

Parameters:

dividend - the dividend

divisor - the divisor

Returns:

dividend / divisor, ceiled

Throws:

ArithmeticException - if divisor == 0

floorDivide

public static long floorDivide(long dividend,
               long divisor)

Divides and floors the result without using floating point arithmetic. For ceil division, see ceilDivide(int, int).

Parameters:

dividend - the dividend

divisor - the divisor

Returns:

dividend / divisor, floored

Throws:

ArithmeticException - if divisor == 0