Sometimes it is useful to see how log4cxx is reading configuration files. You can enable log4cxx internal logging by setting the debug
attribute in the log4cxx
element. As in
<log4j:configuration debug="true" xmlns:log4j="http://jakarta.apache.org/log4j/"> ... </log4j:configuration>
There are sample XML files included in the package.
void configure | ( | const String & | filename | ) | [static] |
A static version of doConfigure.
void configureAndWatch | ( | const String & | configFilename, | |
long | delay | |||
) | [static] |
Read the configuration file configFilename
if it exists. Moreover, a thread will be created that will periodically check if configFilename
has been created or modified. The period is determined by the delay
argument. If a change or file creation is detected, then configFilename
is read to configure log4cxx.
configFilename | A log4j configuration file in XML format. | |
delay | The delay in milliseconds to wait between each check. |
void configureAndWatch | ( | const String & | configFilename | ) | [static] |
Like configureAndWatch(const String& configFilename, long delay) except that the default delay as defined by FileWatchdog::DEFAULT_DELAY is used.
configFilename | A log4j configuration file in XML format. |
void doConfigure | ( | const String & | filename, | |
spi::LoggerRepositoryPtr & | repository | |||
) | [virtual] |
Interpret the XML file pointed by filename
and set up log4cxx accordingly.
The configuration is done relative to the hierarchy parameter.
filename | The file to parse. | |
repository | The hierarchy to operation upon. |
Implements Configurator.
AppenderPtr findAppenderByName | ( | helpers::XMLDOMDocumentPtr | doc, | |
const String & | appenderName | |||
) | [protected] |
Used internally to parse appenders by IDREF name.
AppenderPtr findAppenderByReference | ( | helpers::XMLDOMElementPtr | appenderRef | ) | [protected] |
Used internally to parse appenders by IDREF element.
void parse | ( | helpers::XMLDOMElementPtr | element | ) | [protected] |
Used internally to configure the log4cxx framework by parsing a DOM tree of XML elements based on log4j.dtd.
AppenderPtr parseAppender | ( | helpers::XMLDOMElementPtr | appenderElement | ) | [protected] |
Used internally to parse an appender element.
void parseChildrenOfLoggerElement | ( | helpers::XMLDOMElementPtr | catElement, | |
LoggerPtr | logger, | |||
bool | isRoot | |||
) | [protected] |
Used internally to parse the children of a category element.
void parseErrorHandler | ( | helpers::XMLDOMElementPtr | element, | |
AppenderPtr | appender | |||
) | [protected] |
Used internally to parse an ErrorHandler element.
void parseFilters | ( | helpers::XMLDOMElementPtr | element, | |
AppenderPtr | appender | |||
) | [protected] |
Used internally to parse a filter element.
LayoutPtr parseLayout | ( | helpers::XMLDOMElementPtr | layout_element | ) | [protected] |
Used internally to parse a layout element.
void parseLevel | ( | helpers::XMLDOMElementPtr | element, | |
LoggerPtr | logger, | |||
bool | isRoot | |||
) | [protected] |
Used internally to parse a level element.
void parseLogger | ( | helpers::XMLDOMElementPtr | loggerElement | ) | [protected] |
Used internally to parse a logger element.
void parseLoggerFactory | ( | helpers::XMLDOMElementPtr | factoryElement | ) | [protected] |
Used internally to parse the logger factory element.
void parseRoot | ( | helpers::XMLDOMElementPtr | rootElement | ) | [protected] |
Used internally to parse the roor category element.