Logger Class Reference

Inherits AppenderAttachable, and ObjectImpl.

Inherited by RootLogger.

List of all members.


Detailed Description

This is the central class in the log4cxx package.

Most logging operations, except configuration, are done through this class.


Public Member Functions

 ~Logger ()
void addRef () const
void releaseRef () const
virtual void addAppender (const AppenderPtr &newAppender)
 Add newAppender to the list of appenders of this Logger instance.
void callAppenders (const log4cxx::spi::LoggingEventPtr &event, log4cxx::helpers::Pool &p) const
 Call the appenders in the hierrachy starting at this.
void closeNestedAppenders ()
 Close all attached appenders implementing the AppenderAttachable interface.
void debug (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the DEBUG level.
void debug (const std::string &msg) const
 Log a message string with the DEBUG level.
void debug (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the DEBUG level.
void debug (const std::wstring &msg) const
 Log a message string with the DEBUG level.
void debug (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the DEBUG level.
void debug (const std::basic_string< UniChar > &msg) const
 Log a message string with the DEBUG level.
void debug (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the DEBUG level.
void debug (const CFStringRef &msg) const
 Log a message string with the DEBUG level.
void error (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void error (const std::string &msg) const
 Log a message string with the ERROR level.
void error (const std::wstring &msg) const
 Log a message string with the ERROR level.
void error (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void error (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void error (const std::basic_string< UniChar > &msg) const
 Log a message string with the ERROR level.
void error (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void error (const CFStringRef &msg) const
 Log a message string with the ERROR level.
void fatal (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the FATAL level.
void fatal (const std::string &msg) const
 Log a message string with the ERROR level.
void fatal (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void fatal (const std::wstring &msg) const
 Log a message string with the ERROR level.
void fatal (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void fatal (const std::basic_string< UniChar > &msg) const
 Log a message string with the ERROR level.
void fatal (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the ERROR level.
void fatal (const CFStringRef &msg) const
 Log a message string with the ERROR level.
void forcedLog (const LevelPtr &level, const std::string &message, const log4cxx::spi::LocationInfo &location) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const std::string &message) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const std::wstring &message, const log4cxx::spi::LocationInfo &location) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const std::wstring &message) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const std::basic_string< UniChar > &message, const log4cxx::spi::LocationInfo &location) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const std::basic_string< UniChar > &message) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const CFStringRef &message, const log4cxx::spi::LocationInfo &location) const
 This method creates a new logging event and logs the event without further checks.
void forcedLog (const LevelPtr &level, const CFStringRef &message) const
 This method creates a new logging event and logs the event without further checks.
void forcedLogLS (const LevelPtr &level, const LogString &message, const log4cxx::spi::LocationInfo &location) const
 This method creates a new logging event and logs the event without further checks.
bool getAdditivity () const
 Get the additivity flag for this Logger instance.
AppenderList getAllAppenders () const
 Get the appenders contained in this logger as an AppenderList.
AppenderPtr getAppender (const LogString &name) const
 Look for the appender named as name.
virtual const LevelPtrgetEffectiveLevel () const
 Starting from this logger, search the logger hierarchy for a non-null level and return it.
log4cxx::spi::LoggerRepositoryPtr getLoggerRepository () const
 Return the the LoggerRepository where this Logger is attached.
const LogString getName () const
 Get the logger name.
void getName (std::string &name) const
 Get logger name in current encoding.
void getName (std::wstring &name) const
 Get logger name.
void getName (std::basic_string< UniChar > &name) const
 Get logger name.
void getName (CFStringRef &name) const
 Get logger name.
LoggerPtr getParent () const
 Returns the parent of this logger.
LevelPtr getLevel () const
 Returns the assigned Level, if any, for this Logger.
helpers::ResourceBundlePtr getResourceBundle () const
 Return the inherited ResourceBundle for this logger.
void info (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the INFO level.
void info (const std::string &msg) const
void info (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the INFO level.
void info (const std::wstring &msg) const
 Log a message string with the INFO level.
void info (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the INFO level.
void info (const std::basic_string< UniChar > &msg) const
 Log a message string with the INFO level.
void info (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the INFO level.
void info (const CFStringRef &msg) const
 Log a message string with the INFO level.
bool isAttached (const AppenderPtr &appender) const
 Is the appender passed as parameter attached to this logger?
bool isDebugEnabled () const
 Check whether this logger is enabled for the DEBUG Level.
bool isEnabledFor (const LevelPtr &level) const
 Check whether this logger is enabled for a given Level passed as parameter.
bool isInfoEnabled () const
 Check whether this logger is enabled for the info Level.
bool isWarnEnabled () const
 Check whether this logger is enabled for the warn Level.
bool isErrorEnabled () const
 Check whether this logger is enabled for the error Level.
bool isFatalEnabled () const
 Check whether this logger is enabled for the fatal Level.
bool isTraceEnabled () const
 Check whether this logger is enabled for the trace level.
void l7dlog (const LevelPtr &level, const LogString &key, const log4cxx::spi::LocationInfo &locationInfo, const std::vector< LogString > &values) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::string &key, const log4cxx::spi::LocationInfo &locationInfo) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::string &key, const log4cxx::spi::LocationInfo &locationInfo, const std::string &val1) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::string &key, const log4cxx::spi::LocationInfo &locationInfo, const std::string &val1, const std::string &val2) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::string &key, const log4cxx::spi::LocationInfo &locationInfo, const std::string &val1, const std::string &val2, const std::string &val3) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::wstring &key, const log4cxx::spi::LocationInfo &locationInfo) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::wstring &key, const log4cxx::spi::LocationInfo &locationInfo, const std::wstring &val1) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::wstring &key, const log4cxx::spi::LocationInfo &locationInfo, const std::wstring &val1, const std::wstring &val2) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::wstring &key, const log4cxx::spi::LocationInfo &locationInfo, const std::wstring &val1, const std::wstring &val2, const std::wstring &val3) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::basic_string< UniChar > &key, const log4cxx::spi::LocationInfo &locationInfo) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::basic_string< UniChar > &key, const log4cxx::spi::LocationInfo &locationInfo, const std::basic_string< UniChar > &val1) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::basic_string< UniChar > &key, const log4cxx::spi::LocationInfo &locationInfo, const std::basic_string< UniChar > &val1, const std::basic_string< UniChar > &val2) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const std::basic_string< UniChar > &key, const log4cxx::spi::LocationInfo &locationInfo, const std::basic_string< UniChar > &val1, const std::basic_string< UniChar > &val2, const std::basic_string< UniChar > &val3) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const CFStringRef &key, const log4cxx::spi::LocationInfo &locationInfo) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const CFStringRef &key, const log4cxx::spi::LocationInfo &locationInfo, const CFStringRef &val1) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const CFStringRef &key, const log4cxx::spi::LocationInfo &locationInfo, const CFStringRef &val1, const CFStringRef &val2) const
 Log a localized and parameterized message.
void l7dlog (const LevelPtr &level, const CFStringRef &key, const log4cxx::spi::LocationInfo &locationInfo, const CFStringRef &val1, const CFStringRef &val2, const CFStringRef &val3) const
 Log a localized and parameterized message.
void log (const LevelPtr &level, const std::string &message, const log4cxx::spi::LocationInfo &location) const
 This is the most generic printing method.
void log (const LevelPtr &level, const std::string &message) const
 This is the most generic printing method.
void log (const LevelPtr &level, const std::wstring &message, const log4cxx::spi::LocationInfo &location) const
 This is the most generic printing method.
void log (const LevelPtr &level, const std::wstring &message) const
 This is the most generic printing method.
void log (const LevelPtr &level, const std::basic_string< UniChar > &message, const log4cxx::spi::LocationInfo &location) const
 This is the most generic printing method.
void log (const LevelPtr &level, const std::basic_string< UniChar > &message) const
 This is the most generic printing method.
void log (const LevelPtr &level, const CFStringRef &message, const log4cxx::spi::LocationInfo &location) const
 This is the most generic printing method.
void log (const LevelPtr &level, const CFStringRef &message) const
 This is the most generic printing method.
void logLS (const LevelPtr &level, const LogString &message, const log4cxx::spi::LocationInfo &location) const
 This is the most generic printing method.
void removeAllAppenders ()
 Remove all previously added appenders from this logger instance.
void removeAppender (const AppenderPtr &appender)
 Remove the appender passed as parameter form the list of appenders.
void removeAppender (const LogString &name)
 Remove the appender with the name passed as parameter form the list of appenders.
void setAdditivity (bool additive)
 Set the additivity flag for this Logger instance.
virtual void setLevel (const LevelPtr &level)
 Set the level of this Logger.
void setResourceBundle (const helpers::ResourceBundlePtr &bundle)
 Set the resource bundle to be used with localized logging methods.
void warn (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the WARN level.
void warn (const std::wstring &msg) const
 Log a message string with the WARN level.
void warn (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the WARN level.
void warn (const std::basic_string< UniChar > &msg) const
 Log a message string with the WARN level.
void warn (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the WARN level.
void warn (const CFStringRef &msg) const
 Log a message string with the WARN level.
void warn (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the WARN level.
void warn (const std::string &msg) const
 Log a message string with the WARN level.
void trace (const std::wstring &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the TRACE level.
void trace (const std::wstring &msg) const
 Log a message string with the TRACE level.
void trace (const std::basic_string< UniChar > &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the TRACE level.
void trace (const std::basic_string< UniChar > &msg) const
 Log a message string with the TRACE level.
void trace (const CFStringRef &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the TRACE level.
void trace (const CFStringRef &msg) const
 Log a message string with the TRACE level.
void trace (const std::string &msg, const log4cxx::spi::LocationInfo &location) const
 Log a message string with the TRACE level.
void trace (const std::string &msg) const
 Log a message string with the TRACE level.
const log4cxx::helpers::MutexgetMutex () const

Static Public Member Functions

static LoggerPtr getLogger (const std::string &name)
 Retrieve a logger by name in current encoding.
static LoggerPtr getLogger (const char *const name)
 Retrieve a logger by name in current encoding.
static LoggerPtr getLogger (const std::wstring &name)
 Retrieve a logger by name.
static LoggerPtr getLogger (const wchar_t *const name)
 Retrieve a logger by name.
static LoggerPtr getLogger (const std::basic_string< UniChar > &name)
 Retrieve a logger by name.
static LoggerPtr getLogger (const CFStringRef &name)
 Retrieve a logger by name.
static LoggerPtr getLoggerLS (const LogString &name)
 Retrieve a logger by name in Unicode.
static LoggerPtr getRootLogger ()
 Retrieve the root logger.
static LoggerPtr getLoggerLS (const LogString &name, const log4cxx::spi::LoggerFactoryPtr &factory)
 Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.
static LoggerPtr getLogger (const std::string &name, const log4cxx::spi::LoggerFactoryPtr &factory)
 Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.
static LoggerPtr getLogger (const std::wstring &name, const log4cxx::spi::LoggerFactoryPtr &factory)
 Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.
static LoggerPtr getLogger (const std::basic_string< UniChar > &name, const log4cxx::spi::LoggerFactoryPtr &factory)
 Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.
static LoggerPtr getLogger (const CFStringRef &name, const log4cxx::spi::LoggerFactoryPtr &factory)
 Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

Protected Member Functions

 Logger (log4cxx::helpers::Pool &pool, const LogString &name)
 This constructor created a new logger instance and sets its name.
LogString getResourceBundleString (const LogString &key) const
 Returns the string resource coresponding to key in this logger's inherited resource bundle.
void setHierarchy (spi::LoggerRepository *repository)
 Only the Hierarchy class can set the hierarchy of a logger.

Protected Attributes

LogString name
 The name of this logger.
LevelPtr level
 The assigned level of this logger.
LoggerPtr parent
 The parent of this logger.
helpers::ResourceBundlePtr resourceBundle
 The resourceBundle for localized messages.
log4cxx::spi::LoggerRepositoryrepository
helpers::AppenderAttachableImplPtr aai
bool additive
 Additivity is set to true by default, that is children inherit the appenders of their ancestors by default.

Friends

class DefaultLoggerFactory
class Hierarchy
class log4cxx::helpers::synchronized


Constructor & Destructor Documentation

Logger log4cxx::helpers::Pool pool,
const LogString name
[protected]
 

This constructor created a new logger instance and sets its name.

It is intended to be used by sub-classes only. You should not create categories directly.

Parameters:
pool lifetime of pool must be longer than logger.
name The name of the logger.

~Logger  ) 
 


Member Function Documentation

virtual void addAppender const AppenderPtr newAppender  )  [virtual]
 

Add newAppender to the list of appenders of this Logger instance.

If newAppender is already in the list of appenders, then it won't be added again.

Implements AppenderAttachable.

void addRef  )  const [virtual]
 

Reimplemented from ObjectImpl.

void callAppenders const log4cxx::spi::LoggingEventPtr event,
log4cxx::helpers::Pool p
const
 

Call the appenders in the hierrachy starting at this.

If no appenders could be found, emit a warning.

This method calls all the appenders inherited from the hierarchy circumventing any evaluation of whether to log or not to log the particular log request.

Parameters:
event the event to log.
p memory pool for any allocations needed to process request.

void closeNestedAppenders  ) 
 

Close all attached appenders implementing the AppenderAttachable interface.

void debug const CFStringRef msg  )  const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void debug const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void debug const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void debug const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void debug const std::wstring &  msg  )  const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void debug const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void debug const std::string &  msg  )  const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void debug const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the DEBUG level.

This method first checks if this logger is DEBUG enabled by comparing the level of this logger with the DEBUG level. If this logger is DEBUG enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void error const CFStringRef msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void error const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void error const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void error const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void error const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void error const std::wstring &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void error const std::string &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void error const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void fatal const CFStringRef msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void fatal const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void fatal const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void fatal const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void fatal const std::wstring &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void fatal const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void fatal const std::string &  msg  )  const
 

Log a message string with the ERROR level.

This method first checks if this logger is ERROR enabled by comparing the level of this logger with the ERROR level. If this logger is ERROR enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void fatal const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the FATAL level.

This method first checks if this logger is FATAL enabled by comparing the level of this logger with the FATAL level. If this logger is FATAL enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void forcedLog const LevelPtr level,
const CFStringRef message
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.

void forcedLog const LevelPtr level,
const CFStringRef message,
const log4cxx::spi::LocationInfo location
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.
location location of source of logging request.

void forcedLog const LevelPtr level,
const std::basic_string< UniChar > &  message
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.

void forcedLog const LevelPtr level,
const std::basic_string< UniChar > &  message,
const log4cxx::spi::LocationInfo location
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.
location location of source of logging request.

void forcedLog const LevelPtr level,
const std::wstring &  message
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.

void forcedLog const LevelPtr level,
const std::wstring &  message,
const log4cxx::spi::LocationInfo location
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.
location location of source of logging request.

void forcedLog const LevelPtr level,
const std::string &  message
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.

void forcedLog const LevelPtr level,
const std::string &  message,
const log4cxx::spi::LocationInfo location
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message message.
location location of source of logging request.

void forcedLogLS const LevelPtr level,
const LogString message,
const log4cxx::spi::LocationInfo location
const
 

This method creates a new logging event and logs the event without further checks.

Parameters:
level the level to log.
message the message string to log.
location location of the logging statement.

bool getAdditivity  )  const
 

Get the additivity flag for this Logger instance.

AppenderList getAllAppenders  )  const [virtual]
 

Get the appenders contained in this logger as an AppenderList.

If no appenders can be found, then an empty AppenderList is returned.

Returns:
AppenderList An collection of the appenders in this logger.

Implements AppenderAttachable.

AppenderPtr getAppender const LogString name  )  const [virtual]
 

Look for the appender named as name.

Return the appender with that name if in the list. Return NULL otherwise.

Implements AppenderAttachable.

virtual const LevelPtr& getEffectiveLevel  )  const [virtual]
 

Starting from this logger, search the logger hierarchy for a non-null level and return it.

The Logger class is designed so that this method executes as quickly as possible.

Exceptions:
RuntimeException if all levels are null in the hierarchy

Reimplemented in RootLogger.

LevelPtr getLevel  )  const
 

Returns the assigned Level, if any, for this Logger.

Returns:
Level - the assigned Level, can be null.

static LoggerPtr getLogger const CFStringRef name,
const log4cxx::spi::LoggerFactoryPtr factory
[static]
 

Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

This method is intended to be used by sub-classes.

Parameters:
name The name of the logger to retrieve.
factory A LoggerFactory implementation that will actually create a new Instance.

static LoggerPtr getLogger const std::basic_string< UniChar > &  name,
const log4cxx::spi::LoggerFactoryPtr factory
[static]
 

Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

This method is intended to be used by sub-classes.

Parameters:
name The name of the logger to retrieve.
factory A LoggerFactory implementation that will actually create a new Instance.

static LoggerPtr getLogger const std::wstring &  name,
const log4cxx::spi::LoggerFactoryPtr factory
[static]
 

Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

This method is intended to be used by sub-classes.

Parameters:
name The name of the logger to retrieve.
factory A LoggerFactory implementation that will actually create a new Instance.

static LoggerPtr getLogger const std::string &  name,
const log4cxx::spi::LoggerFactoryPtr factory
[static]
 

Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

This method is intended to be used by sub-classes.

Parameters:
name The name of the logger to retrieve.
factory A LoggerFactory implementation that will actually create a new Instance.

static LoggerPtr getLogger const CFStringRef name  )  [static]
 

Retrieve a logger by name.

Parameters:
name logger name.

static LoggerPtr getLogger const std::basic_string< UniChar > &  name  )  [static]
 

Retrieve a logger by name.

Parameters:
name logger name.

static LoggerPtr getLogger const wchar_t *const   name  )  [static]
 

Retrieve a logger by name.

Parameters:
name logger name.

static LoggerPtr getLogger const std::wstring &  name  )  [static]
 

Retrieve a logger by name.

Parameters:
name logger name.

static LoggerPtr getLogger const char *const   name  )  [static]
 

Retrieve a logger by name in current encoding.

Parameters:
name logger name.

static LoggerPtr getLogger const std::string &  name  )  [static]
 

Retrieve a logger by name in current encoding.

Parameters:
name logger name.

static LoggerPtr getLoggerLS const LogString name,
const log4cxx::spi::LoggerFactoryPtr factory
[static]
 

Like getLogger except that the type of logger instantiated depends on the type returned by the LoggerFactory::makeNewLoggerInstance method of the factory parameter.

This method is intended to be used by sub-classes.

Parameters:
name The name of the logger to retrieve.
factory A LoggerFactory implementation that will actually create a new Instance.

static LoggerPtr getLoggerLS const LogString name  )  [static]
 

Retrieve a logger by name in Unicode.

Parameters:
name logger name.

log4cxx::spi::LoggerRepositoryPtr getLoggerRepository  )  const
 

Return the the LoggerRepository where this Logger is attached.

const log4cxx::helpers::Mutex& getMutex  )  const [inline]
 

void getName CFStringRef name  )  const
 

Get logger name.

Parameters:
name buffer to which name is appended.

void getName std::basic_string< UniChar > &  name  )  const
 

Get logger name.

Parameters:
name buffer to which name is appended.

void getName std::wstring &  name  )  const
 

Get logger name.

Parameters:
name buffer to which name is appended.

void getName std::string &  name  )  const
 

Get logger name in current encoding.

Parameters:
name buffer to which name is appended.

const LogString getName  )  const [inline]
 

Get the logger name.

Returns:
logger name as LogString.

LoggerPtr getParent  )  const
 

Returns the parent of this logger.

Note that the parent of a given logger may change during the lifetime of the logger.

The root logger will return 0.

helpers::ResourceBundlePtr getResourceBundle  )  const
 

Return the inherited ResourceBundle for this logger.

This method walks the hierarchy to find the appropriate resource bundle. It will return the resource bundle attached to the closest ancestor of this logger, much like the way priorities are searched. In case there is no bundle in the hierarchy then NULL is returned.

LogString getResourceBundleString const LogString key  )  const [protected]
 

Returns the string resource coresponding to key in this logger's inherited resource bundle.

If the resource cannot be found, then an error message will be logged complaining about the missing resource.

See also:
getResourceBundle.

static LoggerPtr getRootLogger  )  [static]
 

Retrieve the root logger.

void info const CFStringRef msg  )  const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void info const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void info const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void info const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void info const std::wstring &  msg  )  const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void info const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void info const std::string &  msg  )  const
 

void info const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the INFO level.

This method first checks if this logger is INFO enabled by comparing the level of this logger with the INFO level. If this logger is INFO enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

bool isAttached const AppenderPtr appender  )  const [virtual]
 

Is the appender passed as parameter attached to this logger?

Implements AppenderAttachable.

bool isDebugEnabled  )  const
 

Check whether this logger is enabled for the DEBUG Level.

This function is intended to lessen the computational cost of disabled log debug statements.

For some logger Logger object, when you write,

      logger->debug("debug message");
  

You incur the cost constructing the message, concatenation in this case, regardless of whether the message is logged or not.

If you are worried about speed, then you should write

    if(logger->isDebugEnabled()) {
      logger->debug("debug message");
    }
  

This way you will not incur the cost of parameter construction if debugging is disabled for logger. On the other hand, if the logger is debug enabled, you will incur the cost of evaluating whether the logger is debug enabled twice. Once in isDebugEnabled and once in the debug. This is an insignificant overhead since evaluating a logger takes about 1%% of the time it takes to actually log.

Returns:
bool - true if this logger is debug enabled, false otherwise.

bool isEnabledFor const LevelPtr level  )  const
 

Check whether this logger is enabled for a given Level passed as parameter.

See also isDebugEnabled.

Returns:
bool True if this logger is enabled for level.

bool isErrorEnabled  )  const
 

Check whether this logger is enabled for the error Level.

See also isDebugEnabled.

Returns:
bool - true if this logger is enabled for level error, false otherwise.

bool isFatalEnabled  )  const
 

Check whether this logger is enabled for the fatal Level.

See also isDebugEnabled.

Returns:
bool - true if this logger is enabled for level fatal, false otherwise.

bool isInfoEnabled  )  const
 

Check whether this logger is enabled for the info Level.

See also isDebugEnabled.

Returns:
bool - true if this logger is enabled for level info, false otherwise.

bool isTraceEnabled  )  const
 

Check whether this logger is enabled for the trace level.

See also isDebugEnabled.

Returns:
bool - true if this logger is enabled for level trace, false otherwise.

bool isWarnEnabled  )  const
 

Check whether this logger is enabled for the warn Level.

See also isDebugEnabled.

Returns:
bool - true if this logger is enabled for level warn, false otherwise.

void l7dlog const LevelPtr level,
const CFStringRef key,
const log4cxx::spi::LocationInfo locationInfo,
const CFStringRef val1,
const CFStringRef val2,
const CFStringRef val3
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
val3 The value for the third placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const CFStringRef key,
const log4cxx::spi::LocationInfo locationInfo,
const CFStringRef val1,
const CFStringRef val2
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const CFStringRef key,
const log4cxx::spi::LocationInfo locationInfo,
const CFStringRef val1
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const CFStringRef key,
const log4cxx::spi::LocationInfo locationInfo
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::basic_string< UniChar > &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::basic_string< UniChar > &  val1,
const std::basic_string< UniChar > &  val2,
const std::basic_string< UniChar > &  val3
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
val3 The value for the third placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::basic_string< UniChar > &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::basic_string< UniChar > &  val1,
const std::basic_string< UniChar > &  val2
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::basic_string< UniChar > &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::basic_string< UniChar > &  val1
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::basic_string< UniChar > &  key,
const log4cxx::spi::LocationInfo locationInfo
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::wstring &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::wstring &  val1,
const std::wstring &  val2,
const std::wstring &  val3
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
val3 The value for the third placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::wstring &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::wstring &  val1,
const std::wstring &  val2
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::wstring &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::wstring &  val1
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::wstring &  key,
const log4cxx::spi::LocationInfo locationInfo
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::string &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::string &  val1,
const std::string &  val2,
const std::string &  val3
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The value for the first placeholder within the pattern.
val2 The value for the second placeholder within the pattern.
val3 The value for the third placeholder within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::string &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::string &  val1,
const std::string &  val2
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The first value for the placeholders within the pattern.
val2 The second value for the placeholders within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::string &  key,
const log4cxx::spi::LocationInfo locationInfo,
const std::string &  val1
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
val1 The first value for the placeholders within the pattern.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const std::string &  key,
const log4cxx::spi::LocationInfo locationInfo
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
See also:
setResourceBundle

void l7dlog const LevelPtr level,
const LogString key,
const log4cxx::spi::LocationInfo locationInfo,
const std::vector< LogString > &  values
const
 

Log a localized and parameterized message.

First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using helpers::StringHelper::format method with the user supplied string array params.

Parameters:
level The level of the logging request.
key The key to be searched in the ResourceBundle.
locationInfo The location info of the logging request.
values The values for the placeholders {0}, {1} etc. within the pattern.
See also:
setResourceBundle

void log const LevelPtr level,
const CFStringRef message
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.

void log const LevelPtr level,
const CFStringRef message,
const log4cxx::spi::LocationInfo location
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.
location The source file of the logging request, may be null.

void log const LevelPtr level,
const std::basic_string< UniChar > &  message
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.

void log const LevelPtr level,
const std::basic_string< UniChar > &  message,
const log4cxx::spi::LocationInfo location
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.
location The source file of the logging request, may be null.

void log const LevelPtr level,
const std::wstring &  message
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.

void log const LevelPtr level,
const std::wstring &  message,
const log4cxx::spi::LocationInfo location
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.
location The source file of the logging request, may be null.

void log const LevelPtr level,
const std::string &  message
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.

void log const LevelPtr level,
const std::string &  message,
const log4cxx::spi::LocationInfo location
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.
location The source file of the logging request, may be null.

void logLS const LevelPtr level,
const LogString message,
const log4cxx::spi::LocationInfo location
const
 

This is the most generic printing method.

It is intended to be invoked by wrapper classes.

Parameters:
level The level of the logging request.
message The message of the logging request.
location The source file of the logging request, may be null.

void releaseRef  )  const [virtual]
 

Reimplemented from ObjectImpl.

void removeAllAppenders  )  [virtual]
 

Remove all previously added appenders from this logger instance.

This is useful when re-reading configuration information.

Implements AppenderAttachable.

void removeAppender const LogString name  )  [virtual]
 

Remove the appender with the name passed as parameter form the list of appenders.

Implements AppenderAttachable.

void removeAppender const AppenderPtr appender  )  [virtual]
 

Remove the appender passed as parameter form the list of appenders.

Implements AppenderAttachable.

void setAdditivity bool  additive  ) 
 

Set the additivity flag for this Logger instance.

void setHierarchy spi::LoggerRepository repository  )  [protected]
 

Only the Hierarchy class can set the hierarchy of a logger.

virtual void setLevel const LevelPtr level  )  [virtual]
 

Set the level of this Logger.

As in

    logger->setLevel(Level::getDebug()); 

Null values are admitted.

Reimplemented in RootLogger.

void setResourceBundle const helpers::ResourceBundlePtr &  bundle  )  [inline]
 

Set the resource bundle to be used with localized logging methods.

void trace const std::string &  msg  )  const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void trace const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void trace const CFStringRef msg  )  const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void trace const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void trace const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void trace const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void trace const std::wstring &  msg  )  const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void trace const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the TRACE level.

This method first checks if this logger is TRACE enabled by comparing the level of this logger with the TRACE level. If this logger is TRACE enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void warn const std::string &  msg  )  const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void warn const std::string &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void warn const CFStringRef msg  )  const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void warn const CFStringRef msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void warn const std::basic_string< UniChar > &  msg  )  const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void warn const std::basic_string< UniChar > &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.

void warn const std::wstring &  msg  )  const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.

void warn const std::wstring &  msg,
const log4cxx::spi::LocationInfo location
const
 

Log a message string with the WARN level.

This method first checks if this logger is WARN enabled by comparing the level of this logger with the WARN level. If this logger is WARN enabled, it proceeds to call all the registered appenders in this logger and also higher in the hierarchy depending on the value of the additivity flag.

Parameters:
msg the message string to log.
location location of source of logging request.


Friends And Related Function Documentation

friend class DefaultLoggerFactory [friend]
 

friend class Hierarchy [friend]
 

friend class log4cxx::helpers::synchronized [friend]
 


Member Data Documentation

helpers::AppenderAttachableImplPtr aai [protected]
 

bool additive [protected]
 

Additivity is set to true by default, that is children inherit the appenders of their ancestors by default.

If this variable is set to false then the appenders found in the ancestors of this logger are not used. However, the children of this logger will inherit its appenders, unless the children have their additivity flag set to false too. See the user manual for more details.

LevelPtr level [protected]
 

The assigned level of this logger.

The level variable need not be assigned a value in which case it is inherited form the hierarchy.

LogString name [protected]
 

The name of this logger.

LoggerPtr parent [protected]
 

The parent of this logger.

All loggers have at least one ancestor which is the root logger.

log4cxx::spi::LoggerRepository* repository [protected]
 

helpers::ResourceBundlePtr resourceBundle [protected]
 

The resourceBundle for localized messages.

See also:
setResourceBundle, getResourceBundle


The documentation for this class was generated from the following file: