CKTIS / Java
Caráter universal com limite inferior: `? super String`
Percebe por que razão `Spliterator<String>.tryAdvance` aceita tanto um consumidor de `String` como um consumidor de um supertipo, por exemplo `CharSequence`.
Versão: Java SE 21
Sintaxe
? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);Em Consumer<? super String>, ? representa um argumento de tipo desconhecido e super String define o seu limite inferior. O argumento pode ser o próprio String ou um supertipo como CharSequence ou Object. Isto não torna Consumer<Object> um subtipo de Consumer<String>: sem o caráter universal, nenhum dos tipos parametrizados é atribuível ao outro.
Através de uma referência de tipo Consumer<? super String>, podes chamar accept com um String, mas não com um Object qualquer nem com um StringBuilder: o consumidor concreto pode aceitar apenas String. Em contraste, Consumer<? extends CharSequence> não garante que accept aceite um String, pois o argumento de tipo desconhecido pode ser StringBuilder. Usa super quando passas valores a um consumidor (regra PECS: consumer super).
Em Spliterator<T>, o método boolean tryAdvance(Consumer<? super T> action) aceita um Consumer<? super String> quando T = String. Se ainda houver elementos, o método passa um deles à ação e devolve true se a ação terminar normalmente. Num spliterator ORDERED, é usado o elemento seguinte na ordem de percurso. Se não restarem elementos, devolve false sem invocar a ação.
Uma ação null provoca uma NullPointerException. Se a ação lançar uma exceção, esta é propagada a quem chamou o método e o comportamento posterior do spliterator não é especificado.
Exemplos
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));
}
}Resultado
4 true false
Um `Consumer<CharSequence>` pode processar um `String` sem conversão explícita. A primeira chamada escreve o comprimento de `Java` (`4`) antes de `true`; a segunda escreve `false` e não executa a ação.
Lições relacionadas
- Java · Lição 23 · Avançado · Versão: 2