com.neovisionaries.android.util

Class L

java.lang.Object

com.neovisionaries.android.util.L

public final class L
extends Object

Logging utility (Simple wrapper over android.util.Log).

L class provides some methods whose tag argument's type is Object. The methods convert the given tag object into a String instance by the steps shown below before calling counterpart methods of android.util.Log.

1. If tag implements CharSequence, call tag.toString().
2. Otherwise, if tag is an instance of Class<?>, call ((Class<?>)tag).getSimpleName().
3. Otherwise, call tag.getClass().getSimpleName().
   

The conversion above allows programmers to write code snippets like below.

 // 'this' can be used as tag.
 L.d(this, "'this' can be used as tag.");

 // A Class instance can be used as tag.
 L.d(MyClass.class, "A Class instance can be used as tag.");
 

L class also provides ?(Object tag, String format, Object... args) and ?(Object tag, Throwable cause, String format, Object... args) methods. They internally build a String instance by calling String.format(format, args) before calling counterpart methods of android.util.Log. String concatenation by + is not needed any more before calling logging methods.

 String firstName = ...;
 String lastName = ...;

 L.d(this, "Name = %s %s", firstName, lastName);
 

Author:

Takahiko Kawasaki

Method Summary

Modifier and Type	Method and Description
static int	d(Object tag, String message) Emit a log message of DEBUG level.
static int	d(Object tag, String format, Object... args) Emit a log message of DEBUG level.
static int	d(Object tag, String message, Throwable cause) Emit a log message of DEBUG level.
static int	d(Object tag, Throwable cause, String format, Object... args) Emit a log message of DEBUG level.
static int	d(String tag, String message) Emit a log message of DEBUG level by calling Log.d(tag, message).
static int	d(String tag, String message, Throwable cause) Emit a log message of DEBUG level by calling Log.d(tag, message, cause).
static int	dformat(Object tag, String format, Object... args) Deprecated. Use d(Object, String, Object...).
static int	dformat(Object tag, Throwable cause, String format, Object... args) Deprecated. Use d(Object, Throwable, String, Object...).
static int	e(Object tag, String message) Emit a log message of ERROR level.
static int	e(Object tag, String format, Object... args) Emit a log message of ERROR level.
static int	e(Object tag, String message, Throwable cause) Emit a log message of ERROR level.
static int	e(Object tag, Throwable cause, String format, Object... args) Emit a log message of ERROR level.
static int	e(String tag, String message) Emit a log message of ERROR level by calling Log.e(tag, message).
static int	e(String tag, String message, Throwable cause) Emit a log message of ERROR level by calling Log.e(tag, message, cause).
static int	eformat(Object tag, String format, Object... args) Deprecated. Use e(Object, String, Object...).
static int	eformat(Object tag, Throwable cause, String format, Object... args) Deprecated. Use e(Object, Throwable, String, Object...).
static int	i(Object tag, String message) Emit a log message of INFO level.
static int	i(Object tag, String format, Object... args) Emit a log message of INFO level.
static int	i(Object tag, String message, Throwable cause) Emit a log message of INFO level.
static int	i(Object tag, Throwable cause, String format, Object... args) Emit a log message of INFO level.
static int	i(String tag, String message) Emit a log message of INFO level by calling Log.i(tag, message).
static int	i(String tag, String message, Throwable cause) Emit a log message of INFO level by calling Log.i(tag, message, cause).
static int	iformat(Object tag, String format, Object... args) Deprecated. Use i(Object, String, Object...).
static int	iformat(Object tag, Throwable cause, String format, Object... args) Deprecated. Use i(Object, Throwable, String, Object...).
static int	v(Object tag, String message) Emit a log message of VERBOSE level.
static int	v(Object tag, String format, Object... args) Emit a log message of VERBOSE level.
static int	v(Object tag, String message, Throwable cause) Emit a log message of VERBOSE level.
static int	v(Object tag, Throwable cause, String format, Object... args) Emit a log message of VERBOSE level.
static int	v(String tag, String message) Emit a log message of VERBOSE level by calling Log.v(tag, message).
static int	v(String tag, String message, Throwable cause) Emit a log message of VERBOSE level by calling Log.v(tag, message, cause).
static int	vformat(Object tag, String format, Object... args) Deprecated. Use v(Object, String, Object...).
static int	vformat(Object tag, Throwable cause, String format, Object... args) Deprecated. Use v(Object, Throwable, String, Object...).
static int	w(Object tag, String message) Emit a log message of WARN level.
static int	w(Object tag, String format, Object... args) Emit a log message of WARN level.
static int	w(Object tag, String message, Throwable cause) Emit a log message of WARN level.
static int	w(Object tag, Throwable cause, String format, Object... args) Emit a log message of WARN level.
static int	w(String tag, String message) Emit a log message of WARN level by calling Log.w(tag, message).
static int	w(String tag, String message, Throwable cause) Emit a log message of WARN level by calling Log.w(tag, message, cause).
static int	wformat(Object tag, String format, Object... args) Deprecated. Use w(Object, String, Object...).
static int	wformat(Object tag, Throwable cause, String format, Object... args) Deprecated. Use w(Object, Throwable, String, Object...).

Methods inherited from class java.lang.Object

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

Method Detail

d

public static int d(String tag,
                    String message)

Emit a log message of DEBUG level by calling Log.d(tag, message).

d

public static int d(String tag,
                    String message,
                    Throwable cause)

Emit a log message of DEBUG level by calling Log.d(tag, message, cause).

d

public static int d(Object tag,
                    String message)

Emit a log message of DEBUG level.

d

public static int d(Object tag,
                    String message,
                    Throwable cause)

Emit a log message of DEBUG level.

d

public static int d(Object tag,
                    String format,
                    Object... args)

Emit a log message of DEBUG level.

Since:

1.7

d

public static int d(Object tag,
                    Throwable cause,
                    String format,
                    Object... args)

Emit a log message of DEBUG level.

Since:

1.7

dformat

@Deprecated
public static int dformat(Object tag,
                                       String format,
                                       Object... args)

Deprecated. Use d(Object, String, Object...).

Emit a log message of DEBUG level.

dformat

@Deprecated
public static int dformat(Object tag,
                                       Throwable cause,
                                       String format,
                                       Object... args)

Deprecated. Use d(Object, Throwable, String, Object...).

Emit a log message of DEBUG level.

e

public static int e(String tag,
                    String message)

Emit a log message of ERROR level by calling Log.e(tag, message).

e

public static int e(String tag,
                    String message,
                    Throwable cause)

Emit a log message of ERROR level by calling Log.e(tag, message, cause).

e

public static int e(Object tag,
                    String message)

Emit a log message of ERROR level.

e

public static int e(Object tag,
                    String message,
                    Throwable cause)

Emit a log message of ERROR level.

e

public static int e(Object tag,
                    String format,
                    Object... args)

Emit a log message of ERROR level.

Since:

1.7

e

public static int e(Object tag,
                    Throwable cause,
                    String format,
                    Object... args)

Emit a log message of ERROR level.

Since:

1.7

eformat

@Deprecated
public static int eformat(Object tag,
                                       String format,
                                       Object... args)

Deprecated. Use e(Object, String, Object...).

Emit a log message of ERROR level.

eformat

@Deprecated
public static int eformat(Object tag,
                                       Throwable cause,
                                       String format,
                                       Object... args)

Deprecated. Use e(Object, Throwable, String, Object...).

Emit a log message of ERROR level.

i

public static int i(String tag,
                    String message)

Emit a log message of INFO level by calling Log.i(tag, message).

i

public static int i(String tag,
                    String message,
                    Throwable cause)

Emit a log message of INFO level by calling Log.i(tag, message, cause).

i

public static int i(Object tag,
                    String message)

Emit a log message of INFO level.

i

public static int i(Object tag,
                    String message,
                    Throwable cause)

Emit a log message of INFO level.

i

public static int i(Object tag,
                    String format,
                    Object... args)

Emit a log message of INFO level.

Since:

1.7

i

public static int i(Object tag,
                    Throwable cause,
                    String format,
                    Object... args)

Emit a log message of INFO level.

Since:

1.7

iformat

@Deprecated
public static int iformat(Object tag,
                                       String format,
                                       Object... args)

Deprecated. Use i(Object, String, Object...).

Emit a log message of INFO level.

iformat

@Deprecated
public static int iformat(Object tag,
                                       Throwable cause,
                                       String format,
                                       Object... args)

Deprecated. Use i(Object, Throwable, String, Object...).

Emit a log message of INFO level.

v

public static int v(String tag,
                    String message)

Emit a log message of VERBOSE level by calling Log.v(tag, message).

v

public static int v(String tag,
                    String message,
                    Throwable cause)

Emit a log message of VERBOSE level by calling Log.v(tag, message, cause).

v

public static int v(Object tag,
                    String message)

Emit a log message of VERBOSE level.

v

public static int v(Object tag,
                    String message,
                    Throwable cause)

Emit a log message of VERBOSE level.

v

public static int v(Object tag,
                    String format,
                    Object... args)

Emit a log message of VERBOSE level.

Since:

1.7

v

public static int v(Object tag,
                    Throwable cause,
                    String format,
                    Object... args)

Emit a log message of VERBOSE level.

Since:

1.7

vformat

@Deprecated
public static int vformat(Object tag,
                                       String format,
                                       Object... args)

Deprecated. Use v(Object, String, Object...).

Emit a log message of VERBOSE level.

vformat

@Deprecated
public static int vformat(Object tag,
                                       Throwable cause,
                                       String format,
                                       Object... args)

Deprecated. Use v(Object, Throwable, String, Object...).

Emit a log message of VERBOSE level.

w

public static int w(String tag,
                    String message)

Emit a log message of WARN level by calling Log.w(tag, message).

w

public static int w(String tag,
                    String message,
                    Throwable cause)

Emit a log message of WARN level by calling Log.w(tag, message, cause).

w

public static int w(Object tag,
                    String message)

Emit a log message of WARN level.

w

public static int w(Object tag,
                    String message,
                    Throwable cause)

Emit a log message of WARN level.

w

public static int w(Object tag,
                    String format,
                    Object... args)

Emit a log message of WARN level.

Since:

1.7

w

public static int w(Object tag,
                    Throwable cause,
                    String format,
                    Object... args)

Emit a log message of WARN level.

Since:

1.7

wformat

@Deprecated
public static int wformat(Object tag,
                                       String format,
                                       Object... args)

Deprecated. Use w(Object, String, Object...).

Emit a log message of WARN level.

wformat

@Deprecated
public static int wformat(Object tag,
                                       Throwable cause,
                                       String format,
                                       Object... args)

Deprecated. Use w(Object, Throwable, String, Object...).

Emit a log message of WARN level.