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