Package org.hildan.hashcode.utils.parser.readers.line

Class LineReader<T,P>

java.lang.Object

org.hildan.hashcode.utils.parser.readers.line.LineReader<T,P>

Type Parameters:

T - the type of objects created by this LineReader

P - the type of parent that the read objects are part of

All Implemented Interfaces:

ChildReader<T,P>

public class LineReader<T,P>
extends java.lang.Object
implements ChildReader<T,P>

An ObjectReader that reads a full line of input to create an object.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	LineReader(java.util.function.BiFunction<? super java.lang.String[],P,T> lineConverter)	Creates a new LineReader.

Method Summary

Modifier and Type	Method	Description
static <E> ObjectReader<E[]>	ofArray(java.util.function.IntFunction<E[]> arrayCreator, java.util.function.Function<? super java.lang.String,? extends E> itemConverter)	Creates a new ObjectReader that reads a full line as an array of objects.
static <T,P> ChildReader<T,P>	ofChild(java.util.function.BiFunction<? super java.lang.String[],P,T> converter)	Creates a new ChildReader that reads a full line and converts the result using the given converter.
static <E,R> ObjectReader<R>	ofCollection(java.util.function.Function<? super java.lang.String,? extends E> itemConverter, java.util.stream.Collector<E,?,R> collector)	Creates a new ObjectReader that reads a full line of tokens and reduces these tokens using the provided collector.
static ObjectReader<double[]>	ofDoubleArray()	Creates a new ObjectReader that reads a full line as an array of doubles.
static ObjectReader<int[]>	ofIntArray()	Creates a new ObjectReader that reads a full line as an array of integers.
static <E> ObjectReader<java.util.List<E>>	ofList(java.util.function.Function<? super java.lang.String,? extends E> itemConverter)	Creates a new ObjectReader that reads a full line as a list of objects.
static ObjectReader<long[]>	ofLongArray()	Creates a new ObjectReader that reads a full line as an array of long.
static <T> ObjectReader<T>	ofObject(java.util.function.Function<? super java.lang.String[],T> converter)	Creates a new ObjectReader that reads a full line and converts the result using the given converter.
static ObjectReader<java.lang.String[]>	ofStringArray()	Creates a new ObjectReader that reads a full line as an array of strings.
T	read(@NotNull Context context, P parent)	Reads an object from the given Context, consuming as much input as necessary.

Methods inherited from class java.lang.Object

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

Constructor Detail

LineReader

protected LineReader(java.util.function.BiFunction<? super java.lang.String[],P,T> lineConverter)

Creates a new LineReader.

Parameters:

lineConverter - the function to convert the input line's tokens into an object

Method Detail

read

@NotNull
public T read(@NotNull
              @NotNull Context context,
              @Nullable
              P parent)
       throws InputParsingException

Description copied from interface: ChildReader

Reads an object from the given Context, consuming as much input as necessary.

Specified by:

read in interface ChildReader<T,P>

Parameters:

context - the context to read lines from

parent - the parent object within which the object is being created

Returns:

the created object, may be null

Throws:

InputParsingException - if something went wrong when reading the input

ofStringArray

public static ObjectReader<java.lang.String[]> ofStringArray()

Creates a new ObjectReader that reads a full line as an array of strings.

Returns:

the created ObjectReader

ofIntArray

public static ObjectReader<int[]> ofIntArray()

Creates a new ObjectReader that reads a full line as an array of integers.

Returns:

the created ObjectReader

ofLongArray

public static ObjectReader<long[]> ofLongArray()

Creates a new ObjectReader that reads a full line as an array of long.

Returns:

the created ObjectReader

ofDoubleArray

public static ObjectReader<double[]> ofDoubleArray()

Creates a new ObjectReader that reads a full line as an array of doubles.

Returns:

the created ObjectReader

ofArray

public static <E> ObjectReader<E[]> ofArray(java.util.function.IntFunction<E[]> arrayCreator,
                                            java.util.function.Function<? super java.lang.String,? extends E> itemConverter)

Creates a new ObjectReader that reads a full line as an array of objects.

Type Parameters:

E - the type of elements in the array

Parameters:

arrayCreator - a function to create a new array, given its size

itemConverter - a function to convert a string token into an item of the array

Returns:

the created ObjectReader

ofList

public static <E> ObjectReader<java.util.List<E>> ofList(java.util.function.Function<? super java.lang.String,? extends E> itemConverter)

Creates a new ObjectReader that reads a full line as a list of objects.

Type Parameters:

E - the type of elements in the list

Parameters:

itemConverter - a function to convert a string token into an item of the list

Returns:

the created ObjectReader

ofCollection

public static <E,R> ObjectReader<R> ofCollection(java.util.function.Function<? super java.lang.String,? extends E> itemConverter,
                                                 java.util.stream.Collector<E,?,R> collector)

Creates a new ObjectReader that reads a full line of tokens and reduces these tokens using the provided collector.

Type Parameters:

E - the type of elements in the list

R - the type of the result of the reduction, for instance a collection type

Parameters:

itemConverter - a function to convert a string token into an item of the list

collector - a collector describing the reduction to perform

Returns:

the created ObjectReader

ofObject

public static <T> ObjectReader<T> ofObject(java.util.function.Function<? super java.lang.String[],T> converter)

Creates a new ObjectReader that reads a full line and converts the result using the given converter.

Type Parameters:

T - the type of objects created by the returned ObjectReader

Parameters:

converter - the function to convert the input line's tokens into an object

Returns:

the created ObjectReader

ofChild

public static <T,P> ChildReader<T,P> ofChild(java.util.function.BiFunction<? super java.lang.String[],P,T> converter)

Creates a new ChildReader that reads a full line and converts the result using the given converter. As opposed to ofObject(Function), the converter is also passed a parent object within which the reader will be called. This is why this method returns a ChildReader and not an ObjectReader.

Type Parameters:

T - the type of objects created by the returned ObjectReader

P - the type of parent that the read objects are part of

Parameters:

converter - the function to convert the input line's tokens into an object. The converter is also given the parent object within which the reader will be called.

Returns:

the created ChildReader