com.isti.util
Class LogFileViaCfgProps

java.lang.Object
  com.isti.util.ErrorMessageMgr
      com.isti.util.LogFileViaCfgProps

All Implemented Interfaces:

ErrorMsgMgrIntf

public class LogFileViaCfgProps

extends ErrorMessageMgr

Class LogFileViaCfgProps creates a log file using 'CfgPropItem' objects. The usage will usually be to extend this class, call the 'createLogFile()' method, and then make use of the 'logObj' variable.

Field Summary

CfgPropItem	consoleLevelProp Message level for console output.
CfgPropItem	consoleRedirectFileNameProp Name of the console output redirect file.
protected java.io.PrintStream	consoleRedirectStream Output stream for redirected console output.
CfgPropItem	logFileLevelProp Message level for log file output.
CfgPropItem	logFileNameProp Name of the log file.
CfgProperties	logFileProps Configuration-properties object holding the log-file items.
CfgPropItem	logFilesMaxAgeInDaysProp Maximum age for log files (days, 0=infinite).
protected LogFile	logObj Log-file object.

Constructor Summary

LogFileViaCfgProps()
Creates an object for creating a log file using 'CfgPropItem' objects.

LogFileViaCfgProps(CfgProperties cfgPropsObj)
Creates an object for creating a log file using 'CfgPropItem' objects.

LogFileViaCfgProps(CfgProperties cfgPropsObj, java.lang.Object groupSelObj)
Creates an object for creating a log file using 'CfgPropItem' objects.

Method Summary

void	addLogFilePropItems(CfgProperties cfgPropsObj) Adds the log-file items to the given configuration-properties object.
void	addLogFilePropItems(CfgProperties cfgPropsObj, java.lang.Object groupSelObj) Adds the log-file items to the given configuration-properties object.
void	closeConsoleRedirectStream() Closes the console-redirect object created via the 'createLogFile()' method.
void	closeLogFile() Closes the log-file object created via the 'createLogFile()' method.
boolean	createLogFile(boolean abortOnErrorFlag) Creates a log file and sets it up using the configuration-property item objects.
java.io.PrintStream	getConsoleRedirectStreamObj() Returns the console-redirect object created via the 'createLogFile()' method.
LogFile	getLogFileObj() Returns the log-file object created via the 'createLogFile()' method.
void	setGroupSelObj(java.lang.Object groupSelObj) Sets the group-selection object for the log-file items.

Methods inherited from class com.isti.util.ErrorMessageMgr

clearErrorMessageString, clearFetchedErrorMessage, enterErrorMessageString, getErrorMessageFlag, getErrorMessageString, getUnfetchedMessageFlag, setErrorMessageString

Methods inherited from class java.lang.Object

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

Field Detail

logObj

protected LogFile logObj

Log-file object.

consoleRedirectStream

protected java.io.PrintStream consoleRedirectStream

Output stream for redirected console output.

logFileProps

public final CfgProperties logFileProps

Configuration-properties object holding the log-file items.

consoleRedirectFileNameProp

public final CfgPropItem consoleRedirectFileNameProp

Name of the console output redirect file.

logFileNameProp

public final CfgPropItem logFileNameProp

Name of the log file.

logFileLevelProp

public final CfgPropItem logFileLevelProp

Message level for log file output.

consoleLevelProp

public final CfgPropItem consoleLevelProp

Message level for console output.

logFilesMaxAgeInDaysProp

public final CfgPropItem logFilesMaxAgeInDaysProp

Maximum age for log files (days, 0=infinite).

Constructor Detail

LogFileViaCfgProps

public LogFileViaCfgProps()

Creates an object for creating a log file using 'CfgPropItem' objects.

LogFileViaCfgProps

public LogFileViaCfgProps(CfgProperties cfgPropsObj,
                          java.lang.Object groupSelObj)

Creates an object for creating a log file using 'CfgPropItem' objects.

Parameters:

cfgPropsObj - the configuration-properties object to use.

groupSelObj - the configuration-group-selection object to use, or null for none.

LogFileViaCfgProps

public LogFileViaCfgProps(CfgProperties cfgPropsObj)

Creates an object for creating a log file using 'CfgPropItem' objects.

Parameters:

cfgPropsObj - the configuration-properties object to use.

Method Detail

addLogFilePropItems

public final void addLogFilePropItems(CfgProperties cfgPropsObj,
                                      java.lang.Object groupSelObj)

Adds the log-file items to the given configuration-properties object.

Parameters:

cfgPropsObj - the configuration-properties object to use.

groupSelObj - the configuration-group-selection object to use, or null for none.

addLogFilePropItems

public final void addLogFilePropItems(CfgProperties cfgPropsObj)

Adds the log-file items to the given configuration-properties object.

Parameters:

cfgPropsObj - the configuration-properties object to use.

setGroupSelObj

public final void setGroupSelObj(java.lang.Object groupSelObj)

Sets the group-selection object for the log-file items.

Parameters:

groupSelObj - the configuration-group-selection object to use, or null for none.

createLogFile

public boolean createLogFile(boolean abortOnErrorFlag)

Creates a log file and sets it up using the configuration-property item objects. A redirected console output stream may also be setup.

Parameters:

abortOnErrorFlag - if true then this method will return immediately after the first error is flagged (without creating the log file); if false then this method will always create the log file.

Returns:

'true' if successful, false if an error occurred (in which case an error message will be sent to the console and may be fetched via the 'getErrorMessageString()' method).

getLogFileObj

public LogFile getLogFileObj()

Returns the log-file object created via the 'createLogFile()' method.

Returns:

A 'LogFile' object, or null if none has been created.

closeLogFile

public void closeLogFile()

Closes the log-file object created via the 'createLogFile()' method.

getConsoleRedirectStreamObj

public java.io.PrintStream getConsoleRedirectStreamObj()

Returns the console-redirect object created via the 'createLogFile()' method.

Returns:

A 'PrintStream' object for console output, or null if none has been created.

closeConsoleRedirectStream

public void closeConsoleRedirectStream()

Closes the console-redirect object created via the 'createLogFile()' method.