com.olights.jqueryable

Class QueryableList<Type>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<Type>

com.olights.jqueryable.QueryableList<Type>

Type Parameters:

Type - the type of the contained elements

All Implemented Interfaces:

IContainer<Type>, IQueryable<Type>, IQueryableList<Type>, Serializable, Cloneable, Iterable<Type>, Collection<Type>, List<Type>, RandomAccess

public class QueryableList<Type>
extends ArrayList<Type>
implements IQueryableList<Type>

This class implements the @IQueryable interface.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
QueryableList() Create an empty QueryableList
QueryableList(Collection<Type> collection) Create a QueryableList which contains the elements from the given collection
QueryableList(Iterable<Type> iterable) Create a QueryableList which contains the elements from the given iterable
QueryableList(Type... items) Create a QueryableList which contains the elements which are passed as arguments.

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.
QueryableList<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> QueryableList<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> QueryableList<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 class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.olights.jqueryable.IContainer

contains

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

QueryableList

public QueryableList()

Create an empty QueryableList

QueryableList

public QueryableList(Collection<Type> collection)

Create a QueryableList which contains the elements from the given collection

Parameters:

collection - collection to provide the initial elements of this QueryableList

QueryableList

public QueryableList(Iterable<Type> iterable)

Create a QueryableList which contains the elements from the given iterable

Parameters:

iterable - collection to provide the initial elements of this QueryableList

QueryableList

@SafeVarargs
public QueryableList(Type... items)

Create a QueryableList which contains the elements which are passed as arguments.

Parameters:

items - the elements that will contained in the QueryableList

Method Detail

filter

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

Description copied from interface: IQueryable

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

Specified by:

filter in interface IQueryable<Type>

Parameters:

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

Returns:

the new IQueryable

map

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

Description copied from interface: IQueryable

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

Specified by:

map in interface IQueryable<Type>

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

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

Description copied from interface: IQueryable

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

Specified by:

mapMany in interface IQueryable<Type>

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

public boolean any()

Description copied from interface: IQueryable

Check if this IQueryable contains any elements.

Specified by:

any in interface IQueryable<Type>

Returns:

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

anyMatch

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

Description copied from interface: IQueryable

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.

Specified by:

anyMatch in interface IQueryable<Type>

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

public int count()

Description copied from interface: IQueryable

Return the number of elements in this IQueryable

Specified by:

count in interface IQueryable<Type>

Returns:

number of elements

count

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

Description copied from interface: IQueryable

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

Specified by:

count in interface IQueryable<Type>

Parameters:

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

Returns:

the number of elements that passed the predicate

first

public Type first()

Description copied from interface: IQueryable

Returns the first item in this IQueryable

Specified by:

first in interface IQueryable<Type>

Returns:

the first item if exists

first

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

Description copied from interface: IQueryable

Returns the first item in this IQueryable

Specified by:

first in interface IQueryable<Type>

Parameters:

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

Returns:

the first item if exists

findFirst

public Optional<Type> findFirst()

Description copied from interface: IQueryable

Returns the first item in this IQueryable if exists

Specified by:

findFirst in interface IQueryable<Type>

Returns:

the first item

findFirst

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

Description copied from interface: IQueryable

Returns the first item in this IQueryable if exists

Specified by:

findFirst in interface IQueryable<Type>

Parameters:

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

Returns:

the first item

last

public Type last()

Description copied from interface: IQueryable

Returns the last item in this IQueryable

Specified by:

last in interface IQueryable<Type>

Returns:

the last item if exists

toArray

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

Description copied from interface: IQueryable

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

Specified by:

toArray in interface IQueryable<Type>

Parameters:

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

Returns:

an array containing the elements of this IQueryable

sorted

public IQueryable<Type> sorted()

Description copied from interface: IQueryable

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.

Specified by:

sorted in interface IQueryable<Type>

Returns:

the new queryable

sorted

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

Description copied from interface: IQueryable

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.

Specified by:

sorted in interface IQueryable<Type>

Parameters:

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

Returns:

the new queryable

distinct

public IQueryable<Type> distinct()

Description copied from interface: IQueryable

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

Specified by:

distinct in interface IQueryable<Type>

Returns:

the queryable result