com.olights.jqueryable

Interface IQueryable<Type>

Type Parameters:

Type - the type of the contained items

All Superinterfaces:

IContainer<Type>, Iterable<Type>

All Known Subinterfaces:

IQueryableList<Type>

All Known Implementing Classes:

QueryableList

public interface IQueryable<Type>
extends IContainer<Type>

IQueryable combines the functionality of a @Stream and an @IContainer.

Method Summary

Modifier and Type	Method and Description
boolean	any() Check if this IQueryable contains any elements.
boolean	anyMatch(java.util.function.Predicate<? super Type> predicate) Returns whether any elements of this IQueryable match the provided predicate.
int	count() Return the number of elements in this IQueryable
int	count(java.util.function.Predicate<Type> predicate) Return number of elements in this queryable that passes the given predicate.
IQueryable<Type>	distinct() Returns an queryable consisting of the distinct elements (according to Object.equals(Object)) of this queryable.
IQueryable<Type>	filter(java.util.function.Predicate<Type> predicate) Returns an IQueryable consisting of the elements of this IQueryable that match the given predicate.
Optional<Type>	findFirst() Returns the first item in this IQueryable if exists
Optional<Type>	findFirst(java.util.function.Predicate<Type> predicate) Returns the first item in this IQueryable if exists
Type	first() Returns the first item in this IQueryable
Type	first(java.util.function.Predicate<Type> predicate) Returns the first item in this IQueryable
Type	last() Returns the last item in this IQueryable
<Out> IQueryable<Out>	map(java.util.function.Function<Type,Out> mapper) Returns a IQueryable consisting of the results of applying the given function to the elements of this IQueryable This is an intermediate operation.
<Out> IQueryable<Out>	mapMany(java.util.function.Function<Type,Iterable<Out>> mapper) Returns a IQueryable consisting of the results of applying the given function to the elements of this IQueryable This is an intermediate operation.
IQueryable<Type>	sorted() Returns a queryalbe consisting of the elements of this queryalbe, sorted according to natural order.
IQueryable<Type>	sorted(Comparator<? super Type> comparator) Returns a queryalbe consisting of the elements of this queryalbe, sorted according to the provided Comparator.
Type[]	toArray(java.util.function.IntFunction<Type[]> generator) Returns an array containing the elements of this IQueryable.

Methods inherited from interface com.olights.jqueryable.IContainer

contains

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

filter

IQueryable<Type> filter(java.util.function.Predicate<Type> predicate)

Returns an IQueryable consisting of the elements of this IQueryable that match the given predicate.

Parameters:

predicate - a non-interfering, stateless predicate to apply to each element to determine if it should be included

Returns:

the new IQueryable

map

<Out> IQueryable<Out> map(java.util.function.Function<Type,Out> mapper)

Returns a IQueryable consisting of the results of applying the given function to the elements of this IQueryable This is an intermediate operation.

Type Parameters:

Out - the result of mapping the original type

Parameters:

mapper - a non-interfering, stateless function to apply to each element

Returns:

the new IQueryable

mapMany

<Out> IQueryable<Out> mapMany(java.util.function.Function<Type,Iterable<Out>> mapper)

Returns a IQueryable consisting of the results of applying the given function to the elements of this IQueryable This is an intermediate operation.

Type Parameters:

Out - the result of mapping the original type

Parameters:

mapper - a non-interfering, stateless function to apply to each element

Returns:

the new IQueryable

any

boolean any()

Check if this IQueryable contains any elements.

Returns:

true if the IQueryable contains at least one element, otherwise false

anyMatch

boolean anyMatch(java.util.function.Predicate<? super Type> predicate)

Returns whether any elements of this IQueryable match the provided predicate. May not evaluate the predicate on all elements if not necessary for determining the result. If the IQueryable is empty then false is returned and the predicate is not evaluated. This is a short-circuiting terminal operation.

Parameters:

predicate - a non-interfering, stateless predicate to apply to elements of this queryable.

Returns:

true if any elements of the stream match the provided predicate, otherwise false

count

int count()

Return the number of elements in this IQueryable

Returns:

number of elements

count

int count(java.util.function.Predicate<Type> predicate)

Return number of elements in this queryable that passes the given predicate.

Parameters:

predicate - a non-interfering, stateless predicate to apply to elements of this queryable.

Returns:

the number of elements that passed the predicate

first

Type first()

Returns the first item in this IQueryable

Returns:

the first item if exists

first

Type first(java.util.function.Predicate<Type> predicate)

Returns the first item in this IQueryable

Parameters:

predicate - a non-interfering, stateless predicate to apply to elements of this stream

Returns:

the first item if exists

findFirst

Optional<Type> findFirst()

Returns the first item in this IQueryable if exists

Returns:

the first item

findFirst

Optional<Type> findFirst(java.util.function.Predicate<Type> predicate)

Returns the first item in this IQueryable if exists

Parameters:

predicate - a non-interfering, stateless predicate to apply to elements of this stream

Returns:

the first item

last

Type last()

Returns the last item in this IQueryable

Returns:

the last item if exists

toArray

Type[] toArray(java.util.function.IntFunction<Type[]> generator)

Returns an array containing the elements of this IQueryable. This is a terminal operation.

Parameters:

generator - function that generates a new array of the given type and size

Returns:

an array containing the elements of this IQueryable

sorted

IQueryable<Type> sorted()

Returns a queryalbe consisting of the elements of this queryalbe, sorted according to natural order. If the elements of this queryalbe are not Comparable, a java.lang.ClassCastException may be thrown when the terminal operation is executed. For ordered queryalbes, the sort is stable. For unordered queryalbes, no stability guarantees are made. This is a stateful intermediate operation.

Returns:

the new queryable

sorted

IQueryable<Type> sorted(Comparator<? super Type> comparator)

Returns a queryalbe consisting of the elements of this queryalbe, sorted according to the provided Comparator. For ordered queryalbes, the sort is stable. For unordered queryalbes, no stability guarantees are made. This is a stateful intermediate operation.

Parameters:

comparator - comparator - a non-interfering, stateless Comparator to be used to compare queryalbe elements

Returns:

the new queryable

distinct

IQueryable<Type> distinct()

Returns an queryable consisting of the distinct elements (according to Object.equals(Object)) of this queryable.

Returns:

the queryable result