`Stream.distinct` în Java

Operații intermediare pe stream-uri Java 8

Elimină duplicatele din stream, păstrând prima apariție a fiecărei valori.

Sintaxă

Stream<T> distinct()

Ce face `Stream.distinct`

distinct() lasă să treacă doar elementele care nu au mai apărut. Două elemente sunt considerate egale după equals (și hashCode), deci pentru clasele tale aceste metode trebuie să fie scrise corect. Un record le are automat.

Pe un stream ordonat (din listă), se păstrează prima apariție și ordinea inițială. Dacă vrei valorile unice și sortate, adaugă sorted() după distinct().

Ce returnează

Un stream fără duplicate.

Exemple

Exemplul 1: Orașele unice dintr-o listă de comenzi

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> orase = List.of("Iași", "Cluj", "Iași", "Arad", "Cluj", "Iași");
        System.out.println(orase.stream().distinct().toList());
        System.out.println(orase.stream().distinct().sorted().toList());
        System.out.println("Orașe diferite: " + orase.stream().distinct().count());
    }
}

Rezultat

[Iași, Cluj, Arad]
[Arad, Cluj, Iași]
Orașe diferite: 3

Exemplul 2: Duplicatele la record și la clase obișnuite

Un record are equals generat, deci duplicatele dispar. O clasă fără equals compară adresele obiectelor, deci nu elimină nimic.

import java.util.List;

public class Main {
    record Persoana(String nume, int varsta) {}

    static class Client {
        final String nume;
        Client(String nume) { this.nume = nume; }
    }

    public static void main(String[] args) {
        List<Persoana> p = List.of(new Persoana("Ana", 20), new Persoana("Ana", 20), new Persoana("Ana", 21));
        System.out.println("Persoane distincte: " + p.stream().distinct().count());

        List<Client> c = List.of(new Client("Dan"), new Client("Dan"));
        System.out.println("Clienți distincți: " + c.stream().distinct().count());
    }
}