CKTIS / Java
Thread.setName — cambiar el nombre de un hilo
Pon nombres como `worker1`, `worker2` y `worker3` a los hilos de trabajo para distinguirlos en los registros y durante la depuración.
Versión: Java SE 21
Sintaxis
public final void setName(String name)
thread.setName("worker1");En Java SE 21, Thread.setName(String name) es un método de instancia de java.lang.Thread. Asigna un nombre a un hilo existente, de plataforma o virtual, y no devuelve ningún valor (void). Puedes llamarlo antes de start() o mientras el hilo se ejecuta. Cambiar el nombre no inicia el hilo ni modifica su prioridad.
getName() lee el nombre en Java. Dentro de un hilo de trabajo, Thread.currentThread().getName() permite leer su propio nombre. Nombres como worker1 facilitan el diagnóstico, pero no tienen por qué ser únicos. En un hilo virtual sin nombre, getName() devuelve una cadena vacía.
null no es un nombre válido y provoca una NullPointerException. El método llama primero a checkAccess() en el hilo cuyo nombre se quiere cambiar. Si un gestor de seguridad instalado deniega el acceso, la llamada falla con una SecurityException.
El nombre en Java no tiene por qué coincidir con el del hilo en el sistema operativo. La implementación de referencia del JDK establece el nombre del sistema cuando un hilo de plataforma cambia su propio nombre y no se ha adjuntado a la máquina virtual mediante la función JNI AttachCurrentThread. No dependas de ese detalle en código portable.
Ejemplos
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();
}
}
}Resultado
worker1 worker2 worker3
Cada hilo de plataforma recibe su nombre antes de `start()` y lo imprime. `join()` espera a que termine antes de iniciar el siguiente, así que el orden de salida no depende de la planificación.
Lecciones relacionadas
- Java · Lección 49 · Intermedio · Versión: 2