com.hp.hpl.mesa.rdf.jena.model
Interface StmtIterator

All Known Implementing Classes:

StmtIteratorImpl

public interface StmtIterator

An iterator which returns RDF Statements.

RDF iterators are similar to standard Java iterators, except that they return specifically typed objects, in this case RDF Statements and have a close() method. This should be called to free resources if the application does not complete the iteration.

Version:

Release='$Name: $' Revision='$Revision: 1.1 $' Date='$Date: 2001/01/05 14:16:44 $'

Author:

bwm

Method Summary

void	close() Terminate the iteration and free up resources.
boolean	hasNext() Determine if there any more Statements in the iteration.
Statement	next() Return the next Statement of the iteration.
void	remove() Remove the most recently returned Statement from its associated model.

Method Detail

hasNext

public boolean hasNext()
                throws RDFException

Determine if there any more Statements in the iteration.

Returns:

true if and only if there are more Statements available from the iteration.

Throws:

RDFException - Generic RDF exception.

next

public Statement next()
               throws java.util.NoSuchElementException,
                      RDFException

Return the next Statement of the iteration.

Returns:

The next Resource from the iteration.

Throws:

java.util.NoSuchElementException - if there are no more to be returned.

RDFException - Generic RDF exception.

remove

public void remove()
            throws java.util.NoSuchElementException,
                   RDFException

Remove the most recently returned Statement from its associated model.

Throws:

java.util.NoSuchElementException - thrown if no Statement has been returned.

RDFException - Generic RDF exception.

close

public void close()
           throws RDFException

Terminate the iteration and free up resources.

Some implementations, e.g. on relational databases, hold resources while the iterator still exists. These will normally be freed when the iteration completes. However, if an application wishes to ensure they are freed without completing the iteration, this method should be called.

Throws:

RDFException - Generic RDF exception.