com.grey.logging

Class Logger

java.lang.Object

com.grey.logging.Logger

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

Direct Known Subclasses:

AdapterJCL, AdapterSLF4J, CharLogger, LatinLogger, MemLogger, SinkLogger

public abstract class Logger
extends Object
implements Closeable, Flushable

Base class for a range of loggers offering basic log() interfaces, optimised for zero garbagae generation.
The subclasses are meant to be accessed via this type, and this class provides configurable logfile rotation.

This base class is MT-safe with respect to its public methods, and MT-safe concrete classes would need to synchronise access to their log(CharSequence msg) and flush() methods.
This class makes some inexpensive provision for multi-threading, but the overridden log() and flush() methods need to be synchronized to make it fully MT-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Logger.LEVEL

Field Summary

Fields

Modifier and Type	Field and Description
protected int	bufsiz
static String	SYSPROP_DIAG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Logger(Parameters params, String logname, boolean is_mt)

Method Summary

Modifier and Type	Method and Description
void	close()
protected void	closeStream(boolean is_owner)
void	error(CharSequence msg)
void	flush()
String	getActivePath()
Logger.LEVEL	getLevel()
String	getName()
String	getPathTemplate()
void	info(CharSequence msg)
protected void	init()
boolean	isActive(Logger.LEVEL lvl)
abstract void	log(Logger.LEVEL lvl, CharSequence msg)
void	log(Logger.LEVEL lvl, Throwable ex, boolean dumpStack, CharSequence msg)
protected void	openStream(OutputStream strm)
protected void	openStream(String pthnam)
Logger.LEVEL	setLevel(Logger.LEVEL newlvl)
protected StringBuilder	setLogEntry(Logger.LEVEL lvl, StringBuilder pfxbuf)
String	toString()
void	trace(CharSequence msg)
void	warn(CharSequence msg)

Methods inherited from class java.lang.Object

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

Field Detail

SYSPROP_DIAG

public static final String SYSPROP_DIAG

See Also:

Constant Field Values

bufsiz

protected final int bufsiz

Constructor Detail

Logger

protected Logger(Parameters params,
                 String logname,
                 boolean is_mt)

Method Detail

log

public abstract void log(Logger.LEVEL lvl,
                         CharSequence msg)

openStream

protected void openStream(OutputStream strm)
                   throws IOException

Throws:

IOException

openStream

protected void openStream(String pthnam)
                   throws IOException

Throws:

IOException

closeStream

protected void closeStream(boolean is_owner)
                    throws IOException

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException

isActive

public boolean isActive(Logger.LEVEL lvl)

getName

public String getName()

getPathTemplate

public String getPathTemplate()

getActivePath

public String getActivePath()

toString

public String toString()

Overrides:

toString in class Object

init

protected void init()
             throws IOException

Throws:

IOException

getLevel

public Logger.LEVEL getLevel()

setLevel

public Logger.LEVEL setLevel(Logger.LEVEL newlvl)

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

log

public void log(Logger.LEVEL lvl,
                Throwable ex,
                boolean dumpStack,
                CharSequence msg)

setLogEntry

protected StringBuilder setLogEntry(Logger.LEVEL lvl,
                                    StringBuilder pfxbuf)
                             throws IOException

Throws:

IOException

error

public void error(CharSequence msg)

warn

public void warn(CharSequence msg)

info

public void info(CharSequence msg)

trace

public void trace(CharSequence msg)