LogTarget Class Reference

#include <Pt/System/LogTarget.h>

Target of log-messages. More...

Inherits NonCopyable.

Public Member Functions

virtual ~LogTarget ()
 Destructor.
 
std::string channelUrl () const
 Returns the URL of the channel used by the target.
 
void log (const LogRecord &record)
 Write log record to this target.
 
int logLevel () const
 Returns the log level of the target.
 
const std::string & name () const
 Returns the name of the target.
 
void setChannel (const std::string &url)
 Sets the channel to be used by this target. More...
 
void setLogLevel (LogLevel level)
 Sets the log-level of the target and its children. More...
 

Static Public Member Functions

static LogTargetget (const std::string &name)
 Get a target from the logging manager. More...
 

Detailed Description

The logging manager singleton maintains a hierachy of log targets, which is used to route the log records to a channel. To add an instance to this hierachy use the static LogTarget::get method. The scheme of the target category name follows the property dot-syntax. If there is a target foobar.ping and a target foobar.pong it means that ping and pong are children of the foobar target, which is a child of the root target.

Targets are not used directly, but by the loggers in an application. Once a target is created, a channel can be assigned to it. If no channel is assigned to a target, it will use the channel of the next of its parent targets. Each target also has a log level which is used by the logger to determine if a record should be sent to a target.

Member Function Documentation

void setLogLevel ( LogLevel  level)

This method is thread-safe. The log-level can also be set in the settings file of the used for initialization. All children of this target inherit the given LogLevel unless they are already set to a log level explicitly i.e. this method has een called on a child before.

void setChannel ( const std::string &  url)

Throws a invalid_argument exception if the channel can not be created. This function might block until the channel could be opened. This method is thread-safe. The channel can also be set in the properties file of the logging-manager.

static LogTarget& get ( const std::string &  name)
static

The target is created if it does not exist, otherwise the existing target is returned. If the target is created it is initialised with the properties from the configuration file of the loggin manager. This method is thread-safe.