Class ObjectUtils

src/main/java/net/mtrop/doom/tools/struct/util/ObjectUtils.java:31–389

Simple utility functions around plain objects. @author Matthew Tropiano

 * @author Matthew Tropiano
 */
public final class ObjectUtils
{
	private ObjectUtils() {}

	/**
	 * Apply function for objects.
	 * @param input the input object to manipulate.
	 * @param applier the function to pass the input element to.
	 * @param <T> the return/input type.
	 * @return the input object.
	 */
	public static <T> T apply(T input, Consumer<T> applier)
	{
		applier.accept(input);
		return input;
	}
	
	/**
	 * Returns if two objects are equal, performing null checking. 
	 * @param a the first object.
	 * @param b the second object.
	 * @return true if equal, false if not.
	 * @see Object#equals(Object)
	 */
	public static boolean areEqual(Object a, Object b)
	{
		if (a == null)
			return b == null;
		else if (b == null)
			return false;
		else
			return a.equals(b);
	}

	/**
	 * Returns the first object if it is not null, otherwise returns the second. 
	 * @param <T> class that extends Object.
	 * @param testObject the first ("tested") object.
	 * @param nullReturn the object to return if testObject is null.
	 * @return testObject if not null, nullReturn otherwise.
	 */
	public static <T> T isNull(T testObject, T nullReturn)
	{
		return testObject != null ? testObject : nullReturn;
	}

	/**
	 * Returns the first object if it is not null, otherwise returns the second. 
	 * @param <T> class that extends Object.
	 * @param testObject the first ("tested") object.
	 * @param nullReturn the Supplier to call to return if testObject is null.
	 * @return testObject if not null, nullReturn otherwise.
	 */
	public static <T> T isNull(T testObject, Supplier<T> nullReturn)
	{
		return testObject != null ? testObject : nullReturn.get();
	}