Module java.base
Package java.lang

Interface System.Logger

    • Method Detail

      • getName

        String getName()
        Returns the name of this logger.
        Returns:
        the logger name.

      • isLoggable

        boolean isLoggable​(System.Logger.Level level)
        Checks if a message of the given level would be logged by this logger.
        Parameters:
        level - the log message level.
        Returns:
        true if the given log message level is currently being logged.
        Throws:
        NullPointerException - iflevel isnull.

      • log

        default void log​(System.Logger.Level level,String msg)
        Logs a message.
        Implementation Requirements:
        The default implementation for this method callsthis.log(level, (ResourceBundle)null, msg, (Object[])null);
        Parameters:
        level - the log message level.
        msg - the string message (or a key in the message catalog, if this logger is alocalized logger); can benull.
        Throws:
        NullPointerException - iflevel isnull.

      • log

        default void log​(System.Logger.Level level,Supplier<String> msgSupplier)
        Logs a lazily supplied message. If the logger is currently enabled for the given log message level then a message is logged that is the result produced by the given supplier function. Otherwise, the supplier is not operated on.
        Implementation Requirements:
        When logging is enabled for the given level, the default implementation for this method callsthis.log(level, (ResourceBundle)null, msgSupplier.get(), (Object[])null);
        Parameters:
        level - the log message level.
        msgSupplier - a supplier function that produces a message.
        Throws:
        NullPointerException - iflevel isnull, ormsgSupplier isnull.

      • log

        default void log​(System.Logger.Level level,Object obj)
        Logs a message produced from the given object. If the logger is currently enabled for the given log message level then a message is logged that, by default, is the result produced from calling toString on the given object. Otherwise, the object is not operated on.
        Implementation Requirements:
        When logging is enabled for the given level, the default implementation for this method callsthis.log(level, (ResourceBundle)null, obj.toString(), (Object[])null);
        Parameters:
        level - the log message level.
        obj - the object to log.
        Throws:
        NullPointerException - iflevel isnull, orobj isnull.

      • log

        default void log​(System.Logger.Level level,String msg,Throwable thrown)
        Logs a message associated with a given throwable.
        Implementation Requirements:
        The default implementation for this method callsthis.log(level, (ResourceBundle)null, msg, thrown);
        Parameters:
        level - the log message level.
        msg - the string message (or a key in the message catalog, if this logger is alocalized logger); can benull.
        thrown - aThrowable associated with the log message; can benull.
        Throws:
        NullPointerException - iflevel isnull.

      • log

        default void log​(System.Logger.Level level,Supplier<String> msgSupplier,Throwable thrown)
        Logs a lazily supplied message associated with a given throwable. If the logger is currently enabled for the given log message level then a message is logged that is the result produced by the given supplier function. Otherwise, the supplier is not operated on.
        Implementation Requirements:
        When logging is enabled for the given level, the default implementation for this method callsthis.log(level, (ResourceBundle)null, msgSupplier.get(), thrown);
        Parameters:
        level - one of the log message level identifiers.
        msgSupplier - a supplier function that produces a message.
        thrown - aThrowable associated with log message; can benull.
        Throws:
        NullPointerException - iflevel isnull, ormsgSupplier isnull.

      • log

        default void log​(System.Logger.Level level,String format,Object... params)
        Logs a message with an optional list of parameters.
        Implementation Requirements:
        The default implementation for this method callsthis.log(level, (ResourceBundle)null, format, params);
        Parameters:
        level - one of the log message level identifiers.
        format - the string message format inMessageFormat format, (or a key in the message catalog, if this logger is alocalized logger); can benull.
        params - an optional list of parameters to the message (may be none).
        Throws:
        NullPointerException - iflevel isnull.

      • log

        void log​(System.Logger.Level level,ResourceBundle bundle,String msg,Throwable thrown)
        Logs a localized message associated with a given throwable. If the given resource bundle is non-null, themsg string is localized using the given resource bundle. Otherwise themsg string is not localized.
        Parameters:
        level - the log message level.
        bundle - a resource bundle to localizemsg; can benull.
        msg - the string message (or a key in the message catalog, ifbundle is notnull); can benull.
        thrown - aThrowable associated with the log message; can benull.
        Throws:
        NullPointerException - iflevel isnull.

      • log

        void log​(System.Logger.Level level,ResourceBundle bundle,String format,Object... params)
        Logs a message with resource bundle and an optional list of parameters. If the given resource bundle is non-null, theformat string is localized using the given resource bundle. Otherwise theformat string is not localized.
        Parameters:
        level - the log message level.
        bundle - a resource bundle to localizeformat; can benull.
        format - the string message format inMessageFormat format, (or a key in the message catalog ifbundle is notnull); can benull.
        params - an optional list of parameters to the message (may be none).
        Throws:
        NullPointerException - iflevel isnull.