org.nds.logging

Class Logger

java.lang.Object

org.nds.logging.Logger

public class Logger
extends Object

A Logger object is used to log messages for an Android application or any other java application.
This can be useful when developing an Android library, and we write unit tests (JUnit) and integration tests (Android Unit tests).

It is based on two types of log:

• Android.util.Log: used to log an Android application
• Org.apache.commons.logging.Log: used for logging Any Other java application

Android Log:

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. ' 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.=' and place that in /data/local.prop.

To push files, open && browse in Terminal/CommandLine to ".../android_sdk/tools"
Syntax: " adb push <local_source> <emulator_destination> "

In our case, the file local.prop must contain at least:
log.tag.Logger = DEBUG
'Logger' tag is the default Logger class.
We can add more tags to their level if the application uses several different tags.

Other Java application:

It uses the Jakarta Commons Logging (JCL). (http://commons.apache.org/logging/guide.html)

As far as possible, JCL tries to be as unobtrusive as possible. In most cases, including the (full) commons-logging.jar in the classpath should result in JCL configuring itself in a reasonable manner.
There's a good chance that it'll guess (discover) your preferred logging system and you won't need to do any configuration of JCL at all!
Note, however, that if you have a particular preference then providing a simple commons-logging.properties file which specifies the concrete logging library to be used is recommended, since (in this case) JCL will log only to that system and will report any configuration problems that prevent that system being used.
Commons-Logging looks for a configuration file called commons-logging.properties in the CLASSPATH. This file must define, at the minimum, the property org.apache.commons.logging.Log, and it should be equal to the fully qualified name of one of the implementations of the Log interface listed above.
When no particular logging library is specified then JCL will silently ignore any logging library that it finds but cannot initialise and continue to look for other alternatives. This is a deliberate design decision; no application should fail to run because a "guessed" logging library cannot be used. To ensure an exception is reported when a particular logging library cannot be used, use one of the available JCL configuration mechanisms to force that library to be selected (ie disable JCL's discovery process).

JCL is distributed with a very simple Log implementation named org.apache.commons.logging.impl.SimpleLog. This is intended to be a minimal implementation and those requiring a fully functional open source logging system are directed to Log4J.
Simple implementation of Log that sends all enabled log messages, for all defined loggers, to System.err. The following system properties are supported to configure the behavior of this logger:

• org.apache.commons.logging.simplelog.defaultlog - Default logging detail level for all instances of SimpleLog. Must be one of ("trace", "debug", "info", "warn", "error", or "fatal"). If not specified, defaults to "info".
• org.apache.commons.logging.simplelog.log.xxxxx - Logging detail level for a SimpleLog instance named "xxxxx". Must be one of ("trace", "debug", "info", "warn", "error", or "fatal"). If not specified, the default logging detail level is used.
  org.apache.commons.logging.simplelog.showlogname - Set to true if you want the Log instance name to be included in output messages. Defaults to false.
• org.apache.commons.logging.simplelog.showShortLogname - Set to true if you want the last component of the name to be included in output messages. Defaults to true.
• org.apache.commons.logging.simplelog.showdatetime - Set to true if you want the current date and time to be included in output messages. Default is false.
• org.apache.commons.logging.simplelog.dateTimeFormat - The date and time format to be used in the output messages. The pattern describing the date and time format is the same that is used in java.text.SimpleDateFormat. If the format is not specified or is invalid, the default format is used. The default format is yyyy/MM/dd HH:mm:ss:SSS zzz.

In addition to looking for system properties with the names specified above, this implementation also checks for a class loader resource named simplelog.properties, and includes any matching definitions from this resource (if it exists).

Author:

Nicolas Dos Santos

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Logger(String name, Log log)

Method Summary

Methods

Modifier and Type	Method and Description
void	debug(String message, Object... params)
void	debug(String message, Throwable t, Object... params)
void	error(String message, Object... params)
void	error(String message, Throwable t, Object... params)
void	fatal(String message, Object... params)
void	fatal(String message, Throwable t, Object... params)
void	info(String message, Object... params)
void	info(String message, Throwable t, Object... params)
boolean	isDebugEnabled()
boolean	isErrorEnabled()
boolean	isFatalEnabled()
boolean	isInfoEnabled()
boolean	isTraceEnabled()
boolean	isWarnEnabled()
void	trace(Object message, Object... params)
void	trace(String message, Throwable t, Object... params)
void	warn(String message, Object... params)
void	warn(String message, Throwable t, Object... params)

Methods inherited from class java.lang.Object

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

Constructor Detail

Logger

protected Logger(String name,
      Log log)

Method Detail

isTraceEnabled

public boolean isTraceEnabled()

isDebugEnabled

public boolean isDebugEnabled()

isInfoEnabled

public boolean isInfoEnabled()

isWarnEnabled

public boolean isWarnEnabled()

isErrorEnabled

public boolean isErrorEnabled()

isFatalEnabled

public boolean isFatalEnabled()

trace

public void trace(Object message,
         Object... params)

trace

public void trace(String message,
         Throwable t,
         Object... params)

debug

public void debug(String message,
         Object... params)

debug

public void debug(String message,
         Throwable t,
         Object... params)

info

public void info(String message,
        Object... params)

info

public void info(String message,
        Throwable t,
        Object... params)

warn

public void warn(String message,
        Object... params)

warn

public void warn(String message,
        Throwable t,
        Object... params)

error

public void error(String message,
         Object... params)

error

public void error(String message,
         Throwable t,
         Object... params)

fatal

public void fatal(String message,
         Object... params)

fatal

public void fatal(String message,
         Throwable t,
         Object... params)