Faça logon com o SDK do Azure para Java e java.util.logging

Artigo
01/20/2025

Este artigo fornece uma visão geral de como adicionar log usando java.util.logging a aplicativos que usam o SDK do Azure para Java. A estrutura java.util.logging faz parte do JDK. Conforme mencionado em Configurar o registo no SDK do Azure para Java, todas as bibliotecas de cliente do Azure fazem registo através do SLF4J, para que poderá utilizar frameworks de registo, como java.util.logging.

Para habilitar java.util.logging, você deve fazer duas coisas:

Inclua o adaptador SLF4J para java.util.logging como dependência.
Crie um ficheiro chamado logging.properties no diretório do projeto /src/main/resources.

Para obter mais informações relacionadas à configuração do registrador, consulte Configurando a saída de log na documentação do Oracle.

Adicionar a dependência do Maven

Para adicionar a dependência Maven, inclua o seguinte XML no arquivo pom.xml do projeto. Substitua o número da versão 1.7.30 pelo número da versão mais recente apresentado na página de Binding SLF4J JDK14 .

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.30</version> <!-- replace this version with the latest available version on Maven central -->
</dependency>

Adicionar o ficheiro logging.properties ao seu projeto

Para registar usando java.util.logging, crie um ficheiro chamado logging.properties no diretório ./src/main/resources do seu projeto ou em qualquer outro lugar. Esse arquivo conterá as configurações de log para personalizar suas necessidades de registro. Forneça o caminho para o arquivo definindo a propriedade java.util.logging.config.file system. Você deve definir essa propriedade antes de criar a instância do logger. Para obter mais informações, consulte Java Logging: Configuration.

Registo da consola

Você pode criar uma configuração para fazer logon no console, conforme mostrado no exemplo a seguir. Este exemplo é configurado para registrar todos os eventos de log de nível INFO ou superior, de onde quer que venham.

handlers = java.util.logging.ConsoleHandler
.level = INFO

java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=[%1$tF %1$tH:%1$tM:%1$tS.%1$tL] [%4$s] %3$s %5$s %n

Registar num ficheiro

O exemplo anterior regista na consola, que normalmente não é o local preferido para registos. Para configurar o registo num ficheiro, use a seguinte configuração:

handlers = java.util.logging.FileHandler
.level = INFO

java.util.logging.FileHandler.pattern = %h/myapplication.log
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.level = INFO

Este código irá criar um ficheiro chamado myapplication.log no seu diretório pessoal (%h). Este registador não suporta a rotação automática de ficheiros após um determinado período. Se você precisar dessa funcionalidade, precisará escrever um agendador para gerenciar a rotação do arquivo de log.

Próximos passos

Este artigo abordou a configuração do java.util.logging e como fazer com que o SDK do Azure para Java o use para registro. Como o SDK do Azure para Java funciona com todas as estruturas de log SLF4J, considere revisar o manual do usuário SLF4J para obter mais detalhes.

Depois de dominar o registo, considere examinar as integrações que o Azure oferece em estruturas como Spring e MicroProfile.

Partilhar via