org.fujion.common

Class MiscUtil

java.lang.Object

org.fujion.common.MiscUtil

public class MiscUtil
extends Object

Miscellaneous utility methods.

Method Summary

Modifier and Type	Method and Description
static void	assertState(boolean state, String message) Asserts that a tested state is true, throwing an IllegalStateException if not.
static void	assertState(boolean state, Supplier<String> message) Asserts that a tested state is true, throwing an IllegalStateException if not.
static void	assertTrue(boolean condition, String message) Asserts that a condition is true, throwing an IllegalArgumentException if not.
static void	assertTrue(boolean condition, Supplier<String> message) Asserts that a tested condition is true, throwing an IllegalArgumentException if not.
static <T> T	castTo(Object value, Class<T> type) Casts a value to the specified type, returning null if the cast is not possible.
static boolean	fileExists(String fileName) Returns true if the specified file exists.
static Class<?>	firstAssignable(Class<?> type, Class<?>... candidates) Returns the first class from a list of candidate classes that is assignable from the specified type.
static Class<?>	firstAssignable(Class<?> type, Collection<Class<?>> candidates) Returns the first class in a collection of candidate classes that is assignable from the specified type.
static Class<?>[]	getParameterTypes(Object... parameters) Returns an array of parameter types given an array of parameters.
static Pattern	globToRegex(String glob) Converts a glob search pattern to a regular expression.
static RuntimeException	toUnchecked(Throwable e) Converts a checked exception to unchecked.

Methods inherited from class java.lang.Object

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

Method Detail

fileExists

public static boolean fileExists(String fileName)

Returns true if the specified file exists.

Parameters:

fileName - File name.

Returns:

True if file exists.

toUnchecked

public static RuntimeException toUnchecked(Throwable e)

Converts a checked exception to unchecked. If the original exception is already unchecked, it is simply returned.

Parameters:

e - The original exception.

Returns:

The returned unchecked exception.

getParameterTypes

public static Class<?>[] getParameterTypes(Object... parameters)

Returns an array of parameter types given an array of parameters. Unlike other libraries, this allows null parameter values.

Parameters:

parameters - Array of parameters.

Returns:

Array of parameter types.

castTo

public static <T> T castTo(Object value,
                           Class<T> type)

Casts a value to the specified type, returning null if the cast is not possible.

Type Parameters:

T - The type to cast to.

Parameters:

value - The value to cast.

type - The type to cast to.

Returns:

The original value, cast to the specified type, or null if the cast is not possible.

firstAssignable

public static Class<?> firstAssignable(Class<?> type,
                                       Class<?>... candidates)

Returns the first class from a list of candidate classes that is assignable from the specified type.

Parameters:

type - The type.

candidates - A list of candidate types.

Returns:

The first class that is assignable from the specified type.

firstAssignable

public static Class<?> firstAssignable(Class<?> type,
                                       Collection<Class<?>> candidates)

Returns the first class in a collection of candidate classes that is assignable from the specified type.

Parameters:

type - The type.

candidates - A collection of candidate types.

Returns:

The first class that is assignable from the specified type.

globToRegex

public static Pattern globToRegex(String glob)

Converts a glob search pattern to a regular expression.

Parameters:

glob - Glob search pattern.

Returns:

Regular expression.

assertTrue

public static void assertTrue(boolean condition,
                              String message)

Asserts that a condition is true, throwing an IllegalArgumentException if not.

Parameters:

condition - The condition to test.

message - The exception message.

Throws:

IllegalArgumentException - if condition is false.

assertTrue

public static void assertTrue(boolean condition,
                              Supplier<String> message)

Asserts that a tested condition is true, throwing an IllegalArgumentException if not.

Parameters:

condition - The tested condition.

message - The exception message.

Throws:

IllegalArgumentException - if condition is false.

assertState

public static void assertState(boolean state,
                               String message)

Asserts that a tested state is true, throwing an IllegalStateException if not.

Parameters:

state - The tested state.

message - The exception message.

Throws:

IllegalStateException - if state is false.

assertState

public static void assertState(boolean state,
                               Supplier<String> message)

Asserts that a tested state is true, throwing an IllegalStateException if not.

Parameters:

state - The tested state.

message - The exception message.

Throws:

IllegalStateException - if state is false.