В чем разница между getName(), getCanonicalName() и getSimpleName() в Java?

Основные различия между getName(), getSimpleName() и getCanonicalName()

Эти три метода из класса java.lang.Class возвращают имя класса, но в разных форматах. Главные отличия проявляются при работе с:

• Внутренними (вложенными) классами
• Массивами
• Анонимными классами
• Примитивными типами

1. getSimpleName() — самое короткое имя

Возвращает просто имя класса без пакета. Для внутренних классов возвращает только имя вложенного класса, без имени внешнего класса.

// Внешний класс
class Outer {
    // Внутренний класс
    static class Inner {}
}

public class Test {
    public static void main(String[] args) {
        // Обычный класс
        System.out.println(String.class.getSimpleName()); // "String"
        
        // Внутренний класс
        System.out.println(Outer.Inner.class.getSimpleName()); // "Inner"
        
        // Массив
        System.out.println(new int[0].getClass().getSimpleName()); // "int[]"
        
        // Анонимный класс
        Object obj = new Object() {};
        System.out.println(obj.getClass().getSimpleName()); // "" (пустая строка)
        
        // Примитив
        System.out.println(int.class.getSimpleName()); // "int"
    }
}

2. getName() — полное имя, используемое JVM

Возвращает имя класса в формате, который использует виртуальная машина Java (JVM). Для массивов использует специальную кодировку.

public class Test {
    public static void main(String[] args) {
        // Обычный класс
        System.out.println(String.class.getName()); // "java.lang.String"
        
        // Внутренний класс (использует $ как разделитель!)
        System.out.println(Outer.Inner.class.getName()); // "Outer$Inner"
        
        // Массив
        System.out.println(new int[0].getClass().getName()); // "[I" (кодировка JVM)
        System.out.println(new String[0].getClass().getName()); // "[Ljava.lang.String;"
        
        // Двумерный массив
        System.out.println(new int[0][0].getClass().getName()); // "[[I"
        
        // Примитив
        System.out.println(int.class.getName()); // "int"
    }
}

3. getCanonicalName() — каноническое имя (человекочитаемое)

Возвращает имя, которое можно использовать в import. Для внутренних классов использует точку (.) вместо $.

public class Test {
    public static void main(String[] args) {
        // Обычный класс
        System.out.println(String.class.getCanonicalName()); // "java.lang.String"
        
        // Внутренний класс (использует точку!)
        System.out.println(Outer.Inner.class.getCanonicalName()); // "Outer.Inner"
        
        // Массив
        System.out.println(new int[0].getClass().getCanonicalName()); // "int[]"
        System.out.println(new String[0].getClass().getCanonicalName()); // "java.lang.String[]"
        
        // Анонимный класс
        Object obj = new Object() {};
        System.out.println(obj.getClass().getCanonicalName()); // null!
        
        // Примитив
        System.out.println(int.class.getCanonicalName()); // "int"
    }
}

Сводная таблица для сложных случаев

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

• getSimpleName() — для вывода имени в UI или логи, когда не нужен полный путь
• getName() — для работы с ClassLoader, рефлексии, загрузки классов по имени (например, Class.forName())
• getCanonicalName() — когда нужно получить имя, которое можно использовать в import или для генерации кода

Важно: getCanonicalName() может вернуть null для анонимных и локальных классов, а getName() — никогда. getSimpleName() для анонимных классов возвращает пустую строку.

// Правильно:
Class.forName("com.example.Outer$Inner"); // getName()

// Ошибка:
Class.forName("com.example.Outer.Inner"); // getCanonicalName() — не сработает!