CKTIS / Java
Comodín con límite inferior: `? super String`
Descubre por qué `Spliterator<String>.tryAdvance` admite un consumidor de `String` o de un supertipo como `CharSequence`.
Versión: Java SE 21
Sintaxis
? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);En Consumer<? super String>, ? representa un argumento de tipo desconocido y super String fija su límite inferior. Ese argumento puede ser String o un supertipo suyo, como CharSequence u Object. Esto no hace que Consumer<Object> sea un subtipo de Consumer<String>: sin el comodín, ninguno de los dos tipos parametrizados es asignable al otro.
Con una referencia de tipo Consumer<? super String> se puede llamar a accept con un String, pero no con un Object cualquiera ni con un StringBuilder: el consumidor real podría aceptar únicamente String. En cambio, Consumer<? extends CharSequence> no garantiza que accept admita un String, porque el argumento de tipo desconocido podría ser StringBuilder. Usa super al pasar valores a un consumidor (regla PECS: consumer super).
En Spliterator<T>, el método boolean tryAdvance(Consumer<? super T> action) admite un Consumer<? super String> cuando T = String. Si queda algún elemento, el método pasa uno a la acción y devuelve true si esta termina normalmente. Si el spliterator es ORDERED, se usa el siguiente elemento en el orden de recorrido. Si no quedan elementos, devuelve false sin invocar la acción.
Una acción null provoca una NullPointerException. Si la acción lanza una excepción, esta se propaga al código que llamó al método y el comportamiento posterior del spliterator queda sin especificar.
Ejemplos
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
Un `Consumer<CharSequence>` puede procesar un `String` sin conversión explícita. En la primera llamada se imprime la longitud de `Java` (`4`) antes que `true`; la segunda imprime `false` y no ejecuta la acción.
Lecciones relacionadas
- Java · Lección 23 · Avanzado · Versión: 2