CKTIS / Java
Classes e interfaces aninhadas em Java
Distingue as classes aninhadas estáticas das classes internas, expõe as etapas de um builder através de interfaces públicas e parametriza uma cache LRU aninhada.
Versão: Java SE 21
Sintaxe
class Outer {
public interface Step { Result build(); }
private static final class Builder implements Step {
public Result build() { return new Result(); }
}
public static final class Result {}
static class LRUCache<K,V> {}
class Inner {}
}
// Where accessible: new Outer.Result() vs. outer.new Inner()Uma classe aninhada estática não tem uma instância envolvente implícita. A partir de fora, é referida como Outer.Nested e, se o construtor estiver acessível, pode ser instanciada com new Outer.Nested(). Para aceder aos membros de instância de outro objeto da classe envolvente, é necessária uma referência explícita a esse objeto. Se a classe aninhada estender a classe envolvente, os seus métodos de instância podem aceder aos membros de instância herdados através do seu próprio this implícito. Já uma classe membro não estática (classe interna) tem uma instância envolvente e pode ser criada com outer.new Inner().
Em static final class, static indica que não há instância envolvente e final impede a criação de subclasses. Nenhum destes modificadores torna os objetos imutáveis. Em private static final class Builder, private também oculta o tipo de implementação ao código cliente fora da classe envolvente.
As interfaces aninhadas são implicitamente static, mas uma interface membro declarada numa classe não é automaticamente public. No exemplo, as interfaces públicas Main.TitleStep e Main.BuildStep definem as operações disponíveis. O tipo devolvido por builder() não expõe build(); o tipo devolvido por title(...) expõe esse método.
static class LRUCache<K,V> declara os seus próprios parâmetros de tipo: K para as chaves e V para os valores. Não pode usar os parâmetros de tipo da classe envolvente. O exemplo usa um LinkedHashMap ordenado por acesso. Quando o tamanho ultrapassa o limite, pollFirstEntry() remove a entrada cujo último acesso é o mais antigo. O método pertence à API do Java SE 21; a cache do exemplo não é segura para acesso concorrente.
Exemplos
import java.util.LinkedHashMap;
public class Main {
public interface TitleStep {
BuildStep title(String title);
}
public interface BuildStep {
Report build();
}
public static TitleStep builder() {
return new Builder();
}
private static final class Builder implements TitleStep, BuildStep {
private String title;
@Override
public BuildStep title(String title) {
this.title = title;
return this;
}
@Override
public Report build() {
return new Report(title);
}
}
public static final class Report {
private final String title;
private Report(String title) {
this.title = title;
}
public String title() {
return title;
}
}
static class LRUCache<K,V> {
private final int limit;
private final LinkedHashMap<K,V> entries = new LinkedHashMap<>(16, 0.75f, true);
LRUCache(int limit) {
if (limit < 1) {
throw new IllegalArgumentException("limit must be positive");
}
this.limit = limit;
}
V get(K key) {
return entries.get(key);
}
void put(K key, V value) {
entries.put(key, value);
if (entries.size() > limit) {
entries.pollFirstEntry();
}
}
}
public static void main(String[] args) {
Report report = Main.builder().title("Report").build();
System.out.println(report.title());
Main.LRUCache<String, Integer> cache = new Main.LRUCache<>(2);
cache.put("a", 1);
cache.put("b", 2);
System.out.println(cache.get("a"));
cache.put("c", 3);
System.out.println(cache.get("b"));
}
}Resultado
Report 1 null
O programa não cria nenhum objeto `Main`. Ler `a` devolve `1` e atualiza a ordem de acesso, pelo que adicionar `c` remove `b`. A leitura posterior de `b` devolve `null`.
Lições relacionadas
- Java · Lição 37 · Intermédio · Versão: 2
- Java · Lição 38 · Intermédio · Versão: 2
- Java · Lição 40 · Intermédio · Versão: 2
Fontes
- Java Language Specification, Java SE 21 — §8.1.3 Inner Classes and Enclosing Instances
- Java Language Specification, Java SE 21 — §8.1.1.2 sealed, non-sealed, and final Classes
- Java Language Specification, Java SE 21 — §8.5 Member Class and Interface Declarations
- Java Language Specification, Java SE 21 — §9.1.1.3 static Interfaces
- Java Language Specification, Java SE 21 — §9.5 Member Class and Interface Declarations
- LinkedHashMap (Java SE 21 & JDK 21)
- SequencedMap (Java SE 21 & JDK 21) — pollFirstEntry()