Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Symbol wieloznaczny z dolnym ograniczeniem: `? super String`

Dowiedz się, dlaczego `Spliterator<String>.tryAdvance` przyjmuje nie tylko `Consumer<String>`, lecz także konsumenta typu nadrzędnego wobec `String`.

Wersja: Java SE 21

Składnia

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

W Consumer<? super String> znak ? oznacza nieznany argument typu, a super String wyznacza jego dolne ograniczenie. Tym argumentem może być String lub jego nadtyp, np. CharSequence albo Object. Nie oznacza to, że Consumer<Object> jest podtypem Consumer<String>: bez symbolu wieloznacznego te parametryzacje nie są wzajemnie przypisywalne.

Przez referencję typu Consumer<? super String> można wywołać accept z wartością typu String, ale nie z dowolnym Object ani z StringBuilder: faktyczny konsument może przyjmować tylko String. Odwrotne ograniczenie, Consumer<? extends CharSequence>, nie gwarantuje, że accept przyjmie String, ponieważ nieznanym argumentem typu może być StringBuilder. Gdy przekazujesz dane konsumentowi, wybierz super (reguła PECS: consumer super).

W Spliterator<T> metoda boolean tryAdvance(Consumer<? super T> action) dla T = String przyjmuje Consumer<? super String>. Jeśli pozostał element, metoda przekazuje jeden element do akcji i po jej normalnym zakończeniu zwraca true; dla ORDERED jest to następny element w kolejności przechodzenia. Jeśli nie ma już elementów, zwraca false bez wywołania akcji.

Akcja równa null powoduje NullPointerException. Wyjątek zgłoszony przez akcję jest przekazywany wywołującemu, a dalsze zachowanie spliteratora nie jest wtedy określone.

Przykłady

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

Wynik

4
true
false

`Consumer<CharSequence>` może obsłużyć `String` bez rzutowania. Pierwsze wywołanie wypisuje długość `Java` (`4`) przed wypisaniem `true`; drugie wypisuje `false` i nie uruchamia akcji.

Powiązane lekcje

  • Java · Lekcja 23 · Zaawansowany · Wersja: 2

Źródła