eu.davidea.flexibleadapter.utils

Class Logger

java.lang.Object

eu.davidea.flexibleadapter.utils.Logger

public class Logger
extends java.lang.Object

Utility class that simplifies the use of Log by improving the call to all log methods by supplying arguments as parameters instead of creating a string. This avoids useless memory allocations when not requested: the StringBuilder itself, the buffer and the String object. The new methods check in advance if the level is enabled and only after the string message with arguments is created.

Note: This class has best usage with Log.

Classical usage:

 if (BuildConfig.DEBUG) {
     Log.setLevel(Level.INFO);
 } else {
     Log.setLevel(Level.SUPPRESS);
 }
 Logger logger = new Logger("MyNewTag");
 

Advanced usage:

The Logger constructor will reset the Log.customTag to null!
So at the next static call of Log.v/d/i/w/e(...); it will log the current filename as tag.

 public class MyClass {
     private Logger logger;

     public MyClass() {
         if (Log.customTag == null) Log.useTag("MyClass");
         this.logger = new Logger(Log.customTag);
         ...
     }

     public static void useTag(String tag) {
         Log.useTag(tag);
     }
 }

 // Usage
 MyClass.useTag("MyNewSmartTag");
 MyClass myClass = new MyClass();
 

Since:

02/09/2017

See Also:

Log

Constructor Summary

Constructors

Constructor and Description
Logger(java.lang.String tag)

Method Summary

Modifier and Type	Method and Description
void	d(java.lang.String msg, java.lang.Object... args) Sends a Log.Level.DEBUG log message.
void	e(java.lang.String msg, java.lang.Object... args) Sends an Log.Level.ERROR log message.
void	e(java.lang.Throwable t, java.lang.String msg, java.lang.Object... args) Sends an Log.Level.ERROR log message with the Exception at the end of the message.
void	i(java.lang.String msg, java.lang.Object... args) Sends an Log.Level.INFO log message.
void	v(java.lang.String msg, java.lang.Object... args) Sends a Log.Level.VERBOSE log message.
void	w(java.lang.String msg, java.lang.Object... args) Sends a Log.Level.WARN log message.
void	w(java.lang.Throwable t, java.lang.String msg, java.lang.Object... args) Sends a Log.Level.WARN log message with the Exception at the end of the message.
void	wtf(java.lang.String msg, java.lang.Object... args) What a Terrible Failure: Report a condition that should never happen.
void	wtf(java.lang.Throwable t, java.lang.String msg, java.lang.Object... args) What a Terrible Failure: Report a condition that should never happen with the Exception at the end of the message.

Methods inherited from class java.lang.Object

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

Constructor Detail

Logger

public Logger(java.lang.String tag)

Method Detail

v

public void v(java.lang.String msg,
              java.lang.Object... args)

Sends a Log.Level.VERBOSE log message.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

d

public void d(java.lang.String msg,
              java.lang.Object... args)

Sends a Log.Level.DEBUG log message.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

i

public void i(java.lang.String msg,
              java.lang.Object... args)

Sends an Log.Level.INFO log message.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

w

public void w(java.lang.String msg,
              java.lang.Object... args)

Sends a Log.Level.WARN log message.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

w

public void w(java.lang.Throwable t,
              java.lang.String msg,
              java.lang.Object... args)

Sends a Log.Level.WARN log message with the Exception at the end of the message.

Parameters:

t - The exception to log

msg - the message you would like logged

args - the extra arguments for the message

e

public void e(java.lang.String msg,
              java.lang.Object... args)

Sends an Log.Level.ERROR log message.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

e

public void e(java.lang.Throwable t,
              java.lang.String msg,
              java.lang.Object... args)

Sends an Log.Level.ERROR log message with the Exception at the end of the message.

Parameters:

t - The exception to log

msg - the message you would like logged

args - the extra arguments for the message

wtf

public void wtf(java.lang.String msg,
                java.lang.Object... args)

What a Terrible Failure: Report a condition that should never happen.

Parameters:

msg - the message you would like logged

args - the extra arguments for the message

wtf

public void wtf(java.lang.Throwable t,
                java.lang.String msg,
                java.lang.Object... args)

What a Terrible Failure: Report a condition that should never happen with the Exception at the end of the message.

Parameters:

t - The exception to log

msg - the message you would like logged

args - the extra arguments for the message