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

CKTIS / Java

Limites dos parâmetros de tipo genéricos

Os limites restringem os tipos que podem ser usados como argumentos genéricos. Aprende a preservar o tipo concreto de um builder, a comparar através de um supertipo e a exigir vários limites em simultâneo.

Versão: Java SE 21

Sintaxe

<T extends Builder<T>>
<T extends Comparable<? super T>>
<T extends Comparable<T> & Serializable>
<T extends Entity & Prioritized>

Em Java SE 21, <T extends ...> declara um limite superior para um parâmetro de tipo. Usa-se extends tanto para classes como para interfaces. O compilador verifica se o argumento de tipo satisfaz o limite e permite usar os membros acessíveis que este disponibiliza.

T extends Builder<T> é um limite recursivo: T aparece como argumento de tipo no seu próprio limite. Quando TaskBuilder estende Builder<TaskBuilder>, o método herdado named devolve um TaskBuilder, pelo que se pode chamar logo build. O limite, por si só, não prova que this tem o tipo T; um método abstrato self() permite que a subclasse devolva this sem conversão explícita de tipo.

T extends Comparable<? super T> permite passar um valor do tipo T a compareTo, pois a comparação aceita T ou um supertipo de T. Comparable é invariante: através de ChronoLocalDate, LocalDate implementa Comparable<ChronoLocalDate>, não Comparable<LocalDate>. Assim, LocalDate satisfaz o limite com o wildcard de limite inferior ? super T, mas não Comparable<T> para T = LocalDate.

T extends Comparable<T> & Serializable exige tanto Comparable<T> como a interface marcadora Serializable. O limite não efetua serialização nem garante que todo o grafo de objetos possa ser serializado; LocalDate é rejeitado apesar de implementar Serializable. Já T extends Entity & Prioritized exige que T seja Entity ou uma subclasse e implemente Prioritized. Nas duas declarações, & indica uma interseção de tipos, não um AND bit a bit. Se houver uma classe num limite múltiplo, tem de vir primeiro; só podem seguir-se interfaces. O primeiro limite determina o apagamento de tipo de T.

Exemplos

import java.io.Serializable;
import java.time.LocalDate;

public class GenericBoundsDemo {
    abstract static class Builder<T extends Builder<T>> {
        protected String name;

        final T named(String name) {
            this.name = name;
            return self();
        }

        protected abstract T self();
    }

    static final class TaskBuilder extends Builder<TaskBuilder> {
        @Override
        protected TaskBuilder self() { return this; }

        Task build(int priority) { return new Task(name, priority); }
    }

    static class Entity {
        private final String name;

        Entity(String name) { this.name = name; }
        final String name() { return name; }
    }

    interface Prioritized {
        int priority();
    }

    static final class Task extends Entity implements Prioritized {
        private final int priority;

        Task(String name, int priority) {
            super(name);
            this.priority = priority;
        }

        @Override
        public int priority() { return priority; }
    }

    static <T extends Entity & Prioritized> String describe(T value) {
        return value.name() + " (priority " + value.priority() + ")";
    }

    static <T extends Comparable<? super T>> T min(T a, T b) {
        return a.compareTo(b) <= 0 ? a : b;
    }

    static <T extends Comparable<? super T>> T max(T a, T b) {
        return a.compareTo(b) >= 0 ? a : b;
    }

    static <T extends Comparable<? super T>> boolean isBefore(T a, T b) {
        return a.compareTo(b) < 0;
    }

    static <T extends Comparable<T> & Serializable> T minSerializable(T a, T b) {
        return min(a, b);
    }

    public static void main(String[] args) {
        Task task = new TaskBuilder().named("Backup").build(3);
        System.out.println(describe(task));

        LocalDate a = LocalDate.of(2026, 2, 1);
        LocalDate b = LocalDate.of(2026, 1, 15);
        LocalDate earlier = min(a, b);
        LocalDate later = max(a, b);
        System.out.println(earlier + " < " + later + ": " + isBefore(earlier, later));

        System.out.println(minSerializable("beta", "alpha"));
    }
}

Resultado

Backup (priority 3)
2026-01-15 < 2026-02-01: true
alpha

`named` preserva o tipo `TaskBuilder` e `describe` usa os dois limites. `min`, `max` e `isBefore` aceitam valores `LocalDate`; `minSerializable` compara cadeias de caracteres sem as serializar.

Lições relacionadas

  • Java · Lição 11 · Avançado · Versão: 2
  • Java · Lição 15 · Avançado · Versão: 2
  • Java · Lição 16 · Avançado · Versão: 2
  • Java · Lição 32 · Intermédio · Versão: 2

Fontes