org.microbean.settings.converter

Class ArrayConverter<T>

java.lang.Object

org.microbean.settings.converter.ArrayConverter<T>

@Vetoed
public abstract class ArrayConverter<T>
extends Object

An abstract class that can serve as the base class for implementations of, but which deliberately does not itself implement, the Converter interface.

Author:

Laird Nelson

See Also:

Converter, convert(Value)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ArrayConverter(Converter<? extends Collection<? extends T>> collectionConverter) Creates a new ArrayConverter.

Method Summary

Modifier and Type	Method and Description
T[]	convert(Value value) Converts the supplied Value into an appropriately-typed array and returns the result.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayConverter

protected ArrayConverter(Converter<? extends Collection<? extends T>> collectionConverter)

Creates a new ArrayConverter.

Parameters:

collectionConverter - a Converter that returns Collections whose elements are of the appropriate type from its Converter.convert(Value) method; must not be null

Throws:

NullPointerException - if collectionConverter is null

See Also:

convert(Value)

Method Detail

convert

public T[] convert(Value value)

Converts the supplied Value into an appropriately-typed array and returns the result.

Parameters:

value - the Value to convert; may be null

Returns:

an appropriately-typed array, or null

See Also:

Converter.convert(Value)

Idempotency:

No guarantees are made about the idempotency of this method or its overrides.

Nullability:

This method does and its overrides are permitted to return null.

Thread Safety:

This method is and its overrides must be safe for concurrent use by multiple threads.