Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> go >> trove >> [ log overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

com.go.trove.log
Class Log  

java.lang.Object
  com.go.trove.log.Log

All Implemented Interfaces:

java.util.EventListener, LogListener, java.io.Serializable

---

public class Log

extends java.lang.Object

implements LogListener, java.io.Serializable

General purpose logging class that operates using a hierarchy of Logs and an event model. All LogEvents are categorized into one of four types: debugging, informational, warning and error. A log event can be generated by writing to one of the four PrintWriter fields provided (debug, info, warn and error), or by calling the debug, info, warn or error methods. Logs can have a parent Log, which by default, receives all the events that the Log generates or receives. If a log is disabled, it will not generate or propagate events. Examples:

 Log log = new Log("test", null);
 log.addLogListener(new LogScribe(new PrintWriter(System.out)));

 log.debug().println("Printing a debugging message");
 log.info("System running");

 Syslog.info().println("Creating child log...");
 Log child = new Log("child", Syslog.log);
 child.warn("This is a system warning...");

 try {
     ...
 }
 catch (Exception e) {
     child.error(e);
 }

 Log saved = new Log("saved", Syslog.log);
 File logDir = new File("/logs/");
 OutputStream out = new DailyFileLogStream(logDir);
 saved.addLogListener(new LogScribe(new PrintWriter(out)));
 saved.info("Saved log file initialized");
 

Version:

27 , 6/28/01

---

Field Summary
private static int	DEBUG_ENABLED_MASK
private static int	ENABLED_MASK
private static int	ERROR_ENABLED_MASK
private static int	INFO_ENABLED_MASK
private  java.util.Collection	mChildren
private  java.io.PrintWriter	mDebug
private  java.lang.String	mDescription
private  int	mEnabledFlags
private  java.io.PrintWriter	mError
private  java.io.PrintWriter	mInfo
private  java.util.List	mListeners
private  java.lang.String	mName
private  Log	mParent
private  java.io.PrintWriter	mWarn
private static int	WARN_ENABLED_MASK

 

Constructor Summary
private	Log()
	Log(java.lang.String name, Log parent)           Create a new Log that inherits enabled settings from its parent.

 

Method Summary
void	addLogListener(LogListener listener)
void	addRootLogListener(LogListener listener)           adds a listener to the root log, the log with a null parent
void	applyProperties(java.util.Map properties)           Understands and applies the following boolean properties.
java.io.PrintWriter	debug()           Returns a PrintWriter for debug messages.
void	debug(java.lang.String s)           Simple method for logging a single debugging message.
void	debug(java.lang.Throwable t)           Simple method for logging a single debugging exception.
private  void	dispatchLogException(LogEvent e)
private  void	dispatchLogMessage(LogEvent e)
java.io.PrintWriter	error()           Returns a PrintWriter for error messages.
void	error(java.lang.String s)           Simple method for logging a single error message.
void	error(java.lang.Throwable t)           Simple method for logging a single error exception.
Log[]	getChildren()           Returns a copy of the children Logs.
java.lang.String	getDescription()           Returns a brief description of this Log.
java.lang.String	getName()           Returns null if this Log has no name.
java.io.PrintWriter	info()           Returns a PrintWriter for information messages.
void	info(java.lang.String s)           Simple method for logging a single information message.
void	info(java.lang.Throwable t)           Simple method for logging a single information exception.
boolean	isDebugEnabled()           Returns true if debug events for this Log are enabled.
boolean	isEnabled()           Returns true if this Log is enabled.
private  boolean	isEnabled(int mask)
boolean	isErrorEnabled()           Returns true if error events for this Log are enabled.
boolean	isInfoEnabled()           Returns true if info events for this Log are enabled.
boolean	isWarnEnabled()           Returns true if warn events for this Log are enabled.
void	logException(LogEvent e)           If this Log is enabled, then dispatch the LogEvent to all of its listeners as a logged exception.
void	logMessage(LogEvent e)           If this Log is enabled, then dispatch the LogEvent to all of its listeners as a logged message.
void	removeLogListener(LogListener listener)
void	removeRootLogListener(LogListener listener)
void	setDebugEnabled(boolean enabled)           When debug is enabled, this Log is enabled and all parent Logs are enabled.
void	setDescription(java.lang.String desc)           Set the log's description text.
void	setEnabled(boolean enabled)           When this Log is enabled, all parent Logs are also enabled.
private  void	setEnabled(boolean enabled, int mask)
void	setErrorEnabled(boolean enabled)           When error is enabled, this Log is enabled and all parent Logs are enabled.
void	setInfoEnabled(boolean enabled)           When info is enabled, this Log is enabled and all parent Logs are enabled.
void	setWarnEnabled(boolean enabled)           When warn is enabled, this Log is enabled and all parent Logs are enabled.
java.lang.String	toString()           Returns a short description of this log.
java.io.PrintWriter	warn()           Returns a PrintWriter for warning messages.
void	warn(java.lang.String s)           Simple method for logging a single warning message.
void	warn(java.lang.Throwable t)           Simple method for logging a single warning exception.

 

Methods inherited from class java.lang.Object

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

 

Field Detail

ENABLED_MASK

private static final int ENABLED_MASK

See Also:

Constant Field Values

---

DEBUG_ENABLED_MASK

private static final int DEBUG_ENABLED_MASK

See Also:

Constant Field Values

---

INFO_ENABLED_MASK

private static final int INFO_ENABLED_MASK

See Also:

Constant Field Values

---

WARN_ENABLED_MASK

private static final int WARN_ENABLED_MASK

See Also:

Constant Field Values

---

ERROR_ENABLED_MASK

private static final int ERROR_ENABLED_MASK

See Also:

Constant Field Values

---

mDebug

private final transient java.io.PrintWriter mDebug

---

mInfo

private final transient java.io.PrintWriter mInfo

---

mWarn

private final transient java.io.PrintWriter mWarn

---

mError

private final transient java.io.PrintWriter mError

---

mParent

private Log mParent

---

mChildren

private java.util.Collection mChildren

---

mName

private java.lang.String mName

---

mDescription

private java.lang.String mDescription

---

mEnabledFlags

private int mEnabledFlags

---

mListeners

private transient java.util.List mListeners

Constructor Detail

Log

public Log(java.lang.String name,
           Log parent)

Create a new Log that inherits enabled settings from its parent. If no parent is specified, then the Log is fully enabled. If a parent is specified, then it is added automatically as a listener to this Log.

---

Log

private Log()

Method Detail

addRootLogListener

public void addRootLogListener(LogListener listener)

adds a listener to the root log, the log with a null parent

---

removeRootLogListener

public void removeRootLogListener(LogListener listener)

---

addLogListener

public void addLogListener(LogListener listener)

---

removeLogListener

public void removeLogListener(LogListener listener)

---

logMessage

public void logMessage(LogEvent e)

If this Log is enabled, then dispatch the LogEvent to all of its listeners as a logged message.

Specified by:

logMessage in interface LogListener

---

logException

public void logException(LogEvent e)

If this Log is enabled, then dispatch the LogEvent to all of its listeners as a logged exception.

Specified by:

logException in interface LogListener

---

dispatchLogMessage

private void dispatchLogMessage(LogEvent e)

---

dispatchLogException

private void dispatchLogException(LogEvent e)

---

debug

public java.io.PrintWriter debug()

Returns a PrintWriter for debug messages.

---

debug

public void debug(java.lang.String s)

Simple method for logging a single debugging message.

---

debug

public void debug(java.lang.Throwable t)

Simple method for logging a single debugging exception.

---

info

public java.io.PrintWriter info()

Returns a PrintWriter for information messages.

---

info

public void info(java.lang.String s)

Simple method for logging a single information message.

---

info

public void info(java.lang.Throwable t)

Simple method for logging a single information exception.

---

warn

public java.io.PrintWriter warn()

Returns a PrintWriter for warning messages.

---

warn

public void warn(java.lang.String s)

Simple method for logging a single warning message.

---

warn

public void warn(java.lang.Throwable t)

Simple method for logging a single warning exception.

---

error

public java.io.PrintWriter error()

Returns a PrintWriter for error messages.

---

error

public void error(java.lang.String s)

Simple method for logging a single error message.

---

error

public void error(java.lang.Throwable t)

Simple method for logging a single error exception.

---

getChildren

public Log[] getChildren()

Returns a copy of the children Logs.

---

getName

public java.lang.String getName()

Returns null if this Log has no name.

---

getDescription

public java.lang.String getDescription()

Returns a brief description of this Log. By default, returns the name.

---

setDescription

public void setDescription(java.lang.String desc)

Set the log's description text.

---

isEnabled

public boolean isEnabled()

Returns true if this Log is enabled. If log is disabled, then no log events of any kind are generated or propagated to listeners.

---

setEnabled

public void setEnabled(boolean enabled)

When this Log is enabled, all parent Logs are also enabled. When this Log is disabled, parent Logs are unaffected.

---

isDebugEnabled

public boolean isDebugEnabled()

Returns true if debug events for this Log are enabled. If debug events are disabled, then no debug log events are generated, but they can be propagated to listeners.

---

setDebugEnabled

public void setDebugEnabled(boolean enabled)

When debug is enabled, this Log is enabled and all parent Logs are enabled. Disabling debug only affects this Log's debug state.

---

isInfoEnabled

public boolean isInfoEnabled()

Returns true if info events for this Log are enabled. If info events are disabled, then no info log events are generated, but they can be propagated to listeners.

---

setInfoEnabled

public void setInfoEnabled(boolean enabled)

When info is enabled, this Log is enabled and all parent Logs are enabled. Disabling info only affects this Log's info state.

---

isWarnEnabled

public boolean isWarnEnabled()

Returns true if warn events for this Log are enabled. If warn events are disabled, then no warn log events are generated, but they can be propagated to listeners.

---

setWarnEnabled

public void setWarnEnabled(boolean enabled)

When warn is enabled, this Log is enabled and all parent Logs are enabled. Disabling warn only affects this Log's warn state.

---

isErrorEnabled

public boolean isErrorEnabled()

Returns true if error events for this Log are enabled. If error events are disabled, then no error log events are generated, but they can be propagated to listeners.

---

setErrorEnabled

public void setErrorEnabled(boolean enabled)

When error is enabled, this Log is enabled and all parent Logs are enabled. Disabling error only affects this Log's error state.

---

applyProperties

public void applyProperties(java.util.Map properties)

Understands and applies the following boolean properties. True is the default value if the value doesn't equal "false", ignoring case.

• enabled
• debug
• info
• warn
• error

---

toString

public java.lang.String toString()

Returns a short description of this log.

---

isEnabled

private boolean isEnabled(int mask)

---

setEnabled

private void setEnabled(boolean enabled,
                        int mask)

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> go >> trove >> [ log overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---