Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Thread.setName — přejmenování vlákna

Pojmenuj pracovní vlákna například `worker1`, `worker2` a `worker3`, abys je snadno rozlišil v protokolech i při ladění.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 je Thread.setName(String name) instanční metoda třídy java.lang.Thread. Nastavuje název existujícího platformního nebo virtuálního vlákna a nevrací žádnou hodnotu (void). Můžeš ji zavolat před start() nebo za běhu vlákna. Přejmenování vlákno nespustí ani nezmění jeho prioritu.

getName() přečte název vlákna v Javě. V pracovním vlákně použij Thread.currentThread().getName() ke zjištění jeho vlastního názvu. Názvy jako worker1 pomáhají při diagnostice, ale nemusejí být jedinečné. U virtuálního vlákna bez názvu vrací getName() prázdný řetězec.

null není platný název a způsobí výjimku NullPointerException. Metoda nejprve zavolá checkAccess() na cílovém vlákně. Pokud nainstalovaný správce zabezpečení přístup odepře, volání skončí výjimkou SecurityException.

Název v Javě nemusí odpovídat názvu vlákna v operačním systému. Referenční implementace JDK nastaví také systémový název, když se platformní vlákno přejmenuje samo a nebylo připojeno k virtuálnímu stroji funkcí JNI AttachCurrentThread. V přenositelném kódu na toto chování nespoléhej.

Příklady

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();
        }
    }
}

Výsledek

worker1
worker2
worker3

Každé platformní vlákno dostane název před `start()` a samo jej vypíše. `join()` vyčká na jeho ukončení, než se spustí další vlákno. Pořadí výstupu proto nezávisí na plánování.

Související lekce

  • Java · Lekce 49 · Středně pokročilá · Verze: 2

Zdroje