SimpleFormatter.Format(LogRecord) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Formate o LogRecord fornecido.
[Android.Runtime.Register("format", "(Ljava/util/logging/LogRecord;)Ljava/lang/String;", "GetFormat_Ljava_util_logging_LogRecord_Handler")]
public override string? Format (Java.Util.Logging.LogRecord? record);
[<Android.Runtime.Register("format", "(Ljava/util/logging/LogRecord;)Ljava/lang/String;", "GetFormat_Ljava_util_logging_LogRecord_Handler")>]
override this.Format : Java.Util.Logging.LogRecord -> string
Parâmetros
- record
- LogRecord
O registro de log a ser formatado.
Retornos
um registro de log formatado
- Atributos
Comentários
Formate o LogRecord fornecido.
A formatação pode ser personalizada especificando a <cadeia de caracteres de formato na propriedade c>java.util.logging.SimpleFormatter.format</c> . O dado LogRecord
será formatado como se chamasse:
{@link String#format String.format}(format, date, source, logger, level, message, thrown);
onde os argumentos são:<br><ol><li>format
- a java.util.Formatter java.util.Formatter
sequência de caracteres de formato especificada na java.util.logging.SimpleFormatter.format
propriedade ou o formato padrão.</li><li>date
- um Date
objeto que representa a hora do evento LogRecord#getMillis do registro de log.</li><li>source
- uma cadeia de caracteres que representa o chamador, se disponível, caso contrário, o nome do registrador.</li><li>logger
- o nome do madeireiro.</li><li>level
- o nível de log Level#getLocalizedName.</li><li>message
- a mensagem de log formatada retornada do Formatter#formatMessage(LogRecord)
método. Ele usa java.text.MessageFormat java.text
formatação e não usa o java.util.Formatter format
argumento.</li><li>thrown
- uma cadeia de caracteres que representa o LogRecord#getThrown throwable associado ao registro de log e seu backtrace começando com um caractere de nova linha, se houver; caso contrário, uma cadeia de caracteres vazia.</li></ol>
Alguns formatos de exemplo:<br><ul><li>java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"
Isso imprime 1 linha com o nível de log (4$
), a mensagem de log (5$
) e o carimbo de data/hora (1$
) em um colchete quadrado.
WARNING: warning message [Tue Mar 22 13:11:31 PDT 2011]
</li><li>java.util.logging.SimpleFormatter.format="%1$tc %2$s%n%4$s: %5$s%6$s%n"
Isso imprime 2 linhas onde a primeira linha inclui o carimbo de data/hora (1$
) e a origem (2$
); a segunda linha inclui o nível de log (4$
) e a mensagem de log (5$
) seguida com o throwable e seu backtrace (6$
), se houver:
Tue Mar 22 13:11:31 PDT 2011 MyClass fatal
SEVERE: several message with an exception
java.lang.IllegalArgumentException: invalid argument
at MyClass.mash(MyClass.java:9)
at MyClass.crunch(MyClass.java:6)
at MyClass.main(MyClass.java:3)
</li><li>java.util.logging.SimpleFormatter.format="%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS %1$Tp %2$s%n%4$s: %5$s%n"
Isso imprime 2 linhas semelhantes ao exemplo acima com uma formatação de data/hora diferente e não imprime o throwable e seu backtrace:
Mar 22, 2011 1:11:31 PM MyClass fatal
SEVERE: several message with an exception
</li></ul>
Esse método também pode ser substituído em uma subclasse. Recomenda-se usar o método de Formatter#formatMessage
conveniência para localizar e formatar o campo de mensagem.
Documentação Java para java.util.logging.SimpleFormatter.format(java.util.logging.LogRecord)
.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.