Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Declaración de una clase local en Java

Una clase local es una clase anidada con nombre que se declara, por ejemplo, en un bloque de método. El ámbito de su nombre no limita la vida de sus instancias.

Versión: Java SE 21

Sintaxis

{
    class LocalName {
        // Fields, constructors, and methods
    }
    LocalName instance = new LocalName();
}

Una declaración de clase local como class Counter { ... } define una clase anidada con nombre directamente en un bloque, por ejemplo, en el cuerpo de un método, constructor o inicializador. No es un miembro de la clase contenedora. A diferencia de una clase anónima, tiene un nombre simple y se puede instanciar por separado con new Counter().

El ámbito del nombre abarca toda la declaración y el resto del bloque que la contiene directamente. En un grupo de sentencias de un bloque switch, el ámbito termina con ese grupo. Antes de la declaración o fuera de ese ámbito, el nombre no designa esta clase. Una instancia puede sobrevivir al bloque: se puede devolver como IntSupplier y usar después de que termine el método.

La declaración de una clase local no puede incluir public, protected, private, static, sealed ni non-sealed. Tampoco pueden ser sealed su superclase directa ni sus superinterfaces directas. Una clase local ordinaria es una clase interna incluso en un método static, donde no tiene una instancia contenedora. En Java SE 21, aun así puede declarar sus propios miembros static. Las clases locales enum y record son implícitamente static, por lo que no son clases internas y no capturan variables locales ni parámetros del contexto que las contiene.

El código de instancia de una clase local ordinaria solo puede capturar variables locales y parámetros que estén en su ámbito si son final o efectivamente finales. El compilador también debe poder demostrar que se ha asignado un valor a cada variable local capturada antes del cuerpo de la clase. El parámetro step es efectivamente final porque nunca se reasigna. No se puede reasignar la referencia total, pero sí modificar total[0]: final no hace inmutable el array.

Ejemplos

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 el parámetro `step` y la referencia `total`. Una vez que `makeCounter(3)` retorna, las llamadas sucesivas a `getAsInt()` suman `3` al mismo elemento del array, por lo que el programa imprime `3` y luego `6`.

Lecciones relacionadas

  • Java · Lección 14 · Avanzado · Versión: 2
  • Java · Lección 26 · Avanzado · Versión: 2
  • Java · Lección 36 · Avanzado · Versión: 2
  • Java · Lección 7 · Intermedio · Versión: 2

Fuentes