play

Class Logger

java.lang.Object

play.Logger

public class Logger
extends java.lang.Object

High level API for logging operations.

Example, logging with the default application logger:

 Logger.info("Hello!");

Example, logging with a custom logger:

 Logger.of("my.logger").info("Hello!")

Each of the logging methods is overloaded to be able to take an array of arguments. These are formatted into the message String, replacing occurrences of '{}'. For example:

 Logger.info("A {} request was received at {}", request.method(), request.uri());
 

This might print out:

 A POST request was received at /api/items
 

This saves on the cost of String construction when logging is turned off.

This API is intended as a simple logging API to meet 99% percent of the most common logging needs with minimal code overhead. For more complex needs, the underlying() methods may be used to get the underlying SLF4J logger, or SLF4J may be used directly.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Logger.ALogger Typical logger interface

Constructor Summary

Constructors

Constructor and Description
Logger()

Method Summary

Modifier and Type	Method and Description
static void	debug(java.lang.String message) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	debug(java.lang.String message, java.lang.Object... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	debug(java.lang.String message, java.util.function.Supplier<?>... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	debug(java.lang.String message, java.lang.Throwable error) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	debug(java.util.function.Supplier<java.lang.String> msgSupplier) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	error(java.lang.String message) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	error(java.lang.String message, java.lang.Object... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	error(java.lang.String message, java.util.function.Supplier<?> args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	error(java.lang.String message, java.lang.Throwable error) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	error(java.util.function.Supplier<java.lang.String> msgSupplier) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	info(java.lang.String message) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	info(java.lang.String message, java.lang.Object... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	info(java.lang.String message, java.util.function.Supplier<?>... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	info(java.lang.String message, java.lang.Throwable error) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	info(java.util.function.Supplier<java.lang.String> msgSupplier) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static boolean	isDebugEnabled() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static boolean	isErrorEnabled() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static boolean	isInfoEnabled() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static boolean	isTraceEnabled() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static boolean	isWarnEnabled() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static Logger.ALogger	of(java.lang.Class<?> clazz) Obtain a logger instance.
static Logger.ALogger	of(java.lang.String name) Obtain a logger instance.
static void	trace(java.lang.String message) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	trace(java.lang.String message, java.lang.Object... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	trace(java.lang.String message, java.util.function.Supplier<?>... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	trace(java.lang.String message, java.lang.Throwable error) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	trace(java.util.function.Supplier<java.lang.String> msgSupplier) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static org.slf4j.Logger	underlying() Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	warn(java.lang.String message) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	warn(java.lang.String message, java.lang.Object... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	warn(java.lang.String message, java.util.function.Supplier<?>... args) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	warn(java.lang.String message, java.lang.Throwable error) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.
static void	warn(java.util.function.Supplier<java.lang.String> msgSupplier) Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Logger

public Logger()

Method Detail

of

public static Logger.ALogger of(java.lang.String name)

Obtain a logger instance.

Parameters:

name - name of the logger

Returns:

a logger

of

public static Logger.ALogger of(java.lang.Class<?> clazz)

Obtain a logger instance.

Parameters:

clazz - a class whose name will be used as logger name

Returns:

a logger

underlying

@Deprecated
public static org.slf4j.Logger underlying()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Get the underlying application SLF4J logger.

Returns:

the underlying logger

isTraceEnabled

@Deprecated
public static boolean isTraceEnabled()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Returns true if the logger instance enabled for the TRACE level?

Returns:

true if the logger instance enabled for the TRACE level?

isDebugEnabled

@Deprecated
public static boolean isDebugEnabled()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Returns true if the logger instance enabled for the DEBUG level?

Returns:

true if the logger instance enabled for the DEBUG level?

isInfoEnabled

@Deprecated
public static boolean isInfoEnabled()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Returns true if the logger instance enabled for the INFO level?

Returns:

true if the logger instance enabled for the INFO level?

isWarnEnabled

@Deprecated
public static boolean isWarnEnabled()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Returns true if the logger instance enabled for the WARN level?

Returns:

true if the logger instance enabled for the WARN level?

isErrorEnabled

@Deprecated
public static boolean isErrorEnabled()

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Returns true if the logger instance enabled for the ERROR level?

Returns:

true if the logger instance enabled for the ERROR level?

trace

@Deprecated
public static void trace(java.lang.String message)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the TRACE level.

Parameters:

message - message to log

trace

@Deprecated
public static void trace(java.util.function.Supplier<java.lang.String> msgSupplier)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the TRACE level.

Parameters:

msgSupplier - Supplier that contains message to log

trace

@Deprecated
public static void trace(java.lang.String message,
                                     java.lang.Object... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the TRACE level.

Parameters:

message - message to log

args - The arguments to apply to the message String

trace

@Deprecated
public static void trace(java.lang.String message,
                                     java.util.function.Supplier<?>... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the TRACE level.

Parameters:

message - message to log

args - Suppliers that contain arguments to apply to the message String

trace

@Deprecated
public static void trace(java.lang.String message,
                                     java.lang.Throwable error)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the TRACE level.

Parameters:

message - message to log

error - associated exception

debug

@Deprecated
public static void debug(java.lang.String message)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the DEBUG level.

Parameters:

message - message to log

debug

@Deprecated
public static void debug(java.util.function.Supplier<java.lang.String> msgSupplier)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the DEBUG level.

Parameters:

msgSupplier - Supplier that contains message to log

debug

@Deprecated
public static void debug(java.lang.String message,
                                     java.lang.Object... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the DEBUG level.

Parameters:

message - message to log

args - The arguments to apply to the message String

debug

@Deprecated
public static void debug(java.lang.String message,
                                     java.util.function.Supplier<?>... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the DEBUG level.

Parameters:

message - message to log

args - Suppliers that contain arguments to apply to the message String

debug

@Deprecated
public static void debug(java.lang.String message,
                                     java.lang.Throwable error)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the DEBUG level.

Parameters:

message - message to log

error - associated exception

info

@Deprecated
public static void info(java.lang.String message)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the INFO level.

Parameters:

message - message to log

info

@Deprecated
public static void info(java.util.function.Supplier<java.lang.String> msgSupplier)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the INFO level.

Parameters:

msgSupplier - Supplier that contains message to log

info

@Deprecated
public static void info(java.lang.String message,
                                    java.lang.Object... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the INFO level.

Parameters:

message - message to log

args - The arguments to apply to the message string

info

@Deprecated
public static void info(java.lang.String message,
                                    java.util.function.Supplier<?>... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the INFO level.

Parameters:

message - message to log

args - Suppliers that contain arguments to apply to the message String

info

@Deprecated
public static void info(java.lang.String message,
                                    java.lang.Throwable error)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the INFO level.

Parameters:

message - message to log

error - associated exception

warn

@Deprecated
public static void warn(java.lang.String message)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the WARN level.

Parameters:

message - message to log

warn

@Deprecated
public static void warn(java.util.function.Supplier<java.lang.String> msgSupplier)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the WARN level.

Parameters:

msgSupplier - Supplier that contains message to log

warn

@Deprecated
public static void warn(java.lang.String message,
                                    java.lang.Object... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the WARN level.

Parameters:

message - message to log

args - The arguments to apply to the message string

warn

@Deprecated
public static void warn(java.lang.String message,
                                    java.util.function.Supplier<?>... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the WARN level.

Parameters:

message - message to log

args - Suppliers that contain arguments to apply to the message String

warn

@Deprecated
public static void warn(java.lang.String message,
                                    java.lang.Throwable error)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the WARN level.

Parameters:

message - message to log

error - associated exception

error

@Deprecated
public static void error(java.lang.String message)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the ERROR level.

Parameters:

message - message to log

error

@Deprecated
public static void error(java.util.function.Supplier<java.lang.String> msgSupplier)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the ERROR level.

Parameters:

msgSupplier - Supplier that contains message to log

error

@Deprecated
public static void error(java.lang.String message,
                                     java.lang.Object... args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the ERROR level.

Parameters:

message - message to log

args - The arguments to apply to the message string

error

@Deprecated
public static void error(java.lang.String message,
                                     java.util.function.Supplier<?> args)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the ERROR level.

Parameters:

message - message to log

args - Suppliers that contain arguments to apply to the message String

error

@Deprecated
public static void error(java.lang.String message,
                                     java.lang.Throwable error)

Deprecated. Deprecated as of 2.7.0. Create an instance of Logger.ALogger via of(String) / of(Class) and use the same-named method. Or use SLF4J directly.

Log a message with the ERROR level.

Parameters:

message - message to log

error - associated exception