W3cubDocs

/OpenJDK 21

Class ElementIterator

java.lang.Object
javax.swing.text.ElementIterator
All Implemented Interfaces:
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:

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 Summary

Constructor Description
ElementIterator(Document document)
Creates a new ElementIterator.
ElementIterator(Element root)
Creates a new ElementIterator.

Method Summary

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.

Methods declared in class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ElementIterator

public ElementIterator(Document document)
Creates a new ElementIterator. The root element is taken to get the default root element of the document.
Parameters:
document - a Document

ElementIterator

public ElementIterator(Element root)
Creates a new ElementIterator.
Parameters:
root - the root Element

Method Details

clone

public Object clone()
Clones the ElementIterator.
Overrides:
clone in class Object
Returns:
a cloned ElementIterator Object
See Also:

first

public Element first()
Fetches the first element.
Returns:
an Element

depth

public int depth()
Fetches the current depth of element tree.
Returns:
the depth

current

public Element current()
Fetches the current Element.
Returns:
element on top of the stack or null if the root element is null

next

public Element next()
Fetches the next Element. The strategy used to locate the next element is a depth-first search.
Returns:
the next element or null at the end of the list

previous

public Element previous()
Fetches the previous Element. If however the current element is the last element, or the current element is null, then null is returned.
Returns:
previous 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