- java.lang.Object
-
- java.util.logging.Formatter
-
- java.util.logging.XMLFormatter
-
public class XMLFormatter extends Formatter
将LogRecord格式化为标准XML格式。DTD规范作为Java Logging API规范的附录A提供。
XMLFormatter可以与任意字符编码一起使用,但建议它通常与UTF-8一起使用。 可以在输出处理程序上设置字符编码。
- 实现要求:
-
从JDK 9开始, LogRecord的实例包含
Instant
,其可以具有低于毫秒分辨率的纳秒。 DTD规范已更新,允许使用可选的<nanos>
元素。 默认情况下,XMLFormatter将计算低于毫秒分辨率的纳秒调整(使用LogRecord.getInstant().getNano() % 1000_000
) - 如果不是0,则此调整值将打印在新的<nanos>
元素中。 然后可以使用Instant.ofEpochSecond(millis/1000L, (millis % 1000L) * 1000_000L + nanos)
重建事件瞬间,其中millis
和nanos
表示在<millis>
和<nanos>
元素中序列化的数字。
<date>
元素现在将包含由DateTimeFormatter.ISO_INSTANT
格式化程序格式化的整个瞬间。为了与旧解析器兼容,可以将XMLFormatters配置为通过在日志记录配置中指定
<xml-formatter-fully-qualified-class-name>.useInstant = false
property来恢复为旧格式。 当useInstant
是false
,将保留旧格式。 当useInstant
是true
(缺省值),该<nanos>
元件将被打印和<date>
元素将包含formatted瞬间。例如,为了配置XMLFormatter的普通实例以省略新的
<nano>
元素,可以在日志记录配置中指定java.util.logging.XMLFormatter.useInstant = false
。 - 从以下版本开始:
- 1.4
-
-
构造方法详细信息
-
XMLFormatter
public XMLFormatter()
创建XMLFormatter的新实例。- 实现要求:
-
从JDK 9开始,XMLFormatter将打印出记录event time作为Instant。
此瞬间具有系统上可用的最佳分辨率。
<date>
元素将包含由DateTimeFormatter.ISO_INSTANT
格式化的瞬间 。 此外,如果瞬间包含低于毫秒分辨率的纳秒,则将打印包含纳秒调整的可选<nanos>
元素。通过在logging configuration中指定属性,可以关闭此新行为,并恢复旧格式。 如果
LogManager.getLogManager().getProperty( this.getClass().getName()+".useInstant")
是"false"
或"0"
,将恢复旧格式。
-
-
方法详细信息
-
format
public String format(LogRecord record)
将给定消息格式化为XML。可以在子类中重写此方法。 建议使用
Formatter.formatMessage(java.util.logging.LogRecord)
便捷方法来本地化和格式化消息字段。
-
-