org.springframework.data.neo4j.util

Class IterableUtils

java.lang.Object

org.springframework.data.neo4j.util.IterableUtils

public final class IterableUtils
extends Object

Utility methods for dealing with Iterables.

Author:

Michal Bachman

Method Summary

Modifier and Type	Method and Description
static <T> boolean	contains(Iterable<T> iterable, T object) Check whether an iterable contains the given object.
static long	count(Iterable iterable) Count items in an iterable.
static <T> T	getFirst(Iterable<T> iterable, String notFoundMessage) Get the first element from iterable.
static <T> T	getFirst(Iterator<T> iterator, String notFoundMessage) Get the first element from iterator.
static <T> T	getFirstOrNull(Iterable<T> iterable) Get the first element from iterable.
static <T> T	getFirstOrNull(Iterator<T> iterator) Get the first element from iterator.
static <T> T	getSingle(Iterable<T> iterable) Get a single element from iterable.
static <T> T	getSingle(Iterable<T> iterable, String notFoundMessage) Get a single element from iterable.
static <T> T	getSingle(Iterator<T> iterator) Get a single element from iterator.
static <T> T	getSingle(Iterator<T> iterator, String notFoundMessage) Get a single element from iterator.
static <T> T	getSingleOrNull(Iterable<T> iterable) Get a single element from iterable.
static <T> T	getSingleOrNull(Iterator<T> iterator) Get a single element from iterator.
static <T> List<T>	toList(Iterable<T> iterable) Convert an iterable to a list.

Methods inherited from class java.lang.Object

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

Method Detail

count

public static long count(Iterable iterable)

Count items in an iterable.

Parameters:

iterable - to count items in.

Returns:

number of items in the iterable.

contains

public static <T> boolean contains(Iterable<T> iterable,
                                   T object)

Check whether an iterable contains the given object.

Type Parameters:

T - type of the objects stored in the iterable.

Parameters:

iterable - to check in.

object - to look for.

Returns:

true iff the object is contained in the iterable.

toList

public static <T> List<T> toList(Iterable<T> iterable)

Convert an iterable to a list.

Type Parameters:

T - type of the items held.

Parameters:

iterable - to convert.

Returns:

a list.

getSingle

public static <T> T getSingle(Iterator<T> iterator,
                              String notFoundMessage)

Get a single element from iterator.

Type Parameters:

T - type of the element.

Parameters:

iterator - to find a single element.

notFoundMessage - exception message if there are no elements.

Returns:

the element iff there is exactly one.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

IllegalStateException - in case the iterable contains more than 1 element.

getSingle

public static <T> T getSingle(Iterable<T> iterable,
                              String notFoundMessage)

Get a single element from iterable.

Type Parameters:

T - type of the element.

Parameters:

iterable - to find a single element.

notFoundMessage - exception message if there are no elements.

Returns:

the element iff there is exactly one.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

IllegalStateException - in case the iterable contains more than 1 element.

getSingle

public static <T> T getSingle(Iterator<T> iterator)

Get a single element from iterator.

Type Parameters:

T - type of the element.

Parameters:

iterator - to find a single element.

Returns:

the element iff there is exactly one.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

IllegalStateException - in case the iterable contains more than 1 element.

getSingle

public static <T> T getSingle(Iterable<T> iterable)

Get a single element from iterable.

Type Parameters:

T - type of the element.

Parameters:

iterable - to find a single element.

Returns:

the element iff there is exactly one.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

IllegalStateException - in case the iterable contains more than 1 element.

getSingleOrNull

public static <T> T getSingleOrNull(Iterator<T> iterator)

Get a single element from iterator.

Type Parameters:

T - type of the element.

Parameters:

iterator - to find a single element.

Returns:

the element iff there is exactly one, null iff there is 0.

Throws:

IllegalStateException - in case the iterable contains more than 1 element.

getSingleOrNull

public static <T> T getSingleOrNull(Iterable<T> iterable)

Get a single element from iterable.

Type Parameters:

T - type of the element.

Parameters:

iterable - to find a single element.

Returns:

the element iff there is exactly one, null iff there is 0.

Throws:

IllegalStateException - in case the iterable contains more than 1 element.

getFirst

public static <T> T getFirst(Iterator<T> iterator,
                             String notFoundMessage)

Get the first element from iterator.

Type Parameters:

T - type of the element.

Parameters:

iterator - to find the first element.

notFoundMessage - exception message if there are no elements.

Returns:

the element iff there is one or more.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

getFirst

public static <T> T getFirst(Iterable<T> iterable,
                             String notFoundMessage)

Get the first element from iterable.

Type Parameters:

T - type of the element.

Parameters:

iterable - to find the first element.

notFoundMessage - exception message if there are no elements.

Returns:

the element iff there is one or more.

Throws:

org.neo4j.ogm.exception.core.NotFoundException - in case there are no elements.

getFirstOrNull

public static <T> T getFirstOrNull(Iterator<T> iterator)

Get the first element from iterator.

Type Parameters:

T - type of the element.

Parameters:

iterator - to find the first element.

Returns:

the element iff there is one or more, null if there is none.

getFirstOrNull

public static <T> T getFirstOrNull(Iterable<T> iterable)

Get the first element from iterable.

Type Parameters:

T - type of the element.

Parameters:

iterable - to find the first element.

Returns:

the element iff there is one or more, null if there is none.