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
- Java Language Specification, Java SE 21 — §4.4 Type Variables
- Java Language Specification, Java SE 21 — §4.5.1 Type Arguments of Parameterized Types
- Java Language Specification, Java SE 21 — §4.6 Type Erasure
- Comparable (Java SE 21 & JDK 21)
- LocalDate (Java SE 21 & JDK 21)
- ChronoLocalDate (Java SE 21 & JDK 21)
- Serializable (Java SE 21 & JDK 21)
- The java Command (JDK 21)