public class EmptyNary extends NarySupport<Object> implements Unary<Object>
Stream.Builder<T>| Constructor and Description |
|---|
EmptyNary() |
| Modifier and Type | Method and Description |
|---|---|
boolean |
allMatch(Predicate<? super Object> predicate) |
boolean |
anyMatch(Predicate<? super Object> predicate) |
Optional<Object> |
asOptional()
Returns a native Optional instance to be used with Nary unaware code
|
protected Stream<Object> |
asStream()
Gets a stream with the elements of this instance.
|
void |
close() |
<R,A> R |
collect(Collector<? super Object,A,R> collector) |
<R> R |
collect(Supplier<R> supplier,
BiConsumer<R,? super Object> accumulator,
BiConsumer<R,R> combiner) |
List<Object> |
collectToList()
Returns the content of this nary in a list.
This method is a shorthand of calling collect(Collectors.toList()). This nary, as stream, will be consumed in the operation. |
Set<Object> |
collectToSet()
Returns the content of this nary in a set.
This method is a shorthand of calling collect(Collectors.toSet()) This nary, as stream, will be consumed in the operation. |
Nary<Object> |
concat(Optional<?> other)
Creates a concatenated Nary with the elements of this instance and the one (if any) on the given
Optional |
Nary<Object> |
concat(Stream<?> other)
Creates another nary that will contain the elements of this instance and the given stream
|
long |
count() |
Unary<Object> |
distinct() |
boolean |
equals(Object obj)
This method is redefined so two instances of
Nary are equal only if they contain
equal elements, comparing them in iteration order |
Unary<Object> |
filter(Predicate<? super Object> predicate) |
Optional<Object> |
findAny() |
Unary<Object> |
findAnyNary()
|
Optional<Object> |
findFirst() |
Unary<Object> |
findFirstNary()
|
Unary<Object> |
findLast()
Returns the last element in this nary, if present.
Depending on the amount of elements on this Nary, the result may be empty or contain the last element |
<R> Nary<R> |
flatMap(Function<? super Object,? extends Stream<? extends R>> mapper) |
<U> Nary<U> |
flatMapOptional(Function<? super Object,Optional<U>> mapper)
Makes a normal
Stream.flatMap(Function) transformation but accepts Optional
as result for the mapper instead of Stream.This method is the semantic equivalent of Optional.flatMap(Function) but it can be applied to more
than one element. |
DoubleStream |
flatMapToDouble(Function<? super Object,? extends DoubleStream> mapper) |
IntStream |
flatMapToInt(Function<? super Object,? extends IntStream> mapper) |
LongStream |
flatMapToLong(Function<? super Object,? extends LongStream> mapper) |
void |
forEach(Consumer<? super Object> action)
Solves conflict between
Iterable and Stream because Iterable defines a default
implementation.We use Iterable.forEach(Consumer) definition |
void |
forEachOrdered(Consumer<? super Object> action) |
Object |
get()
If only one value is present in this
Nary, returns the value,
otherwise throws NoSuchElementException, or MoreThanOneElementException. |
int |
hashCode()
This method is redefined so the hashcode of a
Nary is based on its contained elements. |
Unary<Object> |
ifAbsent(Runnable runnable)
If the only value is absent invoke the given lambda, or else do nothing
This Nary as Stream is consumed.
|
Unary<Object> |
ifPresent(Consumer<? super Object> consumer)
If the only value is present, invoke the specified consumer with the value,
otherwise do nothing.
|
static <T> Unary<T> |
instance()
Accessor method for the only needed instance
Generics help to make it appear multi-type |
boolean |
isAbsent()
Negation of isPresent().
|
boolean |
isParallel() |
boolean |
isPresent()
Return
true if there is only a value present, otherwise false. |
Iterator<Object> |
iterator() |
Unary<Object> |
limit(long maxSize) |
<R> Unary<R> |
map(Function<? super Object,? extends R> mapper) |
<U> Unary<U> |
mapFilteringNullResult(Function<? super Object,? extends U> mapper)
Map each element on this instance and filter null results out.
If the result of mapping an element produces null, then it's skipped, reducing the
amount of elements contained in the returned Nary.This is semantically equivalent to Optional.map(Function) and
different from Stream.map(Function) that takes null
as valid results |
DoubleStream |
mapToDouble(ToDoubleFunction<? super Object> mapper) |
IntStream |
mapToInt(ToIntFunction<? super Object> mapper) |
LongStream |
mapToLong(ToLongFunction<? super Object> mapper) |
Optional<Object> |
max(Comparator<? super Object> comparator) |
Unary<Object> |
maxNary(Comparator<? super Object> comparator)
|
Optional<Object> |
min(Comparator<? super Object> comparator) |
Unary<Object> |
minNary(Comparator<? super Object> comparator)
|
boolean |
noneMatch(Predicate<? super Object> predicate) |
Stream<Object> |
onClose(Runnable closeHandler) |
Object |
orElse(Object other)
Return the only value if present, otherwise return
other. |
Object |
orElseGet(Supplier<?> other)
Return the only value if present, otherwise invoke
other and return
the result of that invocation. |
<X extends Throwable> |
orElseThrow(Supplier<? extends X> exceptionSupplier)
Return the only contained value, if present, otherwise throw an exception created by the provided supplier.
|
Unary<Object> |
orElseUse(Supplier<?> replacer)
Returns a Nary element that is populated with the given supplier only if this Nary is empty.
This method allows defining a mapping function for nary that can be empty and keep chaining other mapping definitions after that. This stream is consumed and it's assumed to have at most 1 element. |
Stream<Object> |
parallel() |
Unary<Object> |
peek(Consumer<? super Object> action) |
Optional<Object> |
reduce(BinaryOperator<Object> accumulator) |
Object |
reduce(Object identity,
BinaryOperator<Object> accumulator) |
<U> U |
reduce(U identity,
BiFunction<U,? super Object,U> accumulator,
BinaryOperator<U> combiner) |
Unary<Object> |
reduceNary(BinaryOperator<Object> accumulator)
|
Stream<Object> |
sequential() |
Unary<Object> |
skip(long n) |
Unary<Object> |
sorted() |
Unary<Object> |
sorted(Comparator<? super Object> comparator) |
Spliterator<Object> |
spliterator()
Solves conflict between
Iterable and Stream because Iterable defines a default
implementation.We use Iterable.spliterator() definition |
Object[] |
toArray() |
<A> A[] |
toArray(IntFunction<A[]> generator) |
String |
toString()
This method is redefined so whenever possible, the contained elements are printed
|
Unary<Object> |
unique()
Treats this instance as having a single element.
|
Stream<Object> |
unordered() |
add, collect, returningNaryDo, returningNaryDoclone, finalize, getClass, notify, notifyAll, wait, wait, waitempty, from, from, from, from, from, from, from, from, from, from, of, ofNonNullable, ofNonNullableadd, collectpublic Optional<Object> asOptional() throws MoreThanOneElementException
MonoElementasOptional in interface MonoElement<Object>MoreThanOneElementException - if there are more than one elements in this instancepublic Unary<Object> unique() throws NaryException
MultiElementUnary
because expectations between runtime and compile time won't matchunique in interface MultiElement<Object>MoreThanOneElementException - If this instance has more than one elementNaryExceptionprotected Stream<Object> asStream()
NarySupportasStream in class NarySupport<Object>public void close()
close in interface AutoCloseableclose in interface BaseStream<Object,Stream<Object>>close in class NarySupport<Object>public <R> R collect(Supplier<R> supplier, BiConsumer<R,? super Object> accumulator, BiConsumer<R,R> combiner)
public List<Object> collectToList()
MultiElementcollectToList in interface MultiElement<Object>public Set<Object> collectToSet()
MultiElementcollectToSet in interface MultiElement<Object>public Nary<Object> concat(Optional<?> other)
MultiElementOptionalconcat in interface MultiElement<Object>concat in class NarySupport<Object>other - The optional to join elements withpublic Nary<Object> concat(Stream<?> other)
MultiElementconcat in interface MultiElement<Object>concat in class NarySupport<Object>other - The stream to combine after thispublic long count()
public boolean equals(Object obj)
NaryNary are equal only if they contain
equal elements, comparing them in iteration orderequals in interface Nary<Object>equals in class NarySupport<Object>Object.equals(Object)public Unary<Object> findAnyNary()
MultiElementfindAnyNary in interface MultiElement<Object>findAnyNary in class NarySupport<Object>Nary describing some element of this stream, or an
empty Nary if the stream is emptyStream.findFirst()public Unary<Object> findFirstNary()
MultiElementfindFirstNary in interface MultiElement<Object>findFirstNary in class NarySupport<Object>Nary describing the first element of this stream,
or an empty Nary if the stream is emptypublic Unary<Object> findLast()
MultiElementfindLast in interface MultiElement<Object>findLast in class NarySupport<Object>public <R> Nary<R> flatMap(Function<? super Object,? extends Stream<? extends R>> mapper)
flatMap in interface NaryStream<Object>flatMap in interface Stream<Object>flatMap in class NarySupport<Object>public <U> Nary<U> flatMapOptional(Function<? super Object,Optional<U>> mapper) throws MoreThanOneElementException
MultiElementStream.flatMap(Function) transformation but accepts Optional
as result for the mapper instead of Stream.Optional.flatMap(Function) but it can be applied to more
than one element.flatMapOptional in interface MultiElement<Object>flatMapOptional in class NarySupport<Object>U - The type parameter to the Optional returned bymapper - a mapping function to apply to the value, if present
the mapping functionOptional-bearing mapping
function to the elements of this instance which may be 0, 1, or more elementsMoreThanOneElementExceptionpublic DoubleStream flatMapToDouble(Function<? super Object,? extends DoubleStream> mapper)
flatMapToDouble in interface Stream<Object>flatMapToDouble in class NarySupport<Object>public IntStream flatMapToInt(Function<? super Object,? extends IntStream> mapper)
flatMapToInt in interface Stream<Object>flatMapToInt in class NarySupport<Object>public LongStream flatMapToLong(Function<? super Object,? extends LongStream> mapper)
flatMapToLong in interface Stream<Object>flatMapToLong in class NarySupport<Object>public void forEach(Consumer<? super Object> action)
MultiElementIterable and Stream because Iterable defines a default
implementation.Iterable.forEach(Consumer) definitionpublic void forEachOrdered(Consumer<? super Object> action)
forEachOrdered in interface Stream<Object>forEachOrdered in class NarySupport<Object>public Object get() throws NoSuchElementException
MonoElementNary, returns the value,
otherwise throws NoSuchElementException, or MoreThanOneElementException.
This Nary as Stream is consumed to return the value so any attempt to use it as stream will fail after this method
callget in interface MonoElement<Object>get in interface Supplier<Object>NaryNoSuchElementException - if there is no value presentOptional.get()public int hashCode()
NaryNary is based on its contained elements.hashCode in interface Nary<Object>hashCode in class NarySupport<Object>Object.hashCode()public Unary<Object> ifAbsent(Runnable runnable)
MonoElementifAbsent in interface MonoElement<Object>runnable - The code to execute if this optional is emptypublic Unary<Object> ifPresent(Consumer<? super Object> consumer) throws MoreThanOneElementException
MonoElementifPresent in interface MonoElement<Object>consumer - block to be executed if a value is presentMoreThanOneElementException - if there are more than oneOptional.ifPresent(Consumer)public boolean isParallel()
isParallel in interface BaseStream<Object,Stream<Object>>isParallel in class NarySupport<Object>public boolean isPresent()
MonoElementtrue if there is only a value present, otherwise false.
This Nary as Stream is consumed.isPresent in interface MonoElement<Object>true if there is a value present, otherwise falseOptional.isPresent()public boolean isAbsent()
throws MoreThanOneElementException
MonoElementisAbsent in interface MonoElement<Object>MoreThanOneElementException - If there's more than one value to get as Optionalpublic <U> Unary<U> mapFilteringNullResult(Function<? super Object,? extends U> mapper)
MultiElementnull, then it's skipped, reducing the
amount of elements contained in the returned Nary.Optional.map(Function) and
different from Stream.map(Function) that takes null
as valid resultsmapFilteringNullResult in interface MultiElement<Object>mapFilteringNullResult in interface Unary<Object>mapFilteringNullResult in class NarySupport<Object>U - The type of the result of the mapping functionmapper - a mapping function to apply to the value, if presentpublic DoubleStream mapToDouble(ToDoubleFunction<? super Object> mapper)
mapToDouble in interface Stream<Object>mapToDouble in class NarySupport<Object>public IntStream mapToInt(ToIntFunction<? super Object> mapper)
public LongStream mapToLong(ToLongFunction<? super Object> mapper)
public Optional<Object> max(Comparator<? super Object> comparator)
public Unary<Object> maxNary(Comparator<? super Object> comparator)
MultiElementmaxNary in interface MultiElement<Object>maxNary in class NarySupport<Object>comparator - a non-interfering,
stateless
Comparator to compare elements of this streamNary describing the maximum element of this stream,
or an empty if there are no elementspublic Optional<Object> min(Comparator<? super Object> comparator)
public Unary<Object> minNary(Comparator<? super Object> comparator)
MultiElementminNary in interface MultiElement<Object>minNary in class NarySupport<Object>comparator - a non-interfering,
stateless
Comparator to compare elements of this streamNary describing the minimum element of this stream,
or an empty if there are no elementspublic Stream<Object> onClose(Runnable closeHandler)
onClose in interface BaseStream<Object,Stream<Object>>onClose in class NarySupport<Object>public Object orElse(Object other) throws MoreThanOneElementException
MonoElementother.
This Nary as Stream is consumed.orElse in interface MonoElement<Object>other - the value to be returned if there is no value present, may
be nullotherMoreThanOneElementException - if there are more than onepublic Object orElseGet(Supplier<?> other) throws MoreThanOneElementException
MonoElementother and return
the result of that invocation.
This Nary as Stream is consumed.orElseGet in interface MonoElement<Object>other - a Supplier whose result is returned if no value
is presentother.asUni().get()MoreThanOneElementException - if there are more than onepublic <X extends Throwable> Object orElseThrow(Supplier<? extends X> exceptionSupplier) throws X extends Throwable
MonoElementorElseThrow in interface MonoElement<Object>X - Type of the exception to be thrownexceptionSupplier - The supplier which will return the exception to
be thrownX - if there is no value presentX extends Throwablepublic Unary<Object> orElseUse(Supplier<?> replacer) throws MoreThanOneElementException
MonoElementorElseUse in interface MonoElement<Object>replacer - The function that supplies a value if missingMoreThanOneElementException - If this instance has more than 1 elementpublic Stream<Object> parallel()
parallel in interface BaseStream<Object,Stream<Object>>parallel in class NarySupport<Object>public Object reduce(Object identity, BinaryOperator<Object> accumulator)
public Optional<Object> reduce(BinaryOperator<Object> accumulator)
public <U> U reduce(U identity,
BiFunction<U,? super Object,U> accumulator,
BinaryOperator<U> combiner)
public Unary<Object> reduceNary(BinaryOperator<Object> accumulator)
MultiElementreduceNary in interface MultiElement<Object>reduceNary in class NarySupport<Object>accumulator - The associative function to reduce the elements of this nary to a result of the same typefor a complete referencepublic Stream<Object> sequential()
sequential in interface BaseStream<Object,Stream<Object>>sequential in class NarySupport<Object>public Unary<Object> sorted(Comparator<? super Object> comparator)
public Spliterator<Object> spliterator()
MultiElementIterable and Stream because Iterable defines a default
implementation.Iterable.spliterator() definitionspliterator in interface MultiElement<Object>spliterator in interface Iterable<Object>spliterator in interface BaseStream<Object,Stream<Object>>spliterator in class NarySupport<Object>public Object[] toArray()
public <A> A[] toArray(IntFunction<A[]> generator)
public String toString()
Narypublic Stream<Object> unordered()
unordered in interface BaseStream<Object,Stream<Object>>unordered in class NarySupport<Object>public static <T> Unary<T> instance()
T - The expected element typeCopyright © 2020. All rights reserved.