Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Wildcard con limite inferiore: `? super String`

Scopri perché `Spliterator<String>.tryAdvance` accetta sia un consumer di `String` sia un consumer di un suo supertipo, come `CharSequence`.

Versione: Java SE 21

Sintassi

? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);

In Consumer<? super String>, ? rappresenta un argomento di tipo sconosciuto e super String ne fissa il limite inferiore. L’argomento può essere String stesso o un suo supertipo come CharSequence oppure Object. Questo non rende Consumer<Object> un sottotipo di Consumer<String>: senza la wildcard, nessuno dei due tipi parametrizzati è assegnabile all’altro.

Tramite un riferimento di tipo Consumer<? super String> puoi chiamare accept con uno String, ma non con un Object qualsiasi né con uno StringBuilder: il consumer effettivo potrebbe accettare soltanto String. Al contrario, Consumer<? extends CharSequence> non garantisce che accept possa ricevere uno String, perché l’argomento di tipo sconosciuto potrebbe essere StringBuilder. Usa super quando passi valori a un consumer (regola PECS: consumer super).

In Spliterator<T>, il metodo boolean tryAdvance(Consumer<? super T> action) accetta un Consumer<? super String> quando T = String. Se rimane un elemento, il metodo ne passa uno all’azione e restituisce true se l’azione termina normalmente. Per uno spliterator ORDERED si tratta dell’elemento successivo nell’ordine di attraversamento. Se non rimangono elementi, restituisce false senza invocare l’azione.

Un’azione null causa una NullPointerException. Se l’azione lancia un’eccezione, questa si propaga al chiamante e il comportamento successivo dello spliterator non è specificato.

Esempi

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));
    }
}

Risultato

4
true
false

Un `Consumer<CharSequence>` può elaborare uno `String` senza cast. La prima chiamata stampa la lunghezza di `Java` (`4`) prima che venga stampato `true`; la seconda stampa `false` e non esegue l’azione.

Lezioni correlate

  • Java · Lezione 23 · Avanzato · Versione: 2

Fonti