SimpleFormatter.Format(LogRecord) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Dé formato al objeto LogRecord especificado.
[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
registro al que se va a dar formato.
Devoluciones
un registro con formato
- Atributos
Comentarios
Dé formato al objeto LogRecord especificado.
El formato se puede personalizar especificando la cadena de formato en la <propiedad c>java.util.logging.SimpleFormatter.format</c> . El elemento especificado LogRecord
tendrá formato como si llamara a:
{@link String#format String.format}(format, date, source, logger, level, message, thrown);
donde los argumentos son:br><ol><li>format
:< la java.util.Formatter java.util.Formatter
cadena de formato especificada en la java.util.logging.SimpleFormatter.format
propiedad o el formato predeterminado.</li li>date
<>: un Date
objeto que representa la hora del evento LogRecord#getMillis del registro.</li li>source
<>: una cadena que representa al autor de la llamada, si está disponible; de lo contrario, el nombre del registrador.</li li>logger
<>: el nombre del registrador.</li li>level
<>: el nivel de registro Level#getLocalizedName.</li li>message
<>: el mensaje de registro con formato devuelto por el Formatter#formatMessage(LogRecord)
método . Usa java.text.MessageFormat java.text
formato y no usa el java.util.Formatter format
argumento .</li><li>thrown
: una cadena que representa el objeto LogRecord#getThrown que se puede producir asociado al registro de registro y su retroceso comenzando con un carácter de nueva línea, si existe; de lo contrario, una cadena vacía.</li></ol>
Algunos formatos de ejemplo:<br><ul><li>java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"
Esto imprime 1 línea con el nivel de registro (4$
), el mensaje de registro (5$
) y la marca de tiempo (1$
) en un corchete cuadrado.
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"
Esto imprime 2 líneas en las que la primera línea incluye la marca de tiempo () y el origen (1$
2$
); la segunda línea incluye el nivel de registro (4$
) y el mensaje de registro (5$
) seguido de la excepción throwable y su retroceso (6$
), si existe:
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"
Esto imprime 2 líneas similares al ejemplo anterior con un formato de fecha y hora diferente y no imprime el elemento throwable y su retroceso:
Mar 22, 2011 1:11:31 PM MyClass fatal
SEVERE: several message with an exception
</li></ul>
Este método también se puede invalidar en una subclase. Se recomienda usar el Formatter#formatMessage
método de conveniencia para localizar y dar formato al campo de mensaje.
Documentación de Java para java.util.logging.SimpleFormatter.format(java.util.logging.LogRecord)
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.