README.md

Overview

The log framework is used for message logging, and designed for Android platform in special, there were many famous logging library, such as log4j, slf4j, logback, etc. All of those were designed for Java, but Android is not Java, the cost of time during application startup is a very import evaluation indicator for an application. Reducing the I/O consuming time during application startup is helpful for improving the performance, so, that's why it's been created.

This log framework is an interface for logging, it doesn't contains implementations in default, it must be combined with only one of logger implementations in following list or other implementation.

• Nop Logger - A silent logger implementation
• Platform Logger - Platform dependent logger which provided by log framework
• File Logger - Output log message into file

Getting Started

Logger logger = LoggerFactory.getLogger("Anonymous");

logger.info("Application startup at {0,time} on {0,date}", new Date());

try {
    ...
} catch (Throwable t) {
    logger.error("Oops! error occurred: {0}", t);
}

Customization

The interface and implementaion of logger are bound by the LoggerBinder stub class, so, any logger implementation must implements the stub methods in LoggerBinder class, for example:

LoggerBinder

package com.sdklite.log.bind;

import com.sdklite.log.Level;
import com.sdklite.log.Logger;

public class LoggerBinder {

    public static final LoggerBinder getInstance() {
        return Internal.BINDER;
    }

    private LoggerBinder() {
    }

    public Logger getLogger(final String name) {
        return new ConsoleLogger(name);
    }

    public Level getDefaultLevel() {
        return Level.INFO;
    }

    private staitc final class Internal {
        private static final LoggerBinder BINDER = new LoggerBinder();
    }
}

ConsoleLogger

public class ConsoleLogger extends AbstractLogger {

    private final String name;

    public ConsoleLogger(final String name) {
        this.name = name;
    }

    @Override
    public String getName() {
        return this.name;
    }

    @Override
    public Logger println(final Level level, final String msg, final Object... args) {
        if (level.intValue() < Level.ERROR.intValue()) {
            System.out.println(format(msg, args));
        } else if (level.intValue() < Level.OFF.intValue()) {
            System.err.println(format(msg, args));
        }

        return this;
    }

}

Download

GitHub

Download latest source code from here.

Maven

<dependency>
  <groupId>com.sdklite</groupId>
  <groupId>log</groupId>
  <version>0.0.1</version>
</dependency>

Gradle

compile 'com.sdklite:log:0.0.1'

Documentation

Please see http://log.sdklite.com.