|
Log4j 1.1b7 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.log4j.BasicConfigurator | +--org.apache.log4j.xml.DOMConfigurator
Use this class to initialize the log4j environment using a DOM tree.
The DTD is specified in log4j.dtd.
Sometimes it is useful to see how log4j is reading configuration files. You can enable log4j internal logging by defining the log4j.configDebug variable on the java command line.
There are sample XML files included in the package.
Fields inherited from class org.apache.log4j.BasicConfigurator |
DISABLE_KEY, DISABLE_OVERRIDE_KEY, INHERITED |
Constructor Summary | |
DOMConfigurator()
No argument constructor. |
Method Summary | |
static void |
configure(org.w3c.dom.Element element)
Configure log4j using a configuration element as
defined in the log4j.dtd. |
static void |
configure(String filename)
This is the static version of doConfigure(String, Hierarchy) .x |
static void |
configureAndWatch(String configFilename)
Like configureAndWatch(String, long) except that the
default delay as defined by FileWatchdog.DEFAULT_DELAY is
used. |
static void |
configureAndWatch(String configFilename,
long delay)
Read the configuration file configFilename if it
exists. |
void |
doConfigure(InputStream input,
Hierarchy hierarchy)
Configure log4j by reading in a log4j.dtd compliant XML configuration file. |
void |
doConfigure(String filename,
Hierarchy hierarchy)
|
void |
doConfigure(URL url,
Hierarchy hierarchy)
Interpret a resource pointed by a URL and set up log4j accordingly. |
protected Appender |
findAppenderByReference(org.w3c.dom.Element appenderRef)
Used internally to parse appenders by IDREF. |
protected void |
parse(org.w3c.dom.Element element,
Hierarchy hierarchy)
Used internally to configure the log4j framework by parsing a DOM tree of XML elements based on log4j.dtd. |
protected Appender |
parseAppender(org.w3c.dom.Element appenderElement)
Used internally to parse an appender element. |
protected void |
parseCategory(org.w3c.dom.Element categoryElement,
Hierarchy hierarchy)
Used internally to parse an category element. |
protected void |
parseChildrenOfCategoryElement(org.w3c.dom.Element catElement,
Category cat,
boolean isRoot)
Used internally to parse the children of a category element. |
protected void |
parseErrorHandler(org.w3c.dom.Element element,
Appender appender)
Used internally to parse an ErrorHandler element. |
protected void |
parseFilters(org.w3c.dom.Element element,
Appender appender)
Used internally to parse a filter element. |
protected Layout |
parseLayout(org.w3c.dom.Element layout_element)
Used internally to parse a layout element. |
protected void |
parsePriority(org.w3c.dom.Element element,
Category cat,
boolean isRoot)
Used internally to parse a priority element. |
protected void |
parseRenderer(org.w3c.dom.Element element,
Hierarchy hierarchy)
|
protected void |
parseRoot(org.w3c.dom.Element rootElement,
Hierarchy hierarchy)
Used internally to parse the roor category element. |
protected void |
setParameter(org.w3c.dom.Element elem,
PropertySetter propSetter)
|
protected String |
subst(String value)
|
Methods inherited from class org.apache.log4j.BasicConfigurator |
addRenderer, configure, configure, disable, disable, disableAll, disableDebug, disableInfo, enableAll, resetConfiguration, resetConfiguration |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DOMConfigurator()
Method Detail |
protected Appender findAppenderByReference(org.w3c.dom.Element appenderRef)
protected Appender parseAppender(org.w3c.dom.Element appenderElement)
protected void parseErrorHandler(org.w3c.dom.Element element, Appender appender)
ErrorHandler
element.protected void parseFilters(org.w3c.dom.Element element, Appender appender)
protected void parseCategory(org.w3c.dom.Element categoryElement, Hierarchy hierarchy)
protected void parseRoot(org.w3c.dom.Element rootElement, Hierarchy hierarchy)
protected void parseChildrenOfCategoryElement(org.w3c.dom.Element catElement, Category cat, boolean isRoot)
protected Layout parseLayout(org.w3c.dom.Element layout_element)
protected void parseRenderer(org.w3c.dom.Element element, Hierarchy hierarchy)
protected void parsePriority(org.w3c.dom.Element element, Category cat, boolean isRoot)
protected void setParameter(org.w3c.dom.Element elem, PropertySetter propSetter)
public static void configure(org.w3c.dom.Element element)
configuration
element as
defined in the log4j.dtd.public static void configureAndWatch(String configFilename)
configureAndWatch(String, long)
except that the
default delay as defined by FileWatchdog.DEFAULT_DELAY
is
used.configFilename
- A log4j configuration file in XML format.public static void configureAndWatch(String configFilename, long delay)
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 log4j.configFilename
- A log4j configuration file in XML format.delay
- The delay in milliseconds to wait between each check.public void doConfigure(String filename, Hierarchy hierarchy)
public void doConfigure(URL url, Hierarchy hierarchy)
Configurator
hierarchy
parameter.doConfigure
in interface Configurator
org.apache.log4j.spi.Configurator
url
- The URL to parsehierarchy
- The hierarchy to operation upon.public void doConfigure(InputStream input, Hierarchy hierarchy) throws javax.xml.parsers.FactoryConfigurationError
public static void configure(String filename) throws javax.xml.parsers.FactoryConfigurationError
doConfigure(String, Hierarchy)
.xprotected void parse(org.w3c.dom.Element element, Hierarchy hierarchy)
protected String subst(String value)
|
Log4j 1.1b7 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |