CKTIS / Java
Collection.spliterator — percorrer os elementos de uma coleção
Collection.spliterator() devolve um objeto para percorrer os elementos de uma coleção e, eventualmente, dividir o trabalho. Saiba mais sobre a implementação predefinida, as características de tamanho e as limitações relacionadas com alterações e concorrência.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
default Spliterator<E> spliterator()Collection.spliterator() devolve um Spliterator<E> sobre os elementos da coleção. tryAdvance(action) processa um elemento e devolve true, ou devolve false quando já não há elementos. forEachRemaining(action) processa os elementos restantes. trySplit() pode separar parte do trabalho num outro spliterator ou devolver null; chamá-lo não inicia threads.
A implementação predefinida de Collection utiliza um Iterator, estabelece uma ligação tardia à origem e herda as respetivas propriedades fail-fast. Indica SIZED e SUBSIZED: o tamanho inicial é exato se não houver alterações estruturais, e os spliterators obtidos por divisão também têm tamanhos conhecidos. Coleções concretas podem substituir este método; consulte a respetiva documentação.
A ligação tardia ocorre no primeiro percurso, divisão ou pedido do tamanho estimado. Não implica uma captura instantânea nem segurança para threads. A deteção fail-fast é apenas uma tentativa de detetar erros, não um mecanismo de sincronização. A menos que a implementação o garanta expressamente, não modifique a origem durante o percurso.
Os métodos predefinidos stream() e parallelStream() utilizam o spliterator da coleção; a possibilidade de divisão não garante uma melhoria de desempenho. O exemplo utiliza uma List ordenada, pelo que apresenta os elementos pela ordem da lista. A interface Collection, por si só, não garante essa ordem.
Exemplos
import java.util.Collection;
import java.util.List;
import java.util.Spliterator;
public class Main {
public static void main(String[] args) {
Collection<Integer> values = List.of(10, 20, 30);
Spliterator<Integer> cursor = values.spliterator();
System.out.println(cursor.getExactSizeIfKnown());
cursor.tryAdvance(System.out::println);
cursor.forEachRemaining(System.out::println);
System.out.println(cursor.tryAdvance(System.out::println));
}
}Resultado
3 10 20 30 false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.