Cloneable
public class ElementIterator extends Object implements Cloneable
ElementIterator
, as the name suggests, iterates over the Element
tree. The constructor can be invoked with either Document
or an Element
as an argument. If the constructor is invoked with a Document
as an argument then the root of the iteration is the return value of document.getDefaultRootElement()
. The iteration happens in a depth-first manner. In terms of how boundary conditions are handled:
next()
is called before first()
or current()
, the root will be returned next()
returns null
to indicate the end of the list previous()
returns null
when the current element is the root or next()
has returned null
The ElementIterator
does no locking of the Element
tree. This means that it does not track any changes. It is the responsibility of the user of this class, to ensure that no changes happen during element iteration.
Simple usage example:
public void iterate() {
ElementIterator it = new ElementIterator(root);
Element elem;
while (true) {
if ((elem = it.next()) != null) {
// process element
System.out.println("elem: " + elem.getName());
} else {
break;
}
}
}
Constructor | Description |
---|---|
ElementIterator |
Creates a new ElementIterator . |
ElementIterator |
Creates a new ElementIterator . |
Modifier and Type | Method | Description |
---|---|---|
Object |
clone() |
Clones the ElementIterator . |
Element |
current() |
Fetches the current Element . |
int |
depth() |
Fetches the current depth of element tree. |
Element |
first() |
Fetches the first element. |
Element |
next() |
Fetches the next Element . |
Element |
previous() |
Fetches the previous Element . |
public ElementIterator(Document document)
ElementIterator
. The root element is taken to get the default root element of the document.document
- a Document
public ElementIterator(Element root)
ElementIterator
.root
- the root Element
public Object clone()
ElementIterator
.public Element first()
Element
public int depth()
public Element current()
Element
.null
if the root element is null
public Element next()
Element
. The strategy used to locate the next element is a depth-first search.null
at the end of the listpublic Element previous()
Element
. If however the current element is the last element, or the current element is null
, then null
is returned.Element
if available
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/text/ElementIterator.html