KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Thread.setName — een thread hernoemen

Geef workerthreads namen zoals `worker1`, `worker2` en `worker3` om ze in logboeken en tijdens het debuggen uit elkaar te houden.

Versie: Java SE 21

Syntax

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

In Java SE 21 is Thread.setName(String name) een instantiemethode van java.lang.Thread. De methode stelt de naam van een bestaande platformthread of virtuele thread in en geeft geen waarde terug (void). Je kunt de methode vóór start() aanroepen of terwijl de thread draait. Hernoemen start de thread niet en verandert de prioriteit niet.

Met getName() lees je de naam in Java. Binnen een workerthread lees je met Thread.currentThread().getName() de eigen naam van die thread. Namen zoals worker1 helpen bij het opsporen van problemen, maar hoeven niet uniek te zijn. Bij een virtuele thread zonder naam geeft getName() een lege tekenreeks terug.

null is geen geldige naam en veroorzaakt een NullPointerException. De methode roept eerst checkAccess() aan op de thread die je wilt hernoemen. Als een geïnstalleerde securitymanager de toegang weigert, mislukt de aanroep met een SecurityException.

De Java-naam is niet noodzakelijk de threadnaam in het besturingssysteem. De JDK-referentie-implementatie stelt de naam in het besturingssysteem ook in wanneer een platformthread zichzelf hernoemt en niet via de JNI-functie AttachCurrentThread aan de virtuele machine is gekoppeld. Vertrouw in overdraagbare code niet op dit implementatiedetail.

Voorbeelden

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

Resultaat

worker1
worker2
worker3

Elke platformthread krijgt vóór `start()` een naam en drukt die zelf af. `join()` wacht tot die thread klaar is voordat de volgende worker start. Daardoor hangt de uitvoervolgorde niet af van de planning.

Gerelateerde lessen

  • Java · Les 49 · Gemiddeld · Versie: 2

Bronnen