org.microbean.microprofile.config

Interface TypeConverter

All Known Implementing Classes:

Config, ConversionHub

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface TypeConverter

An interface indicating that implementations might be able to convert String values to a variety of differently-typed objects.

Author:

Laird Nelson

See Also:

convert(String, Type)

Method Summary

Modifier and Type	Method and Description
<T> T	convert(String rawValue, Type type) Converts the supplied String value to an object of the supplied Type, and returns it.

Method Detail

convert

<T> T convert(String rawValue,
              Type type)

Converts the supplied String value to an object of the supplied Type, and returns it.

Implementations of this method are permitted to return null.

Type Parameters:

T - the type of the return value, assumed to be assignable to references of the supplied type

Parameters:

rawValue - the String value to convert; may be null

type - the Type to which the value should be converted; must not be null; the type of the return value resulting from invocations of implementations of this method should be assignable to references of this type

Returns:

the converted object, which may be null

Throws:

NullPointerException - if type is null

IllegalArgumentException - if conversion could not occur for any reason