В чем разница между внутренним классом (inner class) и статическим вложенным классом (static nested class) в Java?

Основное различие: связь с экземпляром внешнего класса

Ключевое отличие между внутренним классом (inner class) и статическим вложенным классом (static nested class) заключается в том, что inner class неявно хранит ссылку на экземпляр внешнего класса, а static nested class — нет.

Это объясняет, почему ваш Inner может обращаться к полю message напрямую — он "знает" о конкретном объекте Outer, в контексте которого был создан. StaticNested же существует независимо и может обращаться только к статическим членам внешнего класса.

Как создавать экземпляры

Разница проявляется и в синтаксисе создания:

// Для inner class нужен экземпляр внешнего класса
Outer outer = new Outer();
Outer.Inner inner = outer.new Inner(); // или new Outer().new Inner()

// Для static nested class экземпляр внешнего класса не нужен
Outer.StaticNested nested = new Outer.StaticNested();

Когда что использовать?

• Inner class — когда вложенный класс должен иметь доступ к нестатическим полям и методам внешнего класса. Например, реализация итератора для коллекции:

public class MyList<E> {
    private E[] elements;
    
    public class MyIterator implements Iterator<E> {
        private int index = 0;
        
        @Override
        public boolean hasNext() {
            return index < elements.length;
        }
        
        @Override
        public E next() {
            return elements[index++];
        }
    }
}

• Static nested class — когда вложенный класс логически связан с внешним, но не требует доступа к его экземпляру. Это более эффективно (меньше памяти, нет лишней ссылки). Пример — строитель (Builder) или вспомогательные утилиты:

public class Person {
    private String name;
    private int age;
    
    public static class Builder {
        private String name;
        private int age;
        
        public Builder setName(String name) {
            this.name = name;
            return this;
        }
        
        public Builder setAge(int age) {
            this.age = age;
            return this;
        }
        
        public Person build() {
            return new Person(name, age);
        }
    }
    
    private Person(String name, int age) {
        this.name = name;
        this.age = age;
    }
}

// Использование:
Person person = new Person.Builder()
    .setName("Alice")
    .setAge(30)
    .build();

Важные технические детали

• Inner class не может содержать статические поля или методы (за исключением констант времени компиляции).
• Static nested class может содержать статические члены.
• Inner class хранит скрытую ссылку this$0 на внешний объект, что может вызывать утечки памяти (например, если внутренний класс передается куда-то, а внешний класс уже не нужен).
• Static nested class не имеет такой проблемы — он не удерживает внешний объект.

Практический совет

Если вы сомневаетесь, используйте static nested class. Он проще, безопаснее с точки зрения памяти и не имеет ограничений на статические члены. Inner class применяйте только когда вам действительно нужен доступ к нестатическим членам внешнего класса.

В Java 16 появилась возможность объявлять record как вложенные классы — они по умолчанию являются статическими. Это еще один аргумент в пользу статических вложенных классов в современном коде.