public interface NodeIterator<T>
extends Iterator<T>

Extended iterator interface used by various methods in CoreParentNode. It defines an additional method that allows to replace the child node returned by the last call to Iterator.next().

All implementations of this interface must satisfy the following requirements:

1. The implementation MUST properly implement the Iterator.remove() method, i.e. it is not allowed to throw UnsupportedOperationException.
2. A ConcurrentModificationException MUST be thrown when the iterator is used after the last node returned by Iterator.next() has been removed using a method other than Iterator.remove() (e.g. CoreChildNode.coreDetach(Semantics)).
3. If a CoreModelException occurs inside Iterator.hasNext(), Iterator.next() or Iterator.remove(), then the implementation MUST use the supplied ExceptionTranslator to translate that checked exception into an unchecked exception.