WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Iterable — ein Vertrag zum Durchlaufen von Elementen

java.lang.Iterable<T> ermöglicht die Verwendung eines Objekts in einer erweiterten for-Schleife. Die Methode iterator() liefert einen Iterator; die Standardmethode forEach() führt eine Aktion für aufeinanderfolgende Elemente aus.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public interface Iterable<T>
Iterator<T> iterator()
default void forEach(Consumer<? super T> action)

java.lang.Iterable<T> ermöglicht die Verwendung eines Objekts in einer erweiterten for-Schleife; T gibt den Elementtyp an. Es handelt sich um einen Vertrag zum Durchlaufen von Elementen, nicht um einen konkreten Container.

Iterable.iterator() gibt einen Iterator<T> zurück. Unterscheide das Objekt, das die Iteration ermöglicht, vom Iterator, der ihren Fortschritt verfolgt: hasNext() prüft, ob ein Element verfügbar ist, und next() ruft es ab. Ist kein Element verfügbar, löst next() eine NoSuchElementException aus.

Iterable.forEach(Consumer<? super T> action) ist eine Standardmethode. Sie verarbeitet Elemente in der Iterationsreihenfolge, sofern eine festgelegt ist. Eine Ausnahme in der Aktion bricht die Verarbeitung ab und wird an den Aufrufer weitergegeben; eine null-Aktion verursacht eine NullPointerException. Ändere die Quelle nicht innerhalb der Aktion: Das Verhalten ist nicht festgelegt, sofern die Implementierung keine entsprechende Richtlinie definiert.

Das Beispiel implementiert iterator() mithilfe der geordneten Liste List.of("A", "B") und übernimmt forEach(). Jeder Aufruf von iterator() erstellt hier einen neuen Iterator, sodass beide Durchläufe beide Elemente ausgeben.

Beispiele

import java.util.Iterator;
import java.util.List;

public class Main implements Iterable<String> {
    @Override
    public Iterator<String> iterator() {
        return List.of("A", "B").iterator();
    }

    public static void main(String[] args) {
        Main letters = new Main();
        for (String letter : letters) {
            System.out.println("loop: " + letter);
        }
        letters.forEach(letter -> System.out.println("action: " + letter));
    }
}

Ergebnis

loop: A
loop: B
action: A
action: B

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen