CKTIS / Java
Wildcard mit unterer Schranke: `? super String`
Erfahre, warum `Spliterator<String>.tryAdvance` sowohl einen Consumer für `String` als auch einen Consumer für einen Obertyp wie `CharSequence` akzeptiert.
Version: Java SE 21
Syntax
? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);In Consumer<? super String> steht ? für ein unbekanntes Typargument, und super String legt dessen untere Schranke fest. Das Argument kann String selbst oder ein Obertyp wie CharSequence oder Object sein. Dadurch wird Consumer<Object> nicht zum Untertyp von Consumer<String>: Ohne Wildcard kann keiner der beiden parametrisierten Typen dem anderen zugewiesen werden.
Über eine Referenz vom Typ Consumer<? super String> kannst du accept mit einem String aufrufen, aber nicht mit einem beliebigen Object oder einem StringBuilder: Der konkrete Consumer könnte nur String akzeptieren. Bei Consumer<? extends CharSequence> ist dagegen nicht garantiert, dass accept einen String annimmt, denn das unbekannte Typargument könnte StringBuilder sein. Verwende super, wenn du einem Consumer Werte übergibst (PECS: consumer super).
In Spliterator<T> nimmt die Methode boolean tryAdvance(Consumer<? super T> action) für T = String einen Consumer<? super String> entgegen. Ist noch ein Element vorhanden, übergibt die Methode der Aktion ein Element und gibt nach deren normalem Abschluss true zurück. Bei einem ORDERED-Spliterator ist es das nächste Element in der Traversierungsreihenfolge. Sind keine Elemente mehr vorhanden, gibt die Methode false zurück, ohne die Aktion aufzurufen.
Eine null-Aktion führt zu einer NullPointerException. Wirft die Aktion eine Ausnahme, wird sie an den Aufrufer weitergegeben; das weitere Verhalten des Spliterators ist dann nicht spezifiziert.
Beispiele
import java.util.List;
import java.util.Spliterator;
import java.util.function.Consumer;
public class Main {
public static void main(String[] args) {
Spliterator<String> words = List.of("Java").spliterator();
Consumer<CharSequence> printLength = text -> System.out.println(text.length());
Consumer<? super String> action = printLength;
System.out.println(words.tryAdvance(action));
System.out.println(words.tryAdvance(action));
}
}Ergebnis
4 true false
Ein `Consumer<CharSequence>` kann einen `String` ohne Cast verarbeiten. Beim ersten Aufruf wird die Länge von `Java` (`4`) vor `true` ausgegeben; beim zweiten erscheint `false`, ohne dass die Aktion ausgeführt wird.
Zugehörige Lektionen
- Java · Lektion 23 · Fortgeschritten · Version: 2