com.robopupu.api.util

Class Log

java.lang.Object

com.robopupu.api.util.Log

public class Log
extends java.lang.Object

Log is an object that can be used for logging instead of Android's android.util.Log

Constructor Summary

Constructors

Constructor and Description
Log()

Method Summary

Modifier and Type	Method and Description
static int	d(java.lang.String tag, java.lang.String message) Send a #DEBUG log message.
static int	d(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) Send a #DEBUG log message and log the exception.
static int	e(java.lang.String tag, java.lang.String message) Send an #ERROR log message.
static int	e(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) Send a #ERROR log message and log the exception.
static java.lang.String	getStackTraceString(java.lang.Throwable throwable) Handy function to get a loggable stack trace from a Throwable
static int	i(java.lang.String tag, java.lang.String message) Send an #INFO log message.
static int	i(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) Send a #INFO log message and log the exception.
static boolean	isEnabled()
static boolean	isLoggable(java.lang.String tag, int level) Checks to see whether or not a log for the specified tag is loggable at the specified level.
static int	println(int priority, java.lang.String tag, java.lang.String message) Low-level logging call.
static void	setDelegate(LogDelegate delegate)
static void	setEnabled(boolean enabled)
static int	v(java.lang.String tag, java.lang.String message) Send a #VERBOSE log message.
static int	v(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) Send a #VERBOSE log message and log the exception.
static int	w(java.lang.String tag, java.lang.String message) Send a #WARN log message.
static int	w(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) Send a #WARN log message and log the exception.
static int	w(java.lang.String tag, java.lang.Throwable throwable)
static int	wtf(java.lang.String tag, java.lang.String message) What a Terrible Failure: Report a condition that should never happen.
static int	wtf(java.lang.String tag, java.lang.String message, java.lang.Throwable throwable) What a Terrible Failure: Report an exception that should never happen.
static int	wtf(java.lang.String tag, java.lang.Throwable throwable) What a Terrible Failure: Report an exception that should never happen.

Methods inherited from class java.lang.Object

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

Constructor Detail

Log

public Log()

Method Detail

setDelegate

public static void setDelegate(LogDelegate delegate)

isEnabled

public static boolean isEnabled()

setEnabled

public static void setEnabled(boolean enabled)

v

public static int v(java.lang.String tag,
                    java.lang.String message)

Send a #VERBOSE log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

v

public static int v(java.lang.String tag,
                    java.lang.String message,
                    java.lang.Throwable throwable)

Send a #VERBOSE log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

throwable - An exception to log

d

public static int d(java.lang.String tag,
                    java.lang.String message)

Send a #DEBUG log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

d

public static int d(java.lang.String tag,
                    java.lang.String message,
                    java.lang.Throwable throwable)

Send a #DEBUG log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

throwable - An exception to log

i

public static int i(java.lang.String tag,
                    java.lang.String message)

Send an #INFO log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

i

public static int i(java.lang.String tag,
                    java.lang.String message,
                    java.lang.Throwable throwable)

Send a #INFO log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

throwable - An exception to log

w

public static int w(java.lang.String tag,
                    java.lang.String message)

Send a #WARN log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

w

public static int w(java.lang.String tag,
                    java.lang.String message,
                    java.lang.Throwable throwable)

Send a #WARN log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

throwable - An exception to log

isLoggable

public static boolean isLoggable(java.lang.String tag,
                                 int level)

Checks to see whether or not a log for the specified tag is loggable at the specified level. The default level of any tag is set to INFO. This means that any level above and including INFO will be logged. Before you make any calls to a logging method you should check to see if your tag should be logged. You can change the default level by setting a system property: 'setprop log.tag.<YOUR_LOG_TAG> <LEVEL>' Where level is either VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT, or SUPPRESS. SUPPRESS will turn off all logging for your tag. You can also create a local.prop file that with the following in it: 'log.tag.<YOUR_LOG_TAG>=<LEVEL>' and place that in /data/local.prop.

Parameters:

tag - The tag to check.

level - The level to check.

Returns:

Whether or not that this is allowed to be logged.

Throws:

java.lang.IllegalArgumentException - is thrown if the tag.length() > 23.

w

public static int w(java.lang.String tag,
                    java.lang.Throwable throwable)

e

public static int e(java.lang.String tag,
                    java.lang.String message)

Send an #ERROR log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

e

public static int e(java.lang.String tag,
                    java.lang.String message,
                    java.lang.Throwable throwable)

Send a #ERROR log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

throwable - An exception to log

wtf

public static int wtf(java.lang.String tag,
                      java.lang.String message)

What a Terrible Failure: Report a condition that should never happen. The error will always be logged at level ASSERT with the call stack.

Parameters:

tag - Used to identify the source of a log message.

message - The message you would like logged.

wtf

public static int wtf(java.lang.String tag,
                      java.lang.Throwable throwable)

What a Terrible Failure: Report an exception that should never happen. Similar to wtf(String, String), with an exception to log.

Parameters:

tag - Used to identify the source of a log message.

throwable - An exception to log.

wtf

public static int wtf(java.lang.String tag,
                      java.lang.String message,
                      java.lang.Throwable throwable)

What a Terrible Failure: Report an exception that should never happen. Similar to wtf(String, Throwable), with a message as well.

Parameters:

tag - Used to identify the source of a log message.

message - The message you would like logged.

throwable - A Throwable to log. May be null.

getStackTraceString

public static java.lang.String getStackTraceString(java.lang.Throwable throwable)

Handy function to get a loggable stack trace from a Throwable

Parameters:

throwable - An exception to log

println

public static int println(int priority,
                          java.lang.String tag,
                          java.lang.String message)

Low-level logging call.

Parameters:

priority - The priority/type of this log message

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

message - The message you would like logged.

Returns:

The number of bytes written.