CKTIS / Java
Literał klasy w Javie: `NazwaTypu.class`
Literał `.class` udostępnia obiekt reprezentujący wskazany typ. Można go użyć do filtrowania, określenia typu kluczy `EnumMap`, wyboru monitora lub utworzenia aktualizatora pola.
Wersja: Java SE 21
Składnia
TypeName { [] } . class
NumericType { [] } . class
boolean { [] } . class
void . class
Braces denote zero or more repetitions; they are not Java tokens in the expression.
Examples: String.class, Runnable.class, String[].class, int[].class, int.class, void.classW Java SE 21 wyrażenie NazwaTypu.class daje obiekt Class reprezentujący wskazany typ. Nie tworzy instancji tego typu ani samo nie wywołuje jego inicjalizacji. Dla dostępnego typu referencyjnego C literał C.class ma typ Class<C>; dotyczy to też interfejsów i tablic. int.class i Integer.class mają typ Class<Integer>, ale reprezentują odpowiednio typ prymitywny i klasę opakowującą. void.class ma typ Class<Void>. W zapisie T.class litera T zastępuje nazwę typu; nie może oznaczać zmiennej typu. List<String>.class jest niedozwolone; List.class nie zachowuje typu elementów.
Literał wybiera typ zapisany w kodzie, a obj.getClass() zwraca rzeczywistą klasę obiektu i zgłasza NullPointerException dla null. Type.class ma typ Class<Type> i reprezentuje zadeklarowany enum Type, nie jego stałą. Stała z własnym ciałem klasy ma inną klasę wykonawczą, ale getDeclaringClass() nadal zwraca Type.class. new EnumMap<>(Type.class) wybiera konstruktor tworzący pustą mapę z kluczami typu Type; dla enuma Status przekaż Status.class.
W metodzie <T> List<T> select(List<?> values, Class<T> type) przekazany token wiąże sprawdzanie w czasie wykonania z typem elementów wyniku. String.class, Integer.class, StringBuilder.class, TextNote.class i Metric.class wskazują odpowiednio typy String, Integer, StringBuilder, TextNote i Metric. isInstance akceptuje zgodne niepuste referencje, także do obiektów podklas lub implementacji interfejsu. Następujące po nim cast zwraca tę samą referencję jako T; bez sprawdzenia niezgodna wartość inna niż null powoduje ClassCastException. StringBuilder nie staje się String podczas filtrowania.
synchronized (Main.class) zajmuje monitor obiektu Class<Main>, ten sam, którego używa metoda static synchronized zadeklarowana w Main. To nie monitor this ani osobno utworzonego lock. Klasy o tej samej nazwie zdefiniowane przez różne loadery mogą mieć różne monitory. Użyj prywatnego obiektu blokady, jeśli kod zewnętrzny nie powinien móc zająć tego samego monitora.
W AtomicIntegerFieldUpdater.newUpdater(Metric.class, "count") literał określa klasę deklarującą pole i typ obiektów obsługiwanych przez AtomicIntegerFieldUpdater<Metric>. Nazwa "count" wybiera dostępne pole instancji typu volatile int. Brak pola, brak dostępu lub nieprawidłowa deklaracja powodują błąd przy tworzeniu aktualizatora. Zwiększenie wartości wymaga konkretnej instancji Metric, a nie tokenu klasy.
Przykłady
import java.util.EnumMap;
import java.util.List;
import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;
public class Main {
enum Type { READY {} }
record TextNote(String text) {}
static final class Metric {
volatile int count;
}
static <T> List<T> select(List<?> values, Class<T> type) {
return values.stream().filter(type::isInstance).map(type::cast).toList();
}
void demo() {
Metric metric = new Metric();
List<?> values = List.of(new TextNote("ready"), metric, 7,
new StringBuilder("not a String"));
List<TextNote> notes = select(values, TextNote.class);
List<Metric> metrics = select(values, Metric.class);
List<Integer> integers = select(values, Integer.class);
List<String> strings = select(values, String.class);
System.out.println("note=" + notes.get(0).text());
System.out.println("metric matches=" + metrics.size());
System.out.println("integers=" + integers);
System.out.println("strings=" + strings);
EnumMap<Type, Integer> counts = new EnumMap<>(Type.class);
AtomicIntegerFieldUpdater<Metric> updater =
AtomicIntegerFieldUpdater.newUpdater(Metric.class, "count");
counts.put(Type.READY, updater.incrementAndGet(metric));
System.out.println("updated=" + counts.get(Type.READY));
System.out.println("declaring enum=" + (Type.READY.getDeclaringClass() == Type.class));
System.out.println("same runtime class=" + Type.class.equals(Type.READY.getClass()));
Object lock = new Object();
synchronized (Main.class) {
System.out.println("class monitor=" + Thread.holdsLock(Main.class));
System.out.println("instance monitor=" + Thread.holdsLock(this));
System.out.println("separate monitor=" + Thread.holdsLock(lock));
}
}
public static void main(String[] args) {
new Main().demo();
}
}Wynik
note=ready metric matches=1 integers=[7] strings=[] updated=1 declaring enum=true same runtime class=false class monitor=true instance monitor=false separate monitor=false
Pusta lista `strings` pokazuje, że `StringBuilder` nie pasuje do `String.class`. Wątek zajmuje tylko monitor klasy spośród trzech sprawdzanych monitorów. Przykład nie testuje współbieżności.
Powiązane lekcje
- Java · Lekcja 13 · Zaawansowany · Wersja: 2
- Java · Lekcja 19 · Zaawansowany · Wersja: 2
- Java · Lekcja 27 · Zaawansowany · Wersja: 2
- Java · Lekcja 28 · Zaawansowany · Wersja: 2
- Java · Lekcja 32 · Zaawansowany · Wersja: 2
- Java · Lekcja 10 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 36 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 37 · Średniozaawansowany · Wersja: 2
Źródła
- Java Language Specification, Java SE 21 — §15.8.2 Class Literals
- Java Language Specification, Java SE 21 — §12.4.1 When Initialization Occurs
- Java Language Specification, Java SE 21 — §12.2 Loading of Classes and Interfaces
- Java Language Specification, Java SE 21 — §8.4.3.6 synchronized Methods
- Class (Java SE 21 & JDK 21)
- Object.getClass() (Java SE 21 & JDK 21)
- Enum.getDeclaringClass() (Java SE 21 & JDK 21)
- EnumMap(Class<K>) (Java SE 21 & JDK 21)
- AtomicIntegerFieldUpdater.newUpdater(Class<U>, String) (Java SE 21 & JDK 21)
- Thread.holdsLock(Object) (Java SE 21 & JDK 21)