Package org.kohsuke.github

Class PagedIterable<T>

java.lang.Object

org.kohsuke.github.PagedIterable<T>

Type Parameters:

T - the type of items on each page

All Implemented Interfaces:

Iterable<T>

Direct Known Subclasses:

PagedSearchIterable

public abstract class PagedIterable<T>
extends Object
implements Iterable<T>

Iterable that returns PagedIterator. PagedIterable is thread-safe but PagedIterator is not. Any one instance of PagedIterator should only be called from a single thread.

Author:

Kohsuke Kawaguchi

Constructor Summary

Constructors

Constructor	Description
PagedIterable()

Method Summary

Modifier and Type	Method	Description
abstract PagedIterator<T>	_iterator(int pageSize)	Iterator over page items.
List<T>	asList()	Deprecated. Use toList() instead.
Set<T>	asSet()	Deprecated. Use toSet() instead.
final PagedIterator<T>	iterator()	Returns an iterator over elements of type T.
T[]	toArray()	Eagerly walk Iterable and return the result in an array.
protected T[]	toArray(PagedIterator<T> iterator)	Eagerly walk PagedIterator and return the result in an array.
List<T>	toList()	Eagerly walk Iterable and return the result in a list.
Set<T>	toSet()	Eagerly walk Iterable and return the result in a set.
PagedIterable<T>	withPageSize(int size)	Sets the pagination size.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

PagedIterable

public PagedIterable()

Method Details

withPageSize

public PagedIterable<T> withPageSize(int size)

Sets the pagination size.

When set to non-zero, each API call will retrieve this many entries.

Parameters:

size - the size

Returns:

the paged iterable

iterator

@Nonnull
public final PagedIterator<T> iterator()

Returns an iterator over elements of type T.

Specified by:

iterator in interface Iterable<T>

Returns:

an Iterator.

_iterator

@Nonnull
public abstract PagedIterator<T> _iterator(int pageSize)

Iterator over page items.

Parameters:

pageSize - the page size

Returns:

the paged iterator

toArray

protected T[] toArray(PagedIterator<T> iterator)
               throws IOException

Eagerly walk PagedIterator and return the result in an array.

Parameters:

iterator - the PagedIterator to read

Returns:

an array of all elements from the PagedIterator

Throws:

IOException - if an I/O exception occurs.

toArray

@Nonnull
public T[] toArray()
            throws IOException

Eagerly walk Iterable and return the result in an array.

Returns:

the list

Throws:

IOException - if an I/O exception occurs.

toList

@Nonnull
public List<T> toList()
               throws IOException

Eagerly walk Iterable and return the result in a list.

Returns:

the list

Throws:

IOException - if an I/O Exception occurs

toSet

@Nonnull
public Set<T> toSet()
             throws IOException

Eagerly walk Iterable and return the result in a set.

Returns:

the set

Throws:

IOException - if an I/O Exception occurs

asList

@Nonnull
@Deprecated
public List<T> asList()

Deprecated.

Use toList() instead.

Eagerly walk Iterable and return the result in a list.

Returns:

the list

asSet

@Nonnull
@Deprecated
public Set<T> asSet()

Deprecated.

Use toSet() instead.

Eagerly walk Iterable and return the result in a set.

Returns:

the set