CKTIS / Java
Type joker à borne inférieure : `? super String`
Découvrez pourquoi `Spliterator<String>.tryAdvance` accepte aussi bien un consommateur de `String` qu’un consommateur d’un supertype comme `CharSequence`.
Version : Java SE 21
Syntaxe
? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);Dans Consumer<? super String>, ? désigne un argument de type inconnu, et super String en fixe la borne inférieure. Cet argument peut être String lui-même ou un supertype comme CharSequence ou Object. Cela ne fait pas de Consumer<Object> un sous-type de Consumer<String> : sans type joker, ces deux types paramétrés ne sont pas assignables l’un à l’autre.
Avec une référence de type Consumer<? super String>, on peut appeler accept avec un String, mais pas avec un Object quelconque ni avec un StringBuilder : le consommateur réel pourrait n’accepter que des String. À l’inverse, Consumer<? extends CharSequence> ne garantit pas que accept puisse recevoir un String, car l’argument de type inconnu pourrait être StringBuilder. Utilisez super pour fournir des valeurs à un consommateur (règle PECS : consumer super).
Dans Spliterator<T>, la méthode boolean tryAdvance(Consumer<? super T> action) accepte un Consumer<? super String> lorsque T = String. S’il reste un élément, la méthode en transmet un à l’action et renvoie true si l’action se termine normalement. Pour un spliterator ORDERED, il s’agit du prochain élément dans l’ordre de parcours. S’il ne reste aucun élément, la méthode renvoie false sans appeler l’action.
Une action null provoque une NullPointerException. Si l’action lève une exception, celle-ci est propagée à l’appelant et le comportement ultérieur du spliterator n’est pas spécifié.
Exemples
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));
}
}Résultat
4 true false
Un `Consumer<CharSequence>` peut traiter un `String` sans transtypage. Le premier appel affiche la longueur de `Java` (`4`) avant l’affichage de `true` ; le second affiche `false` sans exécuter l’action.
Leçons associées
- Java · Leçon 23 · Avancé · Version : 2