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

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

Fontes