Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Thread.setName — zmiana nazwy wątku

Nadaj wątkom roboczym nazwy `worker1`, `worker2` i `worker3`, aby łatwiej rozróżniać je w logach i podczas debugowania.

Wersja: Java SE 21

Składnia

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

W Java SE 21 Thread.setName(String name) to metoda instancji klasy java.lang.Thread. Ustawia nazwę istniejącego wątku platformowego lub wirtualnego i niczego nie zwraca (void). Można jej użyć przed wywołaniem start() albo podczas działania wątku. Sama zmiana nazwy nie uruchamia wątku ani nie zmienia jego priorytetu.

getName() odczytuje nazwę po stronie Javy. W kodzie wykonywanym przez wątek Thread.currentThread().getName() odczytuje nazwę właśnie tego wątku. Nazwy takie jak worker1 ułatwiają diagnozowanie problemów, ale nie muszą być unikatowe. Wątek wirtualny bez ustawionej nazwy zwraca z getName() pusty ciąg znaków.

null nie jest prawidłową nazwą: powoduje NullPointerException. Metoda najpierw wywołuje checkAccess() na wątku, którego nazwę zmienia. Jeśli zainstalowany menedżer bezpieczeństwa odmówi dostępu, wywołanie kończy się wyjątkiem SecurityException.

Nazwa w Javie nie musi odpowiadać nazwie wątku w systemie operacyjnym. Implementacja referencyjna JDK ustawia też nazwę systemową, gdy wątek platformowy zmienia własną nazwę i nie został dołączony do maszyny wirtualnej przez funkcję JNI AttachCurrentThread. Nie należy zakładać, że to zachowanie jest przenośne.

Przykłady

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

Wynik

worker1
worker2
worker3

Każdy wątek platformowy otrzymuje nazwę przed `start()` i sam ją wypisuje. `join()` czeka na jego zakończenie przed uruchomieniem następnego, dlatego kolejność wyniku nie zależy od planisty.

Powiązane lekcje

  • Java · Lekcja 49 · Średniozaawansowany · Wersja: 2

Źródła