Class ConvertingIteration<S,T,X extends Exception>

java.lang.Object
org.eclipse.rdf4j.common.iteration.AbstractCloseableIteration<T,X>
org.eclipse.rdf4j.common.iteration.ConvertingIteration<S,T,X>
All Implemented Interfaces:
AutoCloseable, CloseableIteration<T,X>, Iteration<T,X>
Direct Known Subclasses:
BoundJoinConversionIteration, BoundJoinVALUESConversionIteration, ExtensionIterator, GroupedCheckConversionIteration, InsertBindingsIteration, ProjectionIterator, ServiceJoinConversionIteration

public abstract class ConvertingIteration<S,T,X extends Exception> extends AbstractCloseableIteration<T,X>
A CloseableIteration that converts an iteration over objects of type S (the source type) to an iteration over objects of type T (the target type).
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    ConvertingIteration(Iteration<? extends S,? extends X> iter)
    Creates a new ConvertingIteration that operates on the supplied source type iteration.
  • Method Summary

    Modifier and Type
    Method
    Description
    protected abstract T
    convert(S sourceObject)
    Converts a source type object to a target type object.
    protected void
    Closes this iteration as well as the wrapped iteration if it is a CloseableIteration.
    boolean
    Checks whether the source type iteration contains more elements.
    Returns the next element from the source type iteration.
    void
    Calls remove() on the underlying Iteration.

    Methods inherited from class org.eclipse.rdf4j.common.iteration.AbstractCloseableIteration

    close, isClosed

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface org.eclipse.rdf4j.common.iteration.Iteration

    stream
  • Constructor Details

    • ConvertingIteration

      protected ConvertingIteration(Iteration<? extends S,? extends X> iter)
      Creates a new ConvertingIteration that operates on the supplied source type iteration.
      Parameters:
      iter - The source type iteration for this ConvertingIteration, must not be null.
  • Method Details

    • convert

      protected abstract T convert(S sourceObject) throws X
      Converts a source type object to a target type object.
      Throws:
      X extends Exception
    • hasNext

      public boolean hasNext() throws X
      Checks whether the source type iteration contains more elements.
      Returns:
      true if the source type iteration contains more elements, false otherwise.
      Throws:
      X
    • next

      public T next() throws X
      Returns the next element from the source type iteration.
      Returns:
      the next element in the iteration.
      Throws:
      X
      NoSuchElementException - If all elements have been returned.
      IllegalStateException - If the iteration has been closed.
    • remove

      public void remove() throws X
      Calls remove() on the underlying Iteration.
      Throws:
      UnsupportedOperationException - If the wrapped Iteration does not support the remove operation.
      IllegalStateException - If the Iteration has been closed, or if next() has not yet been called, or remove() has already been called after the last call to next().
      X extends Exception
    • handleClose

      protected void handleClose() throws X
      Closes this iteration as well as the wrapped iteration if it is a CloseableIteration.
      Overrides:
      handleClose in class AbstractCloseableIteration<T,X extends Exception>
      Throws:
      X