WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Thread.setName — einen Thread umbenennen

Gib Worker-Threads Namen wie `worker1`, `worker2` und `worker3`, damit du sie in Protokollen und bei der Fehlersuche auseinanderhalten kannst.

Version: Java SE 21

Syntax

public final void setName(String name)
thread.setName("worker1");

In Java SE 21 ist Thread.setName(String name) eine Instanzmethode von java.lang.Thread. Sie setzt den Namen eines vorhandenen Plattform- oder virtuellen Threads und gibt keinen Wert zurück (void). Du kannst sie vor start() oder während der Ausführung des Threads aufrufen. Die Umbenennung startet den Thread nicht und ändert seine Priorität nicht.

getName() liest den Java-Namen. Mit Thread.currentThread().getName() liest ein Worker seinen eigenen Namen. Namen wie worker1 helfen bei der Fehlersuche, müssen aber nicht eindeutig sein. Bei einem unbenannten virtuellen Thread liefert getName() einen leeren String.

null ist kein gültiger Name und führt zu einer NullPointerException. Die Methode ruft zuerst checkAccess() auf dem Zielthread auf. Verweigert ein installierter Security Manager den Zugriff, schlägt der Aufruf mit einer SecurityException fehl.

Der Java-Name ist nicht unbedingt auch der Threadname im Betriebssystem. Die JDK-Referenzimplementierung setzt den Betriebssystemnamen, wenn sich ein Plattform-Thread selbst umbenennt und nicht über die JNI-Funktion AttachCurrentThread an die VM angebunden wurde. Verlasse dich in portablem Code nicht darauf.

Beispiele

public class WorkerNames {
    public static void main(String[] args) throws InterruptedException {
        for (int i = 1; i <= 3; i++) {
            Thread worker = new Thread(() ->
                System.out.println(Thread.currentThread().getName())
            );
            worker.setName("worker" + i);
            worker.start();
            worker.join();
        }
    }
}

Ergebnis

worker1
worker2
worker3

Jeder Plattform-Thread erhält seinen Namen vor `start()` und gibt ihn selbst aus. `join()` wartet auf sein Ende, bevor der nächste Worker startet. Die Ausgabereihenfolge hängt daher nicht vom Scheduler ab.

Zugehörige Lektionen

  • Java · Lektion 49 · Mittlere Stufe · Version: 2

Quellen