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

All Known Implementing Classes:

NsIteratorImpl

public interface NsIterator

An iterator which returns namespace URI's.

RDF iterators are similar to standard Java iterators, except that they return specifically typed objects, in this case Strings representing namespace URI's, 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:42 $'

Author:

bwm

Method Summary

void	close() Terminate the iteration and free up resources.
boolean	hasNext() Determine if there any more values in the iteration.
java.lang.String	next() Return the next namespace name of the iteration.
void	remove() Unsupported Operation.

Method Detail

hasNext

public boolean hasNext()
                throws RDFException

Determine if there any more values in the iteration.

Returns:

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

Throws:

RDFException - Generic RDF exception.

next

public java.lang.String next()
                      throws java.util.NoSuchElementException,
                             RDFException

Return the next namespace name of the iteration.

Returns:

The next name space URI 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

Unsupported Operation.

Throws:

java.util.NoSuchElementException -

RDFException -

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.