Module  java.logging
软件包  java.util.logging

Class 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格式化程序格式化的整个瞬间。

    为了与旧解析器兼容，可以通过在日志记录配置中指定<xml-formatter-fully-qualified-class-name>.useInstant = false property ，将XMLFormatter配置为恢复为旧格式。 当useInstant为false ，旧格式将被保留。 当useInstant是true （缺省值），该<nanos>元件将被打印和<date>元素将包含formatted瞬间。

    例如，为了配置XMLFormatter的简单实例以省略新的<nano>元素，可以在日志记录配置中指定java.util.logging.XMLFormatter.useInstant = false 。

    从以下版本开始：
    1.4

    • 构造方法详细信息

      • XMLFormatter

        public XMLFormatter​()
        创建一个新的XMLFormatter实例。
        实现要求：
        从JDK 9开始，XMLFormatter将打印出作为Instant的记录event time 。 这个瞬间有系统上可用的最佳分辨率。 <date>元素将包含由DateTimeFormatter.ISO_INSTANT格式化的时刻 。 此外，如果该瞬间含有低于毫秒分辨率的纳秒，则将打印包含纳秒调整的可选<nanos>元素。

        可以关闭此新行为，并通过在logging configuration中指定属性来恢复旧的格式。 如果LogManager.getLogManager().getProperty( this.getClass().getName()+".useInstant")是"false"或"0" ，旧的格式将被恢复。

    • 方法详细信息

      • getHead

        public String getHead​(Handler h)
        返回一组XML格式记录的标题字符串。
        重写：
        getHead在 Formatter
        参数
        h - 目标处理程序（可以为null）
        结果
        一个有效的XML字符串

      • getTail

        public String getTail​(Handler h)
        返回一组XML格式记录的尾字符串。
        重写：
        getTail在 Formatter
        参数
        h - 目标处理程序（可以为null）
        结果
        一个有效的XML字符串