Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Class.getName() — nazwa typu w Javie

Metoda `Class.getName()` zwraca nazwę reprezentowanego typu. Dla zwykłych klas i interfejsów jest to nazwa binarna, a dla tablic obowiązuje osobny zapis.

Wersja: Java SE 21

Składnia

public String getName()

Class.getName to metoda instancji bez argumentów, która zwraca String. Użyj Typ.class.getName(), gdy znasz typ, albo obiekt.getClass().getName(), aby poznać nazwę rzeczywistej klasy obiektu, a nie zadeklarowanego typu zmiennej. Wywołanie getClass() na null kończy się NullPointerException.

Dla klasy lub interfejsu, które nie są ukryte ani tablicowe, wynikiem jest nazwa binarna. Dla ArrayList to java.util.ArrayList: z nazwą pakietu, ale bez argumentów typu, takich jak <String>. W nazwie typu będącego składową innego typu separatorem jest $, np. java.util.Map$Entry. Ukryta klasa lub ukryty interfejs ma zamiast tego nazwę w postaci N/sufiks, gdzie N jest nazwą binarną zapisaną w pliku klasy.

W nazwie tablicy każdy wymiar dodaje jeden znak [ na początku; dalej występuje kod typu elementów. Dla typu referencyjnego o nazwie binarnej N jest to L + N + ;, więc String[] daje [Ljava.lang.String;. Kod int w tablicy to I, więc int[][] daje [[I. Poza tablicą typ pierwotny i void są zapisywane jak słowa kluczowe: int, void.

Dla Map.Entry metoda getSimpleName() zwraca Entry, a getCanonicalName() — java.util.Map.Entry. Gdy typ nie ma nazwy kanonicznej, np. w przypadku klasy anonimowej, getCanonicalName() zwraca null. Nazwa z getName() nie jest haszem ani unikatowym identyfikatorem typu: różne obiekty Class mogą mieć tę samą nazwę, jeśli pochodzą z różnych programów ładujących klasy.

Przykłady

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>();

        System.out.println(List.class.getName());
        System.out.println(items.getClass().getName());
        System.out.println(Map.Entry.class.getName());
        System.out.println(String[].class.getName());
        System.out.println(int[][].class.getName());
        System.out.println(int.class.getName());
        System.out.println(void.class.getName());
    }
}

Wynik

java.util.List
java.util.ArrayList
java.util.Map$Entry
[Ljava.lang.String;
[[I
int
void

Pierwszy wiersz podaje nazwę interfejsu `List`. Drugi podaje nazwę rzeczywistej implementacji, `java.util.ArrayList`, mimo że zmienna ma zadeklarowany typ `List<String>`.

Powiązane lekcje

  • Java · Lekcja 5 · Zaawansowany · Wersja: 2
  • Java · Lekcja 13 · Zaawansowany · Wersja: 2
  • Java · Lekcja 8 · Średniozaawansowany · Wersja: 2

Źródła