模块  java.base
软件包  java.lang

Interface System.Logger

    • 方法详细信息

      • getName

        String getName()
        返回此记录器的名称。
        结果
        记录器名称。

      • isLoggable

        boolean isLoggable​(System.Logger.Level level)
        检查此记录器是否记录了给定级别的消息。
        参数
        level - 日志消息级别。
        结果
        true如果当前正在记录给定的日志消息级别。
        异常
        NullPointerException - 如果 level是 null 。

      • log

        default void log​(System.Logger.Level level,                 String msg)
        记录消息。
        实现要求：
        此方法的默认实现调用 this.log(level, (ResourceBundle)null, msg, (Object[])null);
        参数
        level - 日志消息级别。
        msg - 字符串消息（或消息目录中的密钥，如果此记录器是localized logger ）; 可以是null 。
        异常
        NullPointerException - 如果 level是 null 。

      • log

        default void log​(System.Logger.Level level,                 Supplier<String> msgSupplier)
        记录延迟提供的消息。 如果当前为给定的日志消息级别启用了记录器，则会记录一条消息，该消息是给定供应商函数生成的结果。 否则，供应商不会被操作。
        实现要求：
        为给定级别启用日志记录时，此方法的默认实现调用 this.log(level, (ResourceBundle)null, msgSupplier.get(), (Object[])null);
        参数
        level - 日志消息级别。
        msgSupplier - 生成消息的供应商函数。
        异常
        NullPointerException - 如果 level是 null ，或 msgSupplier是 null 。

      • log

        default void log​(System.Logger.Level level,                 Object obj)
        记录从给定对象生成的消息。 如果当前为给定的日志消息级别启用了记录器，则会记录一条消息，默认情况下，该消息是在给定对象上调用toString产生的结果。 否则，对象不会被操作。
        实现要求：
        为给定级别启用日志记录时，此方法的默认实现调用 this.log(level, (ResourceBundle)null, obj.toString(), (Object[])null);
        参数
        level - 日志消息级别。
        obj - 要记录的对象。
        异常
        NullPointerException - 如果 level是 null ，或 obj是 null 。

      • log

        default void log​(System.Logger.Level level,                 String msg,                 Throwable thrown)
        记录与给定throwable关联的消息。
        实现要求：
        此方法的默认实现调用 this.log(level, (ResourceBundle)null, msg, thrown);
        参数
        level - 日志消息级别。
        msg - 字符串消息（或消息目录中的密钥，如果此记录器是localized logger ）; 可以是null 。
        thrown - 与日志消息相关联的Throwable ; 可以是null 。
        异常
        NullPointerException - 如果 level是 null 。

      • log

        default void log​(System.Logger.Level level,                 Supplier<String> msgSupplier,                 Throwable thrown)
        记录与给定throwable关联的延迟提供的消息。 如果当前为给定的日志消息级别启用了记录器，则会记录一条消息，该消息是给定供应商函数生成的结果。 否则，供应商不会被操作。
        实现要求：
        为给定级别启用日志记录时，此方法的默认实现调用 this.log(level, (ResourceBundle)null, msgSupplier.get(), thrown);
        参数
        level - 日志消息级别标识符之一。
        msgSupplier - 生成消息的供应商函数。
        thrown - 与日志消息关联的Throwable ; 可以是null 。
        异常
        NullPointerException - 如果 level是 null ，或 msgSupplier是 null 。

      • log

        default void log​(System.Logger.Level level,                 String format,                 Object... params)
        使用可选的参数列表记录消息。
        实现要求：
        此方法的默认实现调用 this.log(level, (ResourceBundle)null, format, params);
        参数
        level - 日志消息级别标识符之一。
        format - MessageFormat格式的字符串消息格式，（或消息目录中的密钥，如果此记录器是localized logger ）; 可以是null 。
        params - 消息的可选参数列表（可以是none）。
        异常
        NullPointerException - 如果 level是 null 。

      • log

        void log​(System.Logger.Level level,         ResourceBundle bundle,         String msg,         Throwable thrown)
        记录与给定throwable关联的本地化消息。 如果给定资源包是非null ，则使用给定资源包对msg字符串进行本地化。 否则msg字符串未本地化。
        参数
        level - 日志消息级别。
        bundle - 要本地化的资源包msg ; 可以是null 。
        msg - 字符串消息（或消息目录中的密钥，如果bundle不是null ）; 可以是null 。
        thrown - 与日志消息关联的Throwable ; 可以是null 。
        异常
        NullPointerException - 如果 level是 null 。

      • log

        void log​(System.Logger.Level level,         ResourceBundle bundle,         String format,         Object... params)
        使用资源包和可选的参数列表记录消息。 如果给定资源包是非null ，则使用给定资源包来本地化format字符串。 否则format字符串未本地化。
        参数
        level - 日志消息级别。
        bundle - 要本地化的资源包format ; 可以是null 。
        format - MessageFormat格式的字符串消息格式，（如果bundle不是null消息目录中的密钥）; 可以是null 。
        params - 消息的可选参数列表（可以是none）。
        异常
        NullPointerException - 如果 level是 null 。