1 |
<?xml version="1.0" encoding="UTF-8" ?> |
2 |
|
3 |
<!-- Authors: Chris Taylor, Ceki Gulcu. --> |
4 |
|
5 |
<!-- Version: 1.2 --> |
6 |
|
7 |
<!-- A configuration element consists of optional renderer |
8 |
elements,appender elements, categories and an optional root |
9 |
element. --> |
10 |
|
11 |
<!ELEMENT log4j:configuration (renderer*, appender*,(category|logger)*,root?, |
12 |
categoryFactory?)> |
13 |
|
14 |
<!-- The "threshold" attribute takes a level value such that all --> |
15 |
<!-- logging statements with a level equal or below this value are --> |
16 |
<!-- disabled. --> |
17 |
|
18 |
<!-- Setting the "debug" enable the printing of internal log4j logging --> |
19 |
<!-- statements. --> |
20 |
|
21 |
<!-- By default, debug attribute is "null", meaning that we not do touch --> |
22 |
<!-- internal log4j logging settings. The "null" value for the threshold --> |
23 |
<!-- attribute can be misleading. The threshold field of a repository --> |
24 |
<!-- cannot be set to null. The "null" value for the threshold attribute --> |
25 |
<!-- simply means don't touch the threshold field, the threshold field --> |
26 |
<!-- keeps its old value. --> |
27 |
|
28 |
<!ATTLIST log4j:configuration |
29 |
xmlns:log4j CDATA #FIXED "http://jakarta.apache.org/log4j/" |
30 |
threshold (all|debug|info|warn|error|fatal|off|null) "null" |
31 |
debug (true|false|null) "null" |
32 |
> |
33 |
|
34 |
<!-- renderer elements allow the user to customize the conversion of --> |
35 |
<!-- message objects to String. --> |
36 |
|
37 |
<!ELEMENT renderer EMPTY> |
38 |
<!ATTLIST renderer |
39 |
renderedClass CDATA #REQUIRED |
40 |
renderingClass CDATA #REQUIRED |
41 |
> |
42 |
|
43 |
<!-- Appenders must have a name and a class. --> |
44 |
<!-- Appenders may contain an error handler, a layout, optional parameters --> |
45 |
<!-- and filters. They may also reference (or include) other appenders. --> |
46 |
<!ELEMENT appender (errorHandler?, param*, layout?, filter*, appender-ref*)> |
47 |
<!ATTLIST appender |
48 |
name ID #REQUIRED |
49 |
class CDATA #REQUIRED |
50 |
> |
51 |
|
52 |
<!ELEMENT layout (param*)> |
53 |
<!ATTLIST layout |
54 |
class CDATA #REQUIRED |
55 |
> |
56 |
|
57 |
<!ELEMENT filter (param*)> |
58 |
<!ATTLIST filter |
59 |
class CDATA #REQUIRED |
60 |
> |
61 |
|
62 |
<!-- ErrorHandlers can be of any class. They can admit any number of --> |
63 |
<!-- parameters. --> |
64 |
|
65 |
<!ELEMENT errorHandler (param*, root-ref?, logger-ref*, appender-ref?)> |
66 |
<!ATTLIST errorHandler |
67 |
class CDATA #REQUIRED |
68 |
> |
69 |
|
70 |
<!ELEMENT root-ref EMPTY> |
71 |
|
72 |
<!ELEMENT logger-ref EMPTY> |
73 |
<!ATTLIST logger-ref |
74 |
ref IDREF #REQUIRED |
75 |
> |
76 |
|
77 |
<!ELEMENT param EMPTY> |
78 |
<!ATTLIST param |
79 |
name CDATA #REQUIRED |
80 |
value CDATA #REQUIRED |
81 |
> |
82 |
|
83 |
|
84 |
<!-- The priority class is org.apache.log4j.Level by default --> |
85 |
<!ELEMENT priority (param*)> |
86 |
<!ATTLIST priority |
87 |
class CDATA #IMPLIED |
88 |
value CDATA #REQUIRED |
89 |
> |
90 |
|
91 |
<!-- The level class is org.apache.log4j.Level by default --> |
92 |
<!ELEMENT level (param*)> |
93 |
<!ATTLIST level |
94 |
class CDATA #IMPLIED |
95 |
value CDATA #REQUIRED |
96 |
> |
97 |
|
98 |
|
99 |
<!-- If no level element is specified, then the configurator MUST not --> |
100 |
<!-- touch the level of the named category. --> |
101 |
<!ELEMENT category (param*,(priority|level)?,appender-ref*)> |
102 |
<!ATTLIST category |
103 |
class CDATA #IMPLIED |
104 |
name CDATA #REQUIRED |
105 |
additivity (true|false) "true" |
106 |
> |
107 |
|
108 |
<!-- If no level element is specified, then the configurator MUST not --> |
109 |
<!-- touch the level of the named logger. --> |
110 |
<!ELEMENT logger (level?,appender-ref*)> |
111 |
<!ATTLIST logger |
112 |
name ID #REQUIRED |
113 |
additivity (true|false) "true" |
114 |
> |
115 |
|
116 |
|
117 |
<!ELEMENT categoryFactory (param*)> |
118 |
<!ATTLIST categoryFactory |
119 |
class CDATA #REQUIRED> |
120 |
|
121 |
<!ELEMENT appender-ref EMPTY> |
122 |
<!ATTLIST appender-ref |
123 |
ref IDREF #REQUIRED |
124 |
> |
125 |
|
126 |
<!-- If no priority element is specified, then the configurator MUST not --> |
127 |
<!-- touch the priority of root. --> |
128 |
<!-- The root category always exists and cannot be subclassed. --> |
129 |
<!ELEMENT root (param*, (priority|level)?, appender-ref*)> |
130 |
|
131 |
|
132 |
<!-- ==================================================================== --> |
133 |
<!-- A logging event --> |
134 |
<!-- ==================================================================== --> |
135 |
<!ELEMENT log4j:eventSet (log4j:event*)> |
136 |
<!ATTLIST log4j:eventSet |
137 |
xmlns:log4j CDATA #FIXED "http://jakarta.apache.org/log4j/" |
138 |
version (1.1|1.2) "1.2" |
139 |
includesLocationInfo (true|false) "true" |
140 |
> |
141 |
|
142 |
|
143 |
|
144 |
<!ELEMENT log4j:event (log4j:message, log4j:NDC?, log4j:throwable?, |
145 |
log4j:locationInfo?) > |
146 |
|
147 |
<!-- The timestamp format is application dependent. --> |
148 |
<!ATTLIST log4j:event |
149 |
logger CDATA #REQUIRED |
150 |
level CDATA #REQUIRED |
151 |
thread CDATA #REQUIRED |
152 |
timestamp CDATA #REQUIRED |
153 |
> |
154 |
|
155 |
<!ELEMENT log4j:message (#PCDATA)> |
156 |
<!ELEMENT log4j:NDC (#PCDATA)> |
157 |
|
158 |
<!ELEMENT log4j:throwable (#PCDATA)> |
159 |
|
160 |
<!ELEMENT log4j:locationInfo EMPTY> |
161 |
<!ATTLIST log4j:locationInfo |
162 |
class CDATA #REQUIRED |
163 |
method CDATA #REQUIRED |
164 |
file CDATA #REQUIRED |
165 |
line CDATA #REQUIRED |
166 |
> |