List icon Conteúdo

Registros

Este guia descreve como configurar os registros do JxBrowser.

A causa raiz de muitos problemas pode ser detectada através da análise das mensagens de log do JxBrowser.

Se você encontrar um problema ou algum comportamento inesperado, por favor configure o JxBrowser para imprimir todas as mensagens de log para um arquivo ou System.err, reproduza o problema, e nos forneça as mensagens de log coletadas.

Por padrão, o JxBrowser é configurado para imprimir todas as mensagens de log com o nível ERROR em System.err.

Níveis

O JxBrowser suporta os seguintes níveis de registo: DEBUG < INFO < WARNING < ERROR. Por padrão, a biblioteca imprime apenas mensagens com nível de registro ERROR, o resto é ignorado.

Utilize o nível OFF para desativar completamente o registo, e o nível ALL para registar todas as mensagens.

É possível alterar o nível de registo predefinido através da propriedade de sistema jxbrowser.logging.level ou da API de registo do JxBrowser.

Exemplo: Definição do nível de registo

Utilize a seguinte propriedade de sistema para ativar o registo DEBUG:

-Djxbrowser.logging.level=DEBUG

Ou configurá-lo no código:

Java
Kotlin
System.setProperty("jxbrowser.logging.level", "DEBUG");
System.setProperty("jxbrowser.logging.level", "DEBUG")

Ou utilizar a API de registo do JxBrowser:

Java
Kotlin
import com.teamdev.jxbrowser.logging.Level;
import com.teamdev.jxbrowser.logging.Logger;
...
Logger.level(Level.DEBUG);
import com.teamdev.jxbrowser.logging.Level
import com.teamdev.jxbrowser.logging.Logger
...
Logger.level(Level.DEBUG)

Registros num arquivo

Para imprimir todas as mensagens de log em um arquivo, utilize a propriedade de sistema jxbrowser.logging.file.

Utilize a seguinte propriedade de sistema para configurar o caminho do arquivo de log:

-Djxbrowser.logging.file=jxbrowser.log

Ou configure-o no código:

Java
Kotlin
System.setProperty("jxbrowser.logging.file", "jxbrowser.log");
System.setProperty("jxbrowser.logging.file", "jxbrowser.log")

O valor da propriedade pode ser um caminho absoluto ou relativo para um arquivo.

Se a biblioteca não puder criar um arquivo de log, ela volta ao comportamento padrão e imprime uma mensagem de erro com o rastreamento da pilha de exceções para System.err.