概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし
概要:  内部クラス | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

org.apache.log4j.xml
クラス DOMConfigurator

java.lang.Object
  |
  +--org.apache.log4j.BasicConfigurator
        |
        +--org.apache.log4j.xml.DOMConfigurator
すべての実装インタフェース:
Configurator
public class DOMConfigurator
extends BasicConfigurator
implements Configurator

Use this class to initialize the log4j environment using a DOM tree.

DOM木を使って log4j の環境を初期化するためにこのクラスを使用します。

The DTD is specified in log4j.dtd.

DTDは、log4j.dtd内に指定されています。

Sometimes it is useful to see how log4j is reading configuration files. You can enable log4j internal logging by defining the log4j.debug variable on the java command line. Alternatively, set the debug attribute in the log4j:configuration element. As in

log4j がどのようにして設定ファイルを読み込んでいるのかを参照するのは、時には、役に立ちます。 あなたは、java コマンドライン上で、log4j.debug を定義することでlog4j の内部ロギングを可能にします。 その代わりとしては、log4j:configuration要素内の属性として debug を設定します。 内容は、以下のようになります。 

<log4j:configuration debug=true" xmlns:log4j="http://jakarta.apache.org/log4j/">
...
</log4j:configuration>

There are sample XML files included in the package.

パッケージ内にサンプルのXMLファイルが含まれています。

導入されたバージョン:
0.8.3
作成者:
Christopher Taylor, Ceki Gülcü, Anders Kristensen

クラス org.apache.log4j.BasicConfigurator から継承したフィールド
DISABLE_KEY, DISABLE_OVERRIDE_KEY, INHERITED
 
コンストラクタの概要
DOMConfigurator()
          No argument constructor.
 
メソッドの概要
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)
          A static version of doConfigure(String, Hierarchy).
static void configure(URL url)
          A static version of doConfigure(URL, Hierarchy).
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 inputStream, 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)
           
 
クラス org.apache.log4j.BasicConfigurator から継承したメソッド
addRenderer, configure, configure, disable, disable, disableAll, disableDebug, disableInfo, enableAll, resetConfiguration, resetConfiguration
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DOMConfigurator

public DOMConfigurator()
No argument constructor.

引数なしのコンストラクタ

メソッドの詳細

findAppenderByReference

protected Appender findAppenderByReference(org.w3c.dom.Element appenderRef)
Used internally to parse appenders by IDREF.

IDREF によって、アペンダを解析するために内部で使用されます。

parseAppender

protected Appender parseAppender(org.w3c.dom.Element appenderElement)
Used internally to parse an appender element.

アペンダの要素を解析するために内部で使用されます。

parseErrorHandler

protected void parseErrorHandler(org.w3c.dom.Element element,
                                 Appender appender)
Used internally to parse an ErrorHandler element.

ErrorHandler の要素を解析するために内部で使用されます。

parseFilters

protected void parseFilters(org.w3c.dom.Element element,
                            Appender appender)
Used internally to parse a filter element.

フィルタ要素を解析するために内部で使用されます。

parseCategory

protected void parseCategory(org.w3c.dom.Element categoryElement,
                             Hierarchy hierarchy)
Used internally to parse an category element.

カテゴリ要素を解析するために内部で使用されます。

parseRoot

protected void parseRoot(org.w3c.dom.Element rootElement,
                         Hierarchy hierarchy)
Used internally to parse the roor category element.

ルートカテゴリ要素を解析するために内部で使用されます。

parseChildrenOfCategoryElement

protected void parseChildrenOfCategoryElement(org.w3c.dom.Element catElement,
                                              Category cat,
                                              boolean isRoot)
Used internally to parse the children of a category element.

カテゴリの子要素を解析するために内部で使用されます。

parseLayout

protected Layout parseLayout(org.w3c.dom.Element layout_element)
Used internally to parse a layout element.

レイアウトの要素を解析するために内部で使用されます。

parseRenderer

protected void parseRenderer(org.w3c.dom.Element element,
                             Hierarchy hierarchy)

parsePriority

protected void parsePriority(org.w3c.dom.Element element,
                             Category cat,
                             boolean isRoot)
Used internally to parse a priority element.

優先度の要素を解析するために内部で使用されます。

setParameter

protected void setParameter(org.w3c.dom.Element elem,
                            PropertySetter propSetter)

configure

public static void configure(org.w3c.dom.Element element)
Configure log4j using a configuration element as defined in the log4j.dtd.

log4j.dtd内に定義されるような configuration 要素を使って log4j を設定します。

configureAndWatch

public static void configureAndWatch(String configFilename)
Like configureAndWatch(String, long) except that the default delay as defined by FileWatchdog.DEFAULT_DELAY is used.

FileWatchdog.DEFAULT_DELAY で定義されるデフォルトの間隔が使われることを除き、configureAndWatch(String, long) と同様です。

パラメータ:
configFilename - A log4j configuration file in XML format.

configFilename XMLフォーマットされているlog4jの設定ファイル

configureAndWatch

public static void configureAndWatch(String configFilename,
                                     long delay)
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 log4j.

もし、存在していれば、設定ファイル configFilename を読み込みます。 その上、もし、configFilename が作成または変更された場合は、定期的なチェックを行うスレッドが作られるでしょう。 定期的な間隔は、delay 引数で決定します。 もし、変更や、ファイルの作成が生じた場合は、configFilename が log4j を設定するために読み込まれます。

パラメータ:
configFilename - A log4j configuration file in XML format.

configFilename XMLフォーマットされているlog4jの設定ファイル

delay - The delay in milliseconds to wait between each check.

delay 各チェックで待たされるミリ秒で表す遅延間隔

doConfigure

public void doConfigure(String filename,
                        Hierarchy hierarchy)

doConfigure

public void doConfigure(URL url,
                        Hierarchy hierarchy)
インタフェース Configurator の記述:
Interpret a resource pointed by a URL and set up log4j accordingly.

URLで指定されたリソースを解釈し、それに従い、log4j を組み立てます。

The configuration is done relative to the hierarchy parameter.

設定内容は、hierarchyパラメタに関連しています。

定義:
インタフェース Configurator 内の doConfigure
インタフェース org.apache.log4j.spi.Configurator からコピーされたタグ:
パラメータ:
url - The URL to parse

url 解釈できるURL

hierarchy - The hierarchy to operation upon.

hierarchy オペレーション上の階層

doConfigure

public void doConfigure(InputStream inputStream,
                        Hierarchy hierarchy)
                 throws javax.xml.parsers.FactoryConfigurationError
Configure log4j by reading in a log4j.dtd compliant XML configuration file.

log4j.dtd に従い、XML設定ファイルを読み込むことにより、log4j を設定します。

configure

public static void configure(String filename)
                      throws javax.xml.parsers.FactoryConfigurationError
A static version of doConfigure(String, Hierarchy).

doConfigure(String, Hierarchy) のスタティック版です。

configure

public static void configure(URL url)
                      throws javax.xml.parsers.FactoryConfigurationError
A static version of doConfigure(URL, Hierarchy).

doConfigure(URL, Hierarchy) のスタティック版です。

parse

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. log4j.dtd をベースにした XML要素の DOM木を解析することにより、log4j のフレームワークを設定するために内部で使用されます。

subst

protected String subst(String value)
概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし
概要:  内部クラス | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド
Please notify me about new log4j releases.