com.dpslink.flash.imports

Class ImportLogWriter

java.lang.Object

com.dpslink.base.util.LogWriter

com.dpslink.flash.imports.ImportLogWriter

All Implemented Interfaces:

java.io.Serializable

public class ImportLogWriter
extends LogWriter

A utility class for persisting events to a log file and for sending alert email messages when a configured severity level occurs.

Overrides the base LogWriter to provide logging to an alternate log file for import functions.

All message keys retrieved by this class are automatically prefixed with "MSG.Import." when the message id is retrieved.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static org.apache.log4j.Logger	cvImportLog A reference to the IMPORT log file.
private static long	serialVersionUID The class' serialization version id.

Fields inherited from class com.dpslink.base.util.LogWriter

cvAlert, cvConfig, cvConsole, cvMainLog, DEBUG, ERROR, FATAL, GENPREFIX, INFO, WARN

Constructor Summary

Constructors

Constructor and Description
ImportLogWriter()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getLogFileFolder() Returns the configured file path for IMPORT log files.
static java.lang.String	getLogFileName() Returns the configured file name for IMPORT log files.
static org.apache.log4j.Level	getLogLevel() Returns the current log level for the IMPORT log.
static void	log(java.lang.Exception e) Writes a IMPORT log file entry for the given exception.
static void	log(java.lang.String msgid) Writes a IMPORT log file entry for the given message id.
static void	log(java.lang.String msgid, java.lang.Exception ex) Writes a IMPORT log file entry for the given message id and exception.
static void	log(java.lang.String msgid, java.lang.Exception ex, java.lang.String... values) Writes a IMPORT log file entry for the given message id and exception.
static void	log(java.lang.String msgid, java.lang.String... values) Writes a IMPORT log file entry for the given message id.
protected static void	logMessage(org.apache.log4j.Level severity, java.lang.String msgtext) Writes a IMPORT log file entry for the given severity level and message text and sends an email if the message severity is configured for alert emails.
static void	logSeparator() Writes a IMPORT log file entry for a separator (a series of dashes).
protected static java.lang.String	qualifyMsgId(java.lang.String msgid) Returns the given message id with "MSG.Import." prefixed to it.
static void	setLogLevel(org.apache.log4j.Level severity) Sets the current log level for the IMPORT log.
static void	write(java.lang.String s) Writes a IMPORT log file entry for the given string.
static void	write(java.lang.String s, org.apache.log4j.Level severity) Writes a IMPORT log file entry for the given string and severity level.

Methods inherited from class com.dpslink.base.util.LogWriter

dumpPropertiesToFile, dumpPropertiesToList, getAlertLevel, getStackTrace, log, parseMessage, parseMessage, sendAlertEmail, setAlertLevel

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

The class' serialization version id.

See Also:

Constant Field Values

cvImportLog

private static org.apache.log4j.Logger cvImportLog

A reference to the IMPORT log file.

Constructor Detail

ImportLogWriter

public ImportLogWriter()

Method Detail

log

public static void log(java.lang.String msgid)

Writes a IMPORT log file entry for the given message id.

Parameters:

msgid - (String) The id for the message to log. The msgid is automatically prefixed with "MSG.Import.".

log

public static void log(java.lang.String msgid,
                       java.lang.String... values)

Writes a IMPORT log file entry for the given message id.

Parameters:

msgid - (String) The id for the message to log. The msgid is automatically prefixed with "MSG.Import.".

values - (String) The value(s) to replace in the message text. This parameter uses the varargs feature and can therefore be passed as multiple parms (msgid, value1, value2, value3, valueN) or as an array (msgid, values[]).

log

public static void log(java.lang.String msgid,
                       java.lang.Exception ex)

Writes a IMPORT log file entry for the given message id and exception. The exception stack trace is auto-appended to the end of the message with a line separator inserted between the message and the stack trace.

Parameters:

msgid - (String) The id for the message to log. The msgid is automatically prefixed with "MSG.Import.".

ex - (Exception) The exception to log.

log

public static void log(java.lang.String msgid,
                       java.lang.Exception ex,
                       java.lang.String... values)

Writes a IMPORT log file entry for the given message id and exception. The exception stack trace is auto-appended to the end of the message with a line separator inserted between the message and the stack trace.

Parameters:

msgid - (String) The id for the message to log. The msgid is automatically prefixed with "MSG.Import.".

ex - (Exception) The exception to log.

values - (String) The value(s) to replace in the message text. This parameter uses the varargs feature and can therefore be passed as multiple parms (msgid, value1, value2, value3, valueN) or as an array (msgid, values[]).

log

public static void log(java.lang.Exception e)

Writes a IMPORT log file entry for the given exception.

Parameters:

e - (Exception) The exception to log.

logMessage

protected static void logMessage(org.apache.log4j.Level severity,
                                 java.lang.String msgtext)

Writes a IMPORT log file entry for the given severity level and message text and sends an email if the message severity is configured for alert emails. Overrides logMessage in the shared LogWriter.

Parameters:

severity - (Level) The severity of the message. Must be one of the defined constants (DEBUG, INFO, WARN, ERROR or FATAL).

msgtext - (String) The text for the message to log and email.

logSeparator

public static void logSeparator()

Writes a IMPORT log file entry for a separator (a series of dashes). The separator is always logged using the logger's configured logging level. Typically used to denote the beginning of application startup.

getLogFileFolder

public static java.lang.String getLogFileFolder()

Returns the configured file path for IMPORT log files.

Returns:

String - The file path to the log file folder. Includes trailing file separator character.

getLogFileName

public static java.lang.String getLogFileName()

Returns the configured file name for IMPORT log files.

Returns:

String - The file name for log files.

getLogLevel

public static org.apache.log4j.Level getLogLevel()

Returns the current log level for the IMPORT log.

Returns:

Level - The current log level.

setLogLevel

public static void setLogLevel(org.apache.log4j.Level severity)

Sets the current log level for the IMPORT log.

Parameters:

severity - (Level) The current log level. Must be one of the defined constants (DEBUG, INFO, WARN, ERROR or FATAL) or OFF.

write

public static void write(java.lang.String s)

Writes a IMPORT log file entry for the given string. The severity level is assumed to be INFO.

Parameters:

s - (String) The string to write.

write

public static void write(java.lang.String s,
                         org.apache.log4j.Level severity)

Writes a IMPORT log file entry for the given string and severity level.

Parameters:

s - (String) The string to write.

severity - (Level) The severity of the message. Must be one of the defined constants (DEBUG, INFO, WARN, ERROR or FATAL).

qualifyMsgId

protected static java.lang.String qualifyMsgId(java.lang.String msgid)

Returns the given message id with "MSG.Import." prefixed to it.

Parameters:

msgid - (String) The id for the message to qualify.

Returns:

String - The qualified results.