Apache Log4cxx: log4cxx::LogManager Class Reference (original) (raw)

Use the [LogManager](classlog4cxx%5F1%5F1LogManager.html "Use the LogManager class to retreive Logger instances or to operate on the current LoggerRepository.") class to retreive Logger instances or to operate on the current [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html). More...

#include <[logmanager.h](logmanager%5F8h%5Fsource.html)>

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 the default factory 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)
	A pointer to the Logger name instance if it exists in the LoggerRepository.

static LoggerPtr	getLogger (const std::wstring &name)
	Retrieve the name Logger instance from the LoggerRepository using the default factory 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)
	A pointer to the Logger name instance if it exists in the LoggerRepository.

static LoggerPtr	getLogger (const std::basic_string< UniChar > &name)
	Retrieve the name Logger instance from the LoggerRepository using the default factory 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)
	A pointer to the Logger name instance if it exists in the LoggerRepository.

static LoggerPtr	getLogger (const CFStringRef &name)
	Retrieve the name Logger instance from the LoggerRepository using the default factory 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)
	A pointer to the Logger name instance if it exists in the LoggerRepository.

static LoggerPtr	getLoggerLS (const LogString &name)
	Retrieve the name Logger instance from the LoggerRepository using the default factory 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)
	A pointer to the Logger name instance if it exists in the LoggerRepository.

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 LoggerRepository to their default.

static bool	removeLogger (const LogString &name, bool ifNotUsed=true)
	Remove the name Logger from the 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.

◆ exists() [1/4]

◆ exists() [2/4]

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

◆ exists() [3/4]

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

◆ exists() [4/4]

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

◆ existsLS()

◆ getCurrentLoggers()

static LoggerList log4cxx::LogManager::getCurrentLoggers ( )	static

◆ getLogger() [1/8]

◆ getLogger() [2/8]

◆ getLogger() [3/8]

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

◆ getLogger() [4/8]

◆ getLogger() [5/8]

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

◆ getLogger() [6/8]

◆ getLogger() [7/8]

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

◆ getLogger() [8/8]

◆ getLoggerLS() [1/2]

◆ getLoggerLS() [2/2]

◆ getLoggerRepository()

◆ getRootLogger()

static LoggerPtr log4cxx::LogManager::getRootLogger ( )	static

◆ removeLogger()

static bool log4cxx::LogManager::removeLogger ( const LogString & name, bool ifNotUsed = true )	static

Remove the name Logger from the [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html).

Note: The name Logger must be retrieved from the [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html) after any subsequent configuration file change for the newly loaded settings to be used.

Parameters

name	The logger to remove.
ifNotUsed	If true and use_count() indicates there are other references, do not remove the Logger and return false.

Returns

true if name Logger was removed from the [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html).

◆ resetConfiguration()

static void log4cxx::LogManager::resetConfiguration ( )	static

Reset all values contained in this current [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html) to their default.

◆ setRepositorySelector()

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

Use selector to source the [LoggerRepository](classlog4cxx%5F1%5F1spi%5F1%5F1LoggerRepository.html), 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](classlog4cxx%5F1%5F1helpers%5F1%5F1IllegalArgumentException.html), unless the previously set guard is passed as the second parameter.

This allows a high-level component to set the [RepositorySelector](classlog4cxx%5F1%5F1spi%5F1%5F1RepositorySelector.html) used by the LogManager.

◆ shutdown()

static void log4cxx::LogManager::shutdown ( )	static

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

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

logmanager.h