berlin.yuna.typemap.logic

Class TypeConverter

java.lang.Object

berlin.yuna.typemap.logic.TypeConverter

public class TypeConverter
extends Object

Method Summary

Modifier and Type	Method and Description
static <E> E[]	arrayOf(Object[] array, E[] typeIndicator, Class<E> componentType) Converts an array of objects to an array of a specified type.
static <E> E[]	arrayOf(Object[] array, IntFunction<E[]> generator, Class<E> componentType) Converts an array of objects to an array of a specified type using a generator function.
static <E> E[]	arrayOf(Object object, E[] typeIndicator, Class<E> componentType) Converts an object to an array of a specified type.
static <E> E[]	arrayOf(Object object, IntFunction<E[]> generator, Class<E> componentType) Converts an object to an array of a specified type using a generator function.
static <T extends Collection<E>,E> T	collectionOf(Object input, Supplier<? extends T> output, Class<E> itemType) Creates a collection of a specific typeId containing elements of a specific typeId based on the given input.
static <T> T	convertObj(Object value, Class<T> targetType) Safely converts an object to the specified target typeId.
static <T extends Enum<T>> T	enumOf(String value, Class<T> enumType) Converts a string value to an enum of a specified type.
static <K,V,M extends Map<K,V>> M	mapOf(Map<?,?> input, Supplier<M> output, Class<K> keyType, Class<V> valueType) Creates a new map of typeId M from the given input map.

Methods inherited from class java.lang.Object

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

Method Detail

convertObj

public static <T> T convertObj(Object value,
                               Class<T> targetType)

Safely converts an object to the specified target typeId.

This method provides a way to convert between common types such as String, Boolean, LocalDateTime, Numbers, Collections, and Maps. If the value is already of the target typeId, it will simply be cast and returned. Otherwise, the method attempts to safely convert the value to the desired typeId.

• If the target typeId is String, the method converts the value using toString().
• If the target typeId is Boolean and the value is a string representation of a boolean, the method converts it using Boolean.valueOf().
• If the target typeId is LocalDateTime and the value is a Date, it converts it to LocalDateTime.
• If the target typeId is Byte and the value is a number, it casts it to byte.
• If the target typeId is a subclass of Number and the value is a number, it invokes numberOf to convert it.
• If the target typeId is a Collection or Map, and the value is already of that typeId, it will simply be cast and returned.

Type Parameters:

T - The target typeId to convert the value to.

Parameters:

value - The object value to convert.

targetType - The class of the target typeId.

Returns:

The converted object of typeId T, or null if the conversion is not supported.

mapOf

public static <K,V,M extends Map<K,V>> M mapOf(Map<?,?> input,
                                               Supplier<M> output,
                                               Class<K> keyType,
                                               Class<V> valueType)

Creates a new map of typeId M from the given input map. The keys and values are converted to types K and V respectively.

Type Parameters:

K - The typeId of the keys in the output map.

V - The typeId of the values in the output map.

M - The typeId of the output map, which must be a subclass of Map<K, V>.

Parameters:

input - The input map containing keys and values to be converted.

output - A Supplier for the output map of typeId M.

keyType - The Class object representing the typeId of key to convert to.

valueType - The Class object representing the typeId of value to convert to.

Returns:

A new map of typeId M with keys and values converted to types K and V. Returns null if the output map is null.

collectionOf

public static <T extends Collection<E>,E> T collectionOf(Object input,
                                                         Supplier<? extends T> output,
                                                         Class<E> itemType)

Creates a collection of a specific typeId containing elements of a specific typeId based on the given input. The function handles three types of input: - A Collection - An Array - A single Object

Type Parameters:

T - Type of the target collection.

E - Type of the elements in the target collection.

Parameters:

input - The input object, which can be an array or a collection.

output - A supplier for creating an empty collection of typeId T.

itemType - The class typeId of the elements to be contained in the output collection.

Returns:

A collection of typeId T containing elements of typeId E, or null if conversion is not possible.

The method handles three scenarios: 1. If the input is already a collection, it converts it to a collection of typeId T containing elements of typeId E. 2. If the input is an array, it converts it to a collection of typeId T containing elements of typeId E. 3. If the input is a single object, it converts it to typeId E and returns a collection of typeId T containing that single element.

arrayOf

public static <E> E[] arrayOf(Object object,
                              E[] typeIndicator,
                              Class<E> componentType)

Converts an object to an array of a specified type. If the object is a collection, each element is converted to the component type of the array.

Type Parameters:

E - The component type of the array.

Parameters:

object - The object to be converted.

typeIndicator - An array instance indicating the type of array to return.

componentType - The class of the array's component type.

Returns:

an array of the specified component type.

arrayOf

public static <E> E[] arrayOf(Object object,
                              IntFunction<E[]> generator,
                              Class<E> componentType)

Converts an object to an array of a specified type using a generator function. If the object is a collection, each element is converted to the component type of the array.

Type Parameters:

E - The component type of the array.

Parameters:

object - The object to be converted.

generator - A function to generate the array of the required size.

componentType - The class of the array's component type.

Returns:

an array of the specified component type.

arrayOf

public static <E> E[] arrayOf(Object[] array,
                              E[] typeIndicator,
                              Class<E> componentType)

Converts an array of objects to an array of a specified type.

Type Parameters:

E - The component type of the target array.

Parameters:

array - The array to be converted.

typeIndicator - An array instance indicating the type of array to return.

componentType - The class of the array's component type.

Returns:

an array of the specified component type.

arrayOf

public static <E> E[] arrayOf(Object[] array,
                              IntFunction<E[]> generator,
                              Class<E> componentType)

Converts an array of objects to an array of a specified type using a generator function.

Type Parameters:

E - The component type of the target array.

Parameters:

array - The array to be converted.

generator - A function to generate the array of the required size.

componentType - The class of the array's component type.

Returns:

an array of the specified component type.

enumOf

public static <T extends Enum<T>> T enumOf(String value,
                                           Class<T> enumType)

Converts a string value to an enum of a specified type. If the value does not match any enum constants, or if an error occurs, this method returns null.

Type Parameters:

T - The enum type to which the string is to be converted.

Parameters:

value - The string value to be converted to an enum constant.

enumType - The class of the enum type.

Returns:

the enum constant corresponding to the given string, or null if no match is found.