Overview 
Module 
Package 
 Class 
Use 
Tree 
Deprecated 
Index 
Help 
PREV CLASS   NEXT CLASS      All Classes   All Packages
FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | METHOD      DETAIL: FIELD | METHOD
FlexDoc/Javadoc 2.0
Demo Java Doc
java.base / java.lang
Interface System.Logger
Enclosing class:
System
public static interface System.Logger
System.Logger instances log messages that will be routed to the underlying logging framework the LoggerFinder uses. System.Logger instances are typically obtained from the System class, by calling System.getLogger(loggerName) or System.getLogger(loggerName, bundle).
Since:
9
See Also:
System.getLogger(java.lang.String), System.getLogger(java.lang.String, java.util.ResourceBundle), System.LoggerFinder
Nested Class Summary
static enum
System.Logger.Level
System loggers levels.
Method Summary
String
getName()
Returns the name of this logger.
boolean
isLoggable(System.Logger.Level level)
Checks if a message of the given level would be logged by this logger.
default void
log(System.Logger.Level level, Object obj)
Logs a message produced from the given object.
void
log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)
Logs a message with resource bundle and an optional list of parameters.
void
log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)
Logs a localized message associated with a given throwable.
default void
log(System.Logger.Level level, String msg)
Logs a message.
default void
log(System.Logger.Level level, String format, Object... params)
Logs a message with an optional list of parameters.
default void
log(System.Logger.Level level, String msg, Throwable thrown)
Logs a message associated with a given throwable.
default void
log(System.Logger.Level level, Supplier<String> msgSupplier)
Logs a lazily supplied message.
default void
log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)
Logs a lazily supplied message associated with a given throwable.
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 - if level is null.
log
default void log
(System.Logger.Level level,
 String msg)
Logs a message.
Implementation Requirements:
The default implementation for this method calls this.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 a localized logger); can be null.
Throws:
NullPointerException - if level is null.
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 calls this.log(level, (ResourceBundle)null, msgSupplier.get(), (Object[])null);
Parameters:
level - the log message level.
msgSupplier - a supplier function that produces a message.
Throws:
NullPointerException - if level is null, or msgSupplier is null.
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 calls this.log(level, (ResourceBundle)null, obj.toString(), (Object[])null);
Parameters:
level - the log message level.
obj - the object to log.
Throws:
NullPointerException - if level is null, or obj is null.
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 calls this.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 a localized logger); can be null.
thrown - a Throwable associated with the log message; can be null.
Throws:
NullPointerException - if level is null.
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 calls this.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 - a Throwable associated with log message; can be null.
Throws:
NullPointerException - if level is null, or msgSupplier is null.
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 calls this.log(level, (ResourceBundle)null, format, params);
Parameters:
level - one of the log message level identifiers.
format - the string message format in MessageFormat format, (or a key in the message catalog, if this logger is a localized logger); can be null.
params - an optional list of parameters to the message (may be none).
Throws:
NullPointerException - if level is null.
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, the msg string is localized using the given resource bundle. Otherwise the msg string is not localized.
Parameters:
level - the log message level.
bundle - a resource bundle to localize msg; can be null.
msg - the string message (or a key in the message catalog, if bundle is not null); can be null.
thrown - a Throwable associated with the log message; can be null.
Throws:
NullPointerException - if level is null.
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, the format string is localized using the given resource bundle. Otherwise the format string is not localized.
Parameters:
level - the log message level.
bundle - a resource bundle to localize format; can be null.
format - the string message format in MessageFormat format, (or a key in the message catalog if bundle is not null); can be null.
params - an optional list of parameters to the message (may be none).
Throws:
NullPointerException - if level is null.
Overview 
Module 
Package 
 Class 
Use 
Tree 
Deprecated 
Index 
Help 
PREV CLASS   NEXT CLASS      All Classes   All Packages
FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | METHOD      DETAIL: FIELD | METHOD
FlexDoc/Javadoc 2.0
Demo Java Doc
Java API documentation generated with FlexDoc/Javadoc 2.0 using JavadocClassic 3.0 template set.
FlexDoc/Javadoc is a template-driven programming tool for rapid development of any Javadoc-based Java API documentation generators (i.e. doclets). If you need to customize your Javadoc without writing a full-blown doclet from scratch, FlexDoc/Javadoc may be the only tool able to help you! Find out more at www.flexdoc.xyz