reactor.test

Class ValueFormatters

java.lang.Object

reactor.test.ValueFormatters

public final class ValueFormatters
extends Object

An utility class to create ValueFormatters.ToStringConverter Function that convert objects to String. They can be applied to any Object but will restrict the types they actually convert by filtering and defaulting to String.valueOf(Object).

Also defines ValueFormatters.Extractor BiFunction that extract multiple elements from containers and applies a Function (most probably a ValueFormatters.ToStringConverter) to its elements, reforming a complete String representation. Again, this matches on at least a given Class and potentially an additional Predicate.

An additional static utility method convertVarArgs(ToStringConverter, Collection, Object...) can be used to apply such functions and to varargs.

Author:

Simon Baslé

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ValueFormatters.Extractor<CONTAINER> An extractor of data wrapped in a BiFunction aiming at producing a customized String representation of a container type and its contained elements, each element being potentially itself converted to String using a ValueFormatters.ToStringConverter: it only considers specific container types, see ValueFormatters.Extractor.getTargetClass() it can further filter these container instances using ValueFormatters.Extractor.matches(Object) it can be applied to arbitrary objects, as it will default to String.valueOf(Object) on non-matching containers it can apply a ValueFormatters.ToStringConverter to the content, passed as the second parameter of the BiFunction it reconstructs the String representation of the container by exploding it and then joining it with {#code ", "} delimiter, as well as custom ValueFormatters.Extractor.prefix(Object) and ValueFormatters.Extractor.suffix(Object)
static interface	ValueFormatters.ToStringConverter A generic Object to String conversion Function which is also a Predicate, and which only applies a custom conversion to targets that match said Predicate.

Field Summary

Fields

Modifier and Type	Field and Description
static ValueFormatters.ToStringConverter	DURATION_CONVERTER Default Duration ValueFormatters.ToStringConverter that removes the PT prefix and switches to lower case.

Method Summary

Modifier and Type	Method and Description
static <T> ValueFormatters.Extractor<T[]>	arrayExtractor(Class<T[]> arrayClass) Default array extractor that use the [CONVERTED1, CONVERTED2] representation.
static ValueFormatters.ToStringConverter	filtering(Predicate<Object> predicate, Function<Object,String> anyToString) Create a value formatter that applies the given String conversion Function only to objects matching a given Predicate
static <T> ValueFormatters.ToStringConverter	forClass(Class<T> tClass, Function<T,String> tToString) Create a value formatter that is specific to a particular Class, applying the given String conversion Function provided the object is an instance of that Class.
static <T> ValueFormatters.ToStringConverter	forClassMatching(Class<T> tClass, Predicate<T> tPredicate, Function<T,String> tToString) Create a value formatter that is specific to a particular Class and filters based on a provided Predicate.
static ValueFormatters.Extractor<Iterable>	iterableExtractor() Default Iterable extractor that use the [CONVERTED1, CONVERTED2] representation.
static ValueFormatters.Extractor<Signal>	signalExtractor() Default Signal extractor that unwraps only onNext.

Methods inherited from class java.lang.Object

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

Field Detail

DURATION_CONVERTER

public static final ValueFormatters.ToStringConverter DURATION_CONVERTER

Default Duration ValueFormatters.ToStringConverter that removes the PT prefix and switches to lower case.

Method Detail

forClass

public static <T> ValueFormatters.ToStringConverter forClass(Class<T> tClass,
                                                             Function<T,String> tToString)

Create a value formatter that is specific to a particular Class, applying the given String conversion Function provided the object is an instance of that Class.

Type Parameters:

T - the generic type of the matching objects

Parameters:

tClass - the Class to convert

tToString - the String conversion Function for objects of that class

Returns:

the class-specific formatter

forClassMatching

public static <T> ValueFormatters.ToStringConverter forClassMatching(Class<T> tClass,
                                                                     Predicate<T> tPredicate,
                                                                     Function<T,String> tToString)

Create a value formatter that is specific to a particular Class and filters based on a provided Predicate. All objects of said class that additionally pass the Predicate are converted to String using the provided conversion Function.

Type Parameters:

T - the generic type of the matching objects

Parameters:

tClass - the Class to convert

tPredicate - the Predicate to further filter what to convert to string

tToString - the String conversion Function for objects of that class matching the predicate

Returns:

the class-specific predicate-filtering formatter

filtering

public static ValueFormatters.ToStringConverter filtering(Predicate<Object> predicate,
                                                          Function<Object,String> anyToString)

Create a value formatter that applies the given String conversion Function only to objects matching a given Predicate

Parameters:

predicate - the Predicate used to filter objects to format

anyToString - the String conversion Function (without input typing)

Returns:

the predicate-specific formatter

signalExtractor

public static ValueFormatters.Extractor<Signal> signalExtractor()

Default Signal extractor that unwraps only onNext. These Signal instances have a Signal representation like so: "onNext(CONVERTED)".

Returns:

the default Signal extractor

iterableExtractor

public static ValueFormatters.Extractor<Iterable> iterableExtractor()

Default Iterable extractor that use the [CONVERTED1, CONVERTED2] representation.

Returns:

the default Iterable extractor

arrayExtractor

public static <T> ValueFormatters.Extractor<T[]> arrayExtractor(Class<T[]> arrayClass)

Default array extractor that use the [CONVERTED1, CONVERTED2] representation.

Type Parameters:

T - the type of the array

Parameters:

arrayClass - the Class representing the array type

Returns:

the default array extractor for arrays of T