CKTIS / Java
Declaração de uma classe local em Java
Uma classe local é uma classe aninhada com nome, declarada, por exemplo, num bloco de um método. O âmbito do nome não limita o tempo de vida das instâncias.
Versão: Java SE 21
Sintaxe
{
class LocalName {
// Fields, constructors, and methods
}
LocalName instance = new LocalName();
}Uma declaração de classe local como class Counter { ... } define uma classe aninhada com nome diretamente num bloco, por exemplo, no corpo de um método, construtor ou inicializador. Não é um membro da classe envolvente. Ao contrário de uma classe anónima, tem um nome simples e pode ser instanciada separadamente com new Counter().
O âmbito do nome abrange toda a declaração e o resto do bloco que a contém diretamente. Num grupo de instruções de um bloco switch, o âmbito termina com esse grupo. Antes da declaração ou fora desse âmbito, o nome não designa esta classe. Uma instância pode sobreviver ao bloco: pode ser devolvida como IntSupplier e usada após o fim do método.
A declaração de uma classe local não pode incluir public, protected, private, static, sealed ou non-sealed. A sua superclasse direta e as suas superinterfaces diretas também não podem ser sealed. Uma classe local normal é uma classe interna mesmo num método static, onde não tem uma instância envolvente. No entanto, em Java SE 21 pode declarar os seus próprios membros static. As classes locais enum e record são implicitamente static: não são classes internas e não capturam variáveis locais nem parâmetros do contexto envolvente.
O código de instância de uma classe local normal só pode capturar variáveis locais e parâmetros que estejam no seu âmbito se forem final ou efetivamente finais. O compilador também tem de conseguir provar que foi atribuído um valor a cada variável local capturada antes do corpo da classe. O parâmetro step é efetivamente final porque nunca recebe outro valor. A referência total não pode receber outro valor, mas total[0] pode ser alterado: final não torna o array imutável.
Exemplos
import java.util.function.IntSupplier;
public class LocalClassDemo {
static IntSupplier makeCounter(int step) {
final int[] total = {0};
class Counter implements IntSupplier {
@Override
public int getAsInt() {
total[0] += step;
return total[0];
}
}
return new Counter();
}
public static void main(String[] args) {
IntSupplier counter = makeCounter(3);
System.out.println(counter.getAsInt());
System.out.println(counter.getAsInt());
}
}Resultado
3 6
`Counter` captura o parâmetro `step` e a referência `total`. Depois de `makeCounter(3)` devolver o resultado, as chamadas sucessivas a `getAsInt()` somam `3` ao mesmo elemento do array, pelo que o programa apresenta `3` e depois `6`.
Lições relacionadas
- Java · Lição 14 · Avançado · Versão: 2
- Java · Lição 26 · Avançado · Versão: 2
- Java · Lição 36 · Avançado · Versão: 2
- Java · Lição 7 · Intermédio · Versão: 2