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