org.slog4j.SLogger Maven / Gradle / Ivy

package org.slog4j;

/**
 * A structured log message always adheres to the following rules:
 *
 * 
 * <FULL_TIMESTAMP> <LEVEL> <key1=value1> [<key2=value2> ...]
 *
 * 

 *     Every message is represented by a single line of text;
 *     Always prefixed by zoned timestamp;
 *     The LEVEL is printed next;
 *     The remaining text is a sequence of properties on the format name=value separated by a single space;
 *     key1 is always the event ID labeled by "evtId";
 * 
 */
public interface SLogger {

    void error(String eventId, Object... objs);
    void error(String eventId);
    void error(String eventId, Object obj);
    void error(String eventId, String name, Object value);

    void warn(String eventId, Object... objs);
    void warn(String eventId);
    void warn(String eventId, Object obj);
    void warn(String eventId, String name, Object value);

    // the untraced counterparts
    void info(String eventId, Object... objs);
    void info(String eventId);
    void info(String eventId, Object obj);
    void info(String eventId, String name, Object value);

    void debug(String eventId, Object... objs);
    void debug(String eventId);
    void debug(String eventId, Object obj);
    void debug(String eventId, String name, Object value);

    void trace(String eventId, Object... objs);
    void trace(String eventId);
    void trace(String eventId, Object obj);
    void trace(String eventId, String name, Object value);
}