Partilhar via


SimpleFormatter.Format(LogRecord) Método

Definição

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.

Aplica-se a