@Beta
public abstract class PagedIterable<E>
extends com.google.common.collect.FluentIterable<IterableWithMarker<E>>

Extends FluentIterable allowing you to lazily advance through sequence of pages in a result set. Typically used in APIs that return only a certain number of records at a time.

Simplest usage is to employ the concat() convenience function, and iterate.

 FluentIterable images = imageApi.listInDetail().concat();

 for (Image image: images) {
    System.out.println(image);
 }
 

Another usage is to employ the concat() convenience function, and one of the methods from FluentIterable.

    Optional image = imageApi.listInDetail().concat().firstMatch(isInterestingImage());
    System.out.println(image.orNull());
 ...
 private static Predicate isInterestingImage() {
    return new Predicate() {
       @Override
       public boolean apply(Image image) {
          return image.getName().startsWith("Arch");
       }
    };
 }