com.isti.util
Class ClientLogViaCfgProps

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

All Implemented Interfaces:

ErrorMsgMgrIntf

public class ClientLogViaCfgProps

extends ErrorMessageMgr

Class ClientLogViaCfgProps 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	clientConsoleLevelProp Message level for console output.
CfgPropItem	clientLogFileLevelProp Message level for log file output.
CfgPropItem	clientLogFileNameProp Name of the log file.
CfgPropItem	consoleRedirectFileNameProp Name of the console output redirect file.
protected java.io.PrintStream	consoleRedirectStream Output stream for redirected console output.
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

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

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

ClientLogViaCfgProps(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.

clientLogFileNameProp

public final CfgPropItem clientLogFileNameProp

Name of the log file.

clientLogFileLevelProp

public final CfgPropItem clientLogFileLevelProp

Message level for log file output.

clientConsoleLevelProp

public final CfgPropItem clientConsoleLevelProp

Message level for console output.

logFilesMaxAgeInDaysProp

public final CfgPropItem logFilesMaxAgeInDaysProp

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

Constructor Detail

ClientLogViaCfgProps

public ClientLogViaCfgProps()

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

ClientLogViaCfgProps

public ClientLogViaCfgProps(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.

ClientLogViaCfgProps

public ClientLogViaCfgProps(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.