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

Class Formatter

  • 已知直接子类：
    SimpleFormatter ， XMLFormatter 

    public abstract class Formatter
extends Object
    格式化程序提供对LogRecords进行格式化的支持。

    通常每个记录处理程序都将有一个与它相关联的格式化程序。 格式化器采用LogRecord并将其转换为字符串。

    一些格式化器（如XMLFormatter）需要围绕一组格式化的记录包裹头和尾字符串。 getHeader和getTail方法可用于获取这些字符串。

    从以下版本开始：
    1.4

    • 构造方法详细信息

      • Formatter

        protected Formatter​()
        构造一个新的格式化程序

    • 方法详细信息

      • format

        public abstract String format​(LogRecord record)
        格式化给定的日志记录并返回格式化的字符串。

        生成的格式化的字符串通常会包含LogRecord消息字段的本地化和格式化版本。 建议使用formatMessage(java.util.logging.LogRecord)方便的方法来定位和格式化消息字段。

        参数
        record - 要格式化的日志记录。
        结果
        格式化的日志记录

      • getHead

        public String getHead​(Handler h)
        返回一组格式化记录的标题字符串。

        这个基类返回一个空字符串，但这可以被子类覆盖。

        参数
        h - 目标处理程序（可以为null）
        结果
        标题字符串

      • getTail

        public String getTail​(Handler h)
        返回一组格式化记录的尾部字符串。

        这个基类返回一个空字符串，但这可以被子类覆盖。

        参数
        h - 目标处理程序（可以为null）
        结果
        尾弦

      • formatMessage

        public String formatMessage​(LogRecord record)
        从日志记录本地化和格式化消息字符串。 提供此方法作为Formatter子类在执行格式化时使用的方便。

        消息字符串首先使用记录的ResourceBundle本地化为格式字符串。 （如果没有ResourceBundle，或者如果没有找到消息键，则将该键用作格式字符串。）格式String使用java.text样式格式。

        • 如果没有参数，则不使用格式化器。
        • 否则，如果字符串中包含“{<digit>”，其中<digit>在[0-9]中，则使用java.text.MessageFormat格式化该字符串。
        • 否则不执行格式化。
        参数
        record - 包含原始消息的日志记录
        结果
        本地化和格式化的消息