Interface System.Logger

Enclosing class:
System
public static interfaceSystem.Logger
System.Logger instances log messages that will be routed to the underlying logging framework theLoggerFinder uses.System.Logger instances are typically obtained from theSystem class, by callingSystem.getLogger(loggerName) orSystem.getLogger(loggerName, bundle).
Since:
9
See Also:

  • Method Details

    • 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.