log4cxx::LogManager Class Reference

Use the LogManager class to retreive Logger instances or to operate on the current LoggerRepository. More...

#include <logmanager.h>

Static Public Member Functions
static void	setRepositorySelector (spi::RepositorySelectorPtr selector, void *guard)
	Use selector to source the LoggerRepository, but only if the correct guard is passed as parameter.
static spi::LoggerRepositoryPtr	getLoggerRepository ()
static LoggerPtr	getRootLogger ()
	Retrieve the root logger from the LoggerRepository.
static LoggerPtr	getLogger (const std::string &name)
	Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.
static LoggerPtr	getLogger (const std::string &name, const spi::LoggerFactoryPtr &factory)
	Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.
static LoggerPtr	exists (const std::string &name)
	Does the logger name exist in the hierarchy?
static LoggerPtr	getLogger (const std::wstring &name)
	Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.
static LoggerPtr	getLogger (const std::wstring &name, const spi::LoggerFactoryPtr &factory)
	Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.
static LoggerPtr	exists (const std::wstring &name)
	Does the logger name exist in the hierarchy?
static LoggerPtr	getLogger (const std::basic_string< UniChar > &name)
	Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.
static LoggerPtr	getLogger (const std::basic_string< UniChar > &name, const spi::LoggerFactoryPtr &factory)
	Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.
static LoggerPtr	exists (const std::basic_string< UniChar > &name)
	Does the logger name exist in the hierarchy?
static LoggerPtr	getLogger (const CFStringRef &name)
	Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.
static LoggerPtr	getLogger (const CFStringRef &name, const spi::LoggerFactoryPtr &factory)
	Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.
static LoggerPtr	exists (const CFStringRef &name)
	Does the logger name exist in the hierarchy?
static LoggerPtr	getLoggerLS (const LogString &name)
	Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.
static LoggerPtr	getLoggerLS (const LogString &name, const spi::LoggerFactoryPtr &factory)
	Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.
static LoggerPtr	existsLS (const LogString &name)
	Does the logger name exist in the hierarchy?
static LoggerList	getCurrentLoggers ()
static void	shutdown ()
	Safely close and remove all appenders in all loggers including the root logger.
static void	resetConfiguration ()
	Reset all values contained in this current LoggerRepository61 to their default.

Detailed Description

Use the LogManager class to retreive Logger instances or to operate on the current LoggerRepository.

DefaultConfigurator::configure will be used to configure LoggerRepository when the first logger is retrieved if it is not already configured.

Examples

com/foo/config3.cpp.

Member Function Documentation

exists() [1/4]

static LoggerPtr log4cxx::LogManager::exists ( const CFStringRef &  name )

static

Does the logger name exist in the hierarchy?

exists() [2/4]

static LoggerPtr log4cxx::LogManager::exists ( const std::basic_string< UniChar > &  name )

static

Does the logger name exist in the hierarchy?

exists() [3/4]

static LoggerPtr log4cxx::LogManager::exists ( const std::string &  name )

static

Does the logger name exist in the hierarchy?

exists() [4/4]

static LoggerPtr log4cxx::LogManager::exists ( const std::wstring &  name )

static

Does the logger name exist in the hierarchy?

existsLS()

static LoggerPtr log4cxx::LogManager::existsLS ( const LogString &  name )

static

Does the logger name exist in the hierarchy?

getCurrentLoggers()

static LoggerList log4cxx::LogManager::getCurrentLoggers ( )

static

getLogger() [1/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const CFStringRef &  name )

static

Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [2/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const CFStringRef &  name, const spi::LoggerFactoryPtr &  factory  )

static

Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [3/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::basic_string< UniChar > &  name )

static

Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [4/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::basic_string< UniChar > &  name, const spi::LoggerFactoryPtr &  factory  )

static

Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [5/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::string &  name )

static

Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [6/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::string &  name, const spi::LoggerFactoryPtr &  factory  )

static

Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [7/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::wstring &  name )

static

Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLogger() [8/8]

static LoggerPtr log4cxx::LogManager::getLogger ( const std::wstring &  name, const spi::LoggerFactoryPtr &  factory  )

static

Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLoggerLS() [1/2]

static LoggerPtr log4cxx::LogManager::getLoggerLS ( const LogString &  name )

static

Retrieve the name Logger instance from the LoggerRepository using DefaultLoggerFactory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLoggerLS() [2/2]

static LoggerPtr log4cxx::LogManager::getLoggerLS ( const LogString &  name, const spi::LoggerFactoryPtr &  factory  )

static

Retrieve the name Logger instance from the LoggerRepository using factory to create it if required.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

getLoggerRepository()

static spi::LoggerRepositoryPtr log4cxx::LogManager::getLoggerRepository ( )

static

getRootLogger()

static LoggerPtr log4cxx::LogManager::getRootLogger ( )

static

Retrieve the root logger from the LoggerRepository.

Calls ensureIsConfigured passing DefaultConfigurator::configure to ensure the repository is configured.

Examples

com/foo/config3.cpp.

resetConfiguration()

static void log4cxx::LogManager::resetConfiguration ( )

static

Reset all values contained in this current LoggerRepository61 to their default.

setRepositorySelector()

static void log4cxx::LogManager::setRepositorySelector ( spi::RepositorySelectorPtr  selector, void *  guard  )

static

Use selector to source the LoggerRepository, but only if the correct guard is passed as parameter.

Initally the guard is null. If the guard is null, then invoking this method sets the logger factory and the guard. Following invocations will throw a IllegalArgumentException, unless the previously set guard is passed as the second parameter.

This allows a high-level component to set the RepositorySelector used by the LogManager.

shutdown()

static void log4cxx::LogManager::shutdown ( )

static

Safely close and remove all appenders in all loggers including the root logger.

Examples

com/foo/config3.cpp.

---

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

• logmanager.h