Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Thread.setName — renommer un thread

Nommez les threads de travail `worker1`, `worker2` et `worker3` pour les distinguer dans les journaux et pendant le débogage.

Version : Java SE 21

Syntaxe

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

Dans Java SE 21, Thread.setName(String name) est une méthode d’instance de java.lang.Thread. Elle définit le nom d’un thread existant, de plateforme ou virtuel, et ne renvoie rien (void). Appelez-la avant start() ou pendant l’exécution du thread. Le renommage ne démarre pas le thread et ne change pas sa priorité.

getName() lit le nom côté Java. Dans le code du thread de travail, Thread.currentThread().getName() permet de lire son propre nom. Des noms comme worker1 facilitent le diagnostic, mais n’ont pas besoin d’être uniques. Pour un thread virtuel sans nom, getName() renvoie une chaîne vide.

null n’est pas un nom valide et provoque une NullPointerException. La méthode appelle d’abord checkAccess() sur le thread cible. Si un gestionnaire de sécurité installé refuse l’accès, l’appel échoue avec une SecurityException.

Le nom Java n’est pas nécessairement celui du thread dans le système d’exploitation. L’implémentation de référence du JDK définit aussi le nom système lorsqu’un thread de plateforme se renomme lui-même et n’a pas été rattaché à la machine virtuelle via la fonction JNI AttachCurrentThread. Ne comptez pas sur ce détail dans du code portable.

Exemples

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

Résultat

worker1
worker2
worker3

Chaque thread de plateforme reçoit son nom avant `start()` et l’affiche lui-même. `join()` attend sa fin avant le démarrage du suivant : l’ordre d’affichage ne dépend donc pas de l’ordonnancement.

Leçons associées

  • Java · Leçon 49 · Intermédiaire · Version : 2

Sources