Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Comparator.nullsFirst — valores null primeiro

Usa `Comparator.nullsFirst` para colocar as pessoas sem idade registada antes das que têm uma idade conhecida, quando a chave de ordenação principal é igual.

Versão: Java SE 21

Sintaxe

static <T> Comparator<T> nullsFirst(Comparator<? super T> comparator)

Comparator.nullsFirst é um método estático da interface java.util.Comparator, disponível desde o Java 8. Devolve um Comparator<T> que coloca null antes de qualquer valor não nulo. A comparação de dois valores null devolve 0. O comparador fornecido, que pode comparar valores do tipo T ou de um supertipo, só é chamado quando ambos os valores são não nulos.

Passa Comparator.naturalOrder() para aplicar a ordem natural aos valores presentes, como a ordem numérica crescente para as idades. Em Comparator.nullsFirst(null), o argumento null indica que não há um comparador para os valores presentes: todos são considerados iguais na comparação, em vez de serem ordenados pela ordem natural.

Se a chave puder faltar, mas o objeto estiver presente, passa o comparador de chaves como segundo argumento de thenComparing. No exemplo, Person::age devolve um Integer, que pode ser null, ao contrário de int. A idade só é comparada quando a comparação dos grupos devolve 0. Isto não permite que um elemento da lista seja ele próprio null: extrair o seu grupo lançaria uma NullPointerException.

Exemplos

import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;

public class Main {
    record Person(String group, String name, Integer age) {}

    public static void main(String[] args) {
        var people = new ArrayList<>(List.of(
            new Person("B", "Ivo", null),
            new Person("A", "Mia", 30),
            new Person("A", "Ada", null),
            new Person("A", "Leo", 21),
            new Person("A", "Eli", null)
        ));

        Comparator<Person> byGroupThenAge = Comparator.comparing(Person::group)
            .thenComparing(Person::age,
                Comparator.nullsFirst(Comparator.naturalOrder()));

        people.sort(byGroupThenAge);
        for (Person person : people) {
            System.out.println(person.group() + " " + person.name() + " " + person.age());
        }
    }
}

Resultado

A Ada null
A Eli null
A Leo 21
A Mia 30
B Ivo null

No grupo A, Ada e Eli têm idade `null` e mantêm a ordem inicial, pois `List.sort` é estável. Seguem-se Leo (21) e Mia (30). Ivo pertence ao grupo B, pelo que fica em último apesar de não ter idade registada.

Lições relacionadas

  • Java · Lição 35 · Intermédio · Versão: 2

Fontes