CKTIS / Java
Třídní literály v Javě: `NázevTypu.class`
Literál `.class` poskytuje objekt reprezentující zadaný typ. Lze ho použít k filtrování hodnot, určení typu klíčů mapy `EnumMap`, volbě monitoru nebo vytvoření aktualizátoru pole.
Verze: Java SE 21
Syntaxe
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.classV Java SE 21 výraz NázevTypu.class poskytne objekt Class pro uvedený typ. Nevytváří instanci tohoto typu ani sám nevyvolává jeho inicializaci. Pro přístupný referenční typ C má C.class typ Class<C>; platí to i pro rozhraní a pole. int.class i Integer.class mají typ Class<Integer>, ale reprezentují primitivní typ, respektive obalovou třídu. void.class má typ Class<Void>. V zápisu T.class zastupuje T název typu, ne typovou proměnnou. List<String>.class není povolený; List.class informace o typu prvků neuchovává.
Literál vybírá typ napsaný v kódu. Naproti tomu obj.getClass() vrací skutečnou běhovou třídu objektu a při volání na null vyvolá NullPointerException. Type.class má typ Class<Type> a představuje deklarovaný výčtový typ Type, nikoli jeho konstantu. Konstanta s vlastním tělem třídy má jinou běhovou třídu, ale getDeclaringClass() i tak vrací Type.class. new EnumMap<>(Type.class) vybírá konstruktor prázdné mapy s klíči typu Type; pro výčtový typ Status předej Status.class.
V metodě <T> List<T> select(List<?> values, Class<T> type) předaný token propojuje kontrolu za běhu s typem prvků výsledku. String.class, Integer.class, StringBuilder.class, TextNote.class a Metric.class vybírají postupně String, Integer, StringBuilder, TextNote a Metric. isInstance přijímá kompatibilní objekty jiné než null, včetně instancí podtříd nebo tříd implementujících dané rozhraní. Po kontrole cast vrátí stejnou referenci s typem T; bez kontroly vyvolá nekompatibilní hodnota jiná než null výjimku ClassCastException. Filtrování nepřemění StringBuilder na String.
synchronized (Main.class) uzamkne monitor objektu Class<Main>, stejný jako u metody static synchronized deklarované v Main. Nejde o monitor this ani samostatně vytvořeného objektu lock. Stejnojmenné třídy definované různými zavaděči tříd mohou mít různé monitory. Použij soukromý objekt zámku, pokud vnější kód nemá mít možnost získat stejný monitor.
V AtomicIntegerFieldUpdater.newUpdater(Metric.class, "count") určuje literál třídu deklarující pole a typ instancí pro AtomicIntegerFieldUpdater<Metric>. Název "count" vybírá přístupné instanční pole typu volatile int. Když pole chybí, je nepřístupné nebo nesprávně deklarované, vytvoření aktualizátoru selže. Pro zvýšení hodnoty pole předej konkrétní instanci Metric, nikoli třídní token.
Příklady
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();
}
}Výsledek
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
Prázdný seznam `strings` ukazuje, že `StringBuilder` neodpovídá `String.class`. Ze tří kontrolovaných monitorů vlákno drží pouze monitor třídy. Nejde o test souběhu.
Související lekce
- Java · Lekce 13 · Pokročilá · Verze: 2
- Java · Lekce 19 · Pokročilá · Verze: 2
- Java · Lekce 27 · Pokročilá · Verze: 2
- Java · Lekce 28 · Pokročilá · Verze: 2
- Java · Lekce 32 · Pokročilá · Verze: 2
- Java · Lekce 10 · Středně pokročilá · Verze: 2
- Java · Lekce 36 · Středně pokročilá · Verze: 2
- Java · Lekce 37 · Středně pokročilá · Verze: 2
Zdroje
- 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)