DocumentIterator (MG4J (big) 5.4.4)

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

AbstractDocumentIterator, JdbcDocumentCollection.JdbcDocumentIterator
```
public interface DocumentIterator
extends Closeable
```
An iterator over documents.
This interface provide a nextDocument() method returning the next document, or null if no more documents are available. Usually you would need to Document.close() each document when you are finished with it, but in the present case it is guaranteed that each call to nextDocument() will close the previously returned document.
An additional close() method releases all resources used by the iterator. Implementations are invited to be safely closeable.

- Method Summary
  
  Modifier and Type Method Description
  
  void close()
  Closes this document iterator, releasing all resources.
  
  Document nextDocument()
  Returns the next document.

- Method Detail
  - nextDocument
```
Document nextDocument()
               throws IOException
```
    Returns the next document.
    
    Returns:
    
    the next document, or null if there are no other documents.
    
    Throws:
    
    IOException
  - close
```
void close()
    throws IOException
```
    Closes this document iterator, releasing all resources.
    You should always call this method after having finished with this iterator. Implementations are invited to call this method in a finaliser as a safety net, but since there is no guarantee as to when finalisers are invoked, you should not depend on this behaviour.
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in interface Closeable
    
    Throws:
    
    IOException