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

Interface SectionReader<T>

Type Parameters:

T - the type of object that this SectionReader can update

All Known Implementing Classes:

FieldAndVarReader, FieldsAndVarsReader

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 SectionReader<T>

A reader that consumes as much input as necessary (a possibly multi-line "section") to update a previously created object.

For instance, this may be used to read an object from the input and set it as a field/property of a parent object.

Method Summary

Modifier and Type	Method	Description
void	readAndSet(@NotNull Context context, T object)	Reads as much input as necessary to update the given object.
static <E,P> SectionReader<P>	settingArray(java.util.function.BiConsumer<? super P,? super E[]> setter, java.util.function.IntFunction<E[]> arrayCreator, java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize, ChildReader<? extends E,? super P> itemReader)
static <V,T> SectionReader<T>	settingChild(java.util.function.BiConsumer<? super T,? super V> setter, ChildReader<? extends V,? super T> valueReader)	Returns a SectionReader that reads a child object and sets it on the target object, consuming as much input as necessary.
static <E,C extends java.util.Collection<E>,P> SectionReader<P>	settingCollection(java.util.function.BiConsumer<? super P,? super C> setter, java.util.function.IntFunction<C> constructor, java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize, ChildReader<? extends E,? super P> itemReader)
static <T> SectionReader<T>	settingDouble(java.util.function.ObjDoubleConsumer<T> setter)	Returns a SectionReader that reads a double and sets it on the target object, consuming as much input as necessary.
static <T> SectionReader<T>	settingInt(java.util.function.ObjIntConsumer<T> setter)	Returns a SectionReader that reads an int and sets it on the target object, consuming as much input as necessary.
static <E,P> SectionReader<P>	settingList(java.util.function.BiConsumer<? super P,? super java.util.List<E>> setter, java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize, ChildReader<? extends E,? super P> itemReader)
static <V,T> SectionReader<T>	settingObject(java.util.function.BiConsumer<T,? super V> setter, java.util.function.Function<? super java.lang.String,V> valueConverter)	Returns a SectionReader that reads a value and sets it on the target object, consuming as much input as necessary.
static <T> SectionReader<T>	settingString(java.util.function.BiConsumer<T,? super java.lang.String> setter)	Returns a SectionReader that reads a string and sets it on the target object, consuming as much input as necessary.

Method Detail

readAndSet

void readAndSet(@NotNull
                @NotNull Context context,
                @Nullable
                T object)
         throws InputParsingException

Reads as much input as necessary to update the given object.

Parameters:

context - the context to read from

object - the object to update

Throws:

InputParsingException - if something went wrong while reading the input

settingString

static <T> SectionReader<T> settingString(java.util.function.BiConsumer<T,? super java.lang.String> setter)

Returns a SectionReader that reads a string and sets it on the target object, consuming as much input as necessary.

Type Parameters:

T - the type of object that the returned SectionReader updates

Parameters:

setter - the setter to use to set the value on the target object

Returns:

a SectionReader that reads a value and sets it on the target object

settingInt

static <T> SectionReader<T> settingInt(java.util.function.ObjIntConsumer<T> setter)

Returns a SectionReader that reads an int and sets it on the target object, consuming as much input as necessary.

Type Parameters:

T - the type of object that the returned SectionReader updates

Parameters:

setter - the setter to use to set the value on the target object

Returns:

a SectionReader that reads a value and sets it on the target object

settingDouble

static <T> SectionReader<T> settingDouble(java.util.function.ObjDoubleConsumer<T> setter)

Returns a SectionReader that reads a double and sets it on the target object, consuming as much input as necessary.

Type Parameters:

T - the type of object that the returned SectionReader updates

Parameters:

setter - the setter to use to set the value on the target object

Returns:

a SectionReader that reads a value and sets it on the target object

settingObject

static <V,T> SectionReader<T> settingObject(java.util.function.BiConsumer<T,? super V> setter,
                                            java.util.function.Function<? super java.lang.String,V> valueConverter)

Returns a SectionReader that reads a value and sets it on the target object, consuming as much input as necessary.

Type Parameters:

V - the type of value that the given converter yields

T - the type of object that the returned SectionReader updates

Parameters:

setter - the setter to use to set the value on the target object

valueConverter - a function to convert the string token read from the input into the value to set

Returns:

a SectionReader that reads a value and sets it on the target object

settingChild

static <V,T> SectionReader<T> settingChild(java.util.function.BiConsumer<? super T,? super V> setter,
                                           ChildReader<? extends V,? super T> valueReader)

Returns a SectionReader that reads a child object and sets it on the target object, consuming as much input as necessary.

Type Parameters:

V - the type of the child object to set, which the given ChildReader creates

T - the type of object that the returned SectionReader updates

Parameters:

setter - the setter to use to set the value on the target object

valueReader - the reader to use to read the child object to set

Returns:

a SectionReader that reads a value and sets it on the target object

settingArray

static <E,P> SectionReader<P> settingArray(java.util.function.BiConsumer<? super P,? super E[]> setter,
                                           java.util.function.IntFunction<E[]> arrayCreator,
                                           java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize,
                                           ChildReader<? extends E,? super P> itemReader)

settingList

static <E,P> SectionReader<P> settingList(java.util.function.BiConsumer<? super P,? super java.util.List<E>> setter,
                                          java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize,
                                          ChildReader<? extends E,? super P> itemReader)

settingCollection

static <E,C extends java.util.Collection<E>,P> SectionReader<P> settingCollection(java.util.function.BiConsumer<? super P,? super C> setter,
                                                                                  java.util.function.IntFunction<C> constructor,
                                                                                  java.util.function.BiFunction<? super P,Context,java.lang.Integer> getSize,
                                                                                  ChildReader<? extends E,? super P> itemReader)