Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Thread.setName — mudar o nome de uma thread

Dá nomes como `worker1`, `worker2` e `worker3` às threads de trabalho para as distinguires nos registos e durante a depuração.

Versão: Java SE 21

Sintaxe

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

No Java SE 21, Thread.setName(String name) é um método de instância de java.lang.Thread. Define o nome de uma thread existente, de plataforma ou virtual, e não devolve qualquer valor (void). Podes chamá-lo antes de start() ou enquanto a thread está em execução. Mudar o nome não inicia a thread nem altera a sua prioridade.

getName() lê o nome em Java. Dentro de uma thread de trabalho, Thread.currentThread().getName() lê o nome da própria thread. Nomes como worker1 facilitam o diagnóstico, mas não têm de ser únicos. Numa thread virtual sem nome, getName() devolve uma cadeia de caracteres vazia.

null não é um nome válido e provoca uma NullPointerException. O método chama primeiro checkAccess() na thread cujo nome se pretende mudar. Se um gestor de segurança instalado negar o acesso, a chamada falha com uma SecurityException.

O nome em Java não é necessariamente o nome da thread no sistema operativo. A implementação de referência do JDK define também o nome no sistema operativo quando uma thread de plataforma muda o seu próprio nome e não foi ligada à máquina virtual através da função JNI AttachCurrentThread. Não dependas deste detalhe em código portável.

Exemplos

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 thread de plataforma recebe um nome antes de `start()` e escreve-o na consola. `join()` espera que a thread termine antes de se iniciar a seguinte, pelo que a ordem das linhas não depende do escalonamento.

Lições relacionadas

  • Java · Lição 49 · Intermédio · Versão: 2

Fontes