blackboard.platform.log
Interface LogService

All Superinterfaces:

Log

public interface LogService
extends Log

Core platform service for managing different logs for messages from the application. Interaction with the actual log (writing messages, checking verbosity) is managed via the Log interface. This packages is meant to be generic enough to map to existing log facilities, such as java.util.logging or log4j.

Logs are maintained per application server when run in a load balanced environment. Verbosity goes from less to more messages: fatal, error, warning, information, debug.

Since:

Bb 5.5

Version:

$Revision: #1 $ $Date: 2005/06/27 $

See Also:

LogService.Verbosity

Nested Class Summary

static class

LogService.Verbosity Enumeration of different log levels used in filtering log messages.

Method Summary

void	defineNewFileLog(java.lang.String logName, java.lang.String logFilePath, LogService.Verbosity verbosity, BbLocale locale, boolean copyToConsole) Convenience method to create a new file-based log.
void	defineNewFileLog(java.lang.String logName, java.lang.String logFilePath, LogService.Verbosity verbosity, boolean copyToConsole) Convenience method to create a new file-based log.
Log	getConfiguredLog(java.lang.String logName) Returns a log that has been configured by name or null if one is not found.
Log	getDefaultLog() Returns the Log instance configured as the default Log
void	setDefaultLog(Log defaultLog) Sets the default Log instance to use.

Methods inherited from interface blackboard.platform.log.Log

getLogFileName, getLogName, getVerbosityLevel, log, log, logDebug, logDebug, logError, logError, logFatal, logFatal, logInfo, logInfo, logSqlWarnings, logSqlWarnings, logSqlWarnings, logSqlWarnings, logSqlWarnings, logWarning, logWarning, setVerbosityLevel

Method Detail

setDefaultLog

void setDefaultLog(Log defaultLog)

Sets the default Log instance to use.

Parameters:

defaultLog - Log instance to use

getDefaultLog

Log getDefaultLog()

Returns the Log instance configured as the default Log

Returns:

Default log

getConfiguredLog

Log getConfiguredLog(java.lang.String logName)

Returns a log that has been configured by name or null if one is not found.

Parameters:

logName - Log to retrieve.

Returns:

Log specified by logName or null if none is found.

defineNewFileLog

void defineNewFileLog(java.lang.String logName,
                      java.lang.String logFilePath,
                      LogService.Verbosity verbosity,
                      boolean copyToConsole)
                      throws BbServiceException

Convenience method to create a new file-based log.

Note: This method is primarily for internal use and should be considered unstable and subject to change.

Parameters:

logName - Symbolic name for the new log.

logFilePath - File name to hold log entries. Relative to Blackboard directory.

verbosity - Verbosity level

copyToConsole - Flag indicating whether to send log output to stdout as well

Throws:

BbServiceException

defineNewFileLog

void defineNewFileLog(java.lang.String logName,
                      java.lang.String logFilePath,
                      LogService.Verbosity verbosity,
                      BbLocale locale,
                      boolean copyToConsole)
                      throws BbServiceException

Convenience method to create a new file-based log.

Note: This method is primarily for internal use and should be considered unstable and subject to change.

Parameters:

logName - Symbolic name for the new log.

logFilePath - File name to hold log entries. Relative to Blackboard directory.

verbosity - Verbosity level

locale - Desired locale of log

copyToConsole - Flag indicating whether to send log output to stdout as well

Throws:

BbServiceException