Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Collectors.collectingAndThen: référence pratique

Collectors.collectingAndThen: référence pratique: Collectors.collectingAndThen adapte un collector downstream et applique le finisher exactement une fois au résultat achevé ; IDENTITY_FINISH disparaît.

Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntaxe

Collectors.collectingAndThen(...)

Collectors.collectingAndThen adapte un collector downstream et applique le finisher exactement une fois au résultat achevé ; IDENTITY_FINISH disparaît.

À utiliser quand la réduction doit immédiatement convertir le résultat intermédiaire, par exemple une List en copie non modifiable.

Le finisher ne s’exécute pas par élément et les characteristics du downstream ne sont pas conservées intégralement.

Un stream vide fournit encore le résultat vide downstream au finisher ; toute exception de celui-ci se propage.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of(3, 1, 2)
                .collect(java.util.stream.Collectors.collectingAndThen(
                    java.util.stream.Collectors.toList(), java.util.List::copyOf));
        System.out.println(result);
        try { result.add(4); } catch (UnsupportedOperationException error) { System.out.println("unmodifiable"); }
    }
}

Résultat

[3, 1, 2]
unmodifiable

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources