log4r 1.1.6 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README +3 -3
- data/Rakefile +2 -2
- data/doc/rdoc/Log4r.html +519 -0
- data/doc/rdoc/Log4r/BasicFormatter.html +388 -0
- data/doc/rdoc/Log4r/ConfigError.html +225 -0
- data/doc/rdoc/Log4r/Configurator.html +1068 -0
- data/doc/rdoc/Log4r/DateFileOutputter.html +479 -0
- data/doc/rdoc/Log4r/DefaultFormatter.html +223 -0
- data/doc/rdoc/Log4r/EmailOutputter.html +654 -0
- data/doc/rdoc/Log4r/FileOutputter.html +346 -0
- data/doc/rdoc/Log4r/Formatter.html +309 -0
- data/doc/rdoc/Log4r/GDC.html +346 -0
- data/doc/rdoc/Log4r/GDC_rb.html +80 -0
- data/doc/rdoc/Log4r/IOOutputter.html +410 -0
- data/doc/rdoc/Log4r/Log4jXmlFormatter.html +337 -0
- data/doc/rdoc/Log4r/Log4rConfig.html +211 -0
- data/doc/rdoc/Log4r/Log4rTools.html +388 -0
- data/doc/rdoc/Log4r/LogEvent.html +378 -0
- data/doc/rdoc/Log4r/LogServer.html +340 -0
- data/doc/rdoc/Log4r/Logger.html +1150 -0
- data/doc/rdoc/Log4r/Logger/LoggerFactory.html +218 -0
- data/doc/rdoc/Log4r/Logger/Repository.html +225 -0
- data/doc/rdoc/Log4r/MDC.html +424 -0
- data/doc/rdoc/Log4r/MDC_rb.html +83 -0
- data/doc/rdoc/Log4r/NDC.html +632 -0
- data/doc/rdoc/Log4r/NDC_rb.html +110 -0
- data/doc/rdoc/Log4r/ObjectFormatter.html +280 -0
- data/doc/rdoc/Log4r/Outputter.html +934 -0
- data/doc/rdoc/Log4r/Outputter/OutputterFactory.html +218 -0
- data/doc/rdoc/Log4r/Outputter/consoleoutputters_rb.html +57 -0
- data/doc/rdoc/Log4r/Outputter/datefileoutputter_rb.html +93 -0
- data/doc/rdoc/Log4r/Outputter/emailoutputter_rb.html +179 -0
- data/doc/rdoc/Log4r/Outputter/fileoutputter_rb.html +64 -0
- data/doc/rdoc/Log4r/Outputter/iooutputter_rb.html +59 -0
- data/doc/rdoc/Log4r/Outputter/outputter_rb.html +222 -0
- data/doc/rdoc/Log4r/Outputter/outputterfactory_rb.html +62 -0
- data/doc/rdoc/Log4r/Outputter/remoteoutputter_rb.html +59 -0
- data/doc/rdoc/Log4r/Outputter/rollingfileoutputter_rb.html +66 -0
- data/doc/rdoc/Log4r/Outputter/staticoutputter_rb.html +55 -0
- data/doc/rdoc/Log4r/Outputter/syslogoutputter_rb.html +110 -0
- data/doc/rdoc/Log4r/Outputter/udpoutputter_rb.html +220 -0
- data/doc/rdoc/Log4r/PatternFormatter.html +404 -0
- data/doc/rdoc/Log4r/ROMPClient.html +211 -0
- data/doc/rdoc/Log4r/ROMPServer.html +211 -0
- data/doc/rdoc/Log4r/RemoteOutputter.html +402 -0
- data/doc/rdoc/Log4r/RollingFileOutputter.html +551 -0
- data/doc/rdoc/Log4r/RootLogger.html +530 -0
- data/doc/rdoc/Log4r/SimpleFormatter.html +276 -0
- data/doc/rdoc/Log4r/StderrOutputter.html +268 -0
- data/doc/rdoc/Log4r/StdoutOutputter.html +268 -0
- data/doc/rdoc/Log4r/SyslogOutputter.html +551 -0
- data/doc/rdoc/Log4r/UDPOutputter.html +379 -0
- data/doc/rdoc/Log4r/YamlConfigurator.html +966 -0
- data/doc/rdoc/Log4r/base_rb.html +57 -0
- data/doc/rdoc/Log4r/config_rb.html +122 -0
- data/doc/rdoc/Log4r/configurator_rb.html +370 -0
- data/doc/rdoc/Log4r/formatter/formatter_rb.html +121 -0
- data/doc/rdoc/Log4r/formatter/log4jxmlformatter_rb.html +64 -0
- data/doc/rdoc/Log4r/formatter/patternformatter_rb.html +239 -0
- data/doc/rdoc/Log4r/lib/drbloader_rb.html +57 -0
- data/doc/rdoc/Log4r/lib/xmlloader_rb.html +57 -0
- data/doc/rdoc/Log4r/logevent_rb.html +55 -0
- data/doc/rdoc/Log4r/logger_rb.html +293 -0
- data/doc/rdoc/Log4r/loggerfactory_rb.html +66 -0
- data/doc/rdoc/Log4r/logserver_rb.html +161 -0
- data/doc/rdoc/Log4r/rdoc/GDC.html +175 -0
- data/doc/rdoc/Log4r/rdoc/MDC.html +178 -0
- data/doc/rdoc/Log4r/rdoc/NDC.html +207 -0
- data/doc/rdoc/Log4r/rdoc/configurator.html +462 -0
- data/doc/rdoc/Log4r/rdoc/emailoutputter.html +279 -0
- data/doc/rdoc/Log4r/rdoc/formatter.html +218 -0
- data/doc/rdoc/Log4r/rdoc/log4r.html +286 -0
- data/doc/rdoc/Log4r/rdoc/logger.html +382 -0
- data/doc/rdoc/Log4r/rdoc/logserver.html +265 -0
- data/doc/rdoc/Log4r/rdoc/outputter.html +313 -0
- data/doc/rdoc/Log4r/rdoc/patternformatter.html +331 -0
- data/doc/rdoc/Log4r/rdoc/syslogoutputter.html +197 -0
- data/doc/rdoc/Log4r/rdoc/win32eventoutputter.html +165 -0
- data/doc/rdoc/Log4r/rdoc/yamlconfigurator.html +187 -0
- data/doc/rdoc/Log4r/repository_rb.html +74 -0
- data/doc/rdoc/Log4r/staticlogger_rb.html +55 -0
- data/doc/rdoc/Log4r/yamlconfigurator_rb.html +95 -0
- data/doc/rdoc/REXML.html +211 -0
- data/doc/rdoc/created.rid +1 -0
- data/doc/rdoc/images/brick.png +0 -0
- data/doc/rdoc/images/brick_link.png +0 -0
- data/doc/rdoc/images/bug.png +0 -0
- data/doc/rdoc/images/bullet_black.png +0 -0
- data/doc/rdoc/images/bullet_toggle_minus.png +0 -0
- data/doc/rdoc/images/bullet_toggle_plus.png +0 -0
- data/doc/rdoc/images/date.png +0 -0
- data/doc/rdoc/images/find.png +0 -0
- data/doc/rdoc/images/loadingAnimation.gif +0 -0
- data/doc/rdoc/images/macFFBgHack.png +0 -0
- data/doc/rdoc/images/package.png +0 -0
- data/doc/rdoc/images/page_green.png +0 -0
- data/doc/rdoc/images/page_white_text.png +0 -0
- data/doc/rdoc/images/page_white_width.png +0 -0
- data/doc/rdoc/images/plugin.png +0 -0
- data/doc/rdoc/images/ruby.png +0 -0
- data/doc/rdoc/images/tag_green.png +0 -0
- data/doc/rdoc/images/wrench.png +0 -0
- data/doc/rdoc/images/wrench_orange.png +0 -0
- data/doc/rdoc/images/zoom.png +0 -0
- data/doc/rdoc/index.html +585 -0
- data/doc/rdoc/js/darkfish.js +116 -0
- data/doc/rdoc/js/jquery.js +32 -0
- data/doc/rdoc/js/quicksearch.js +114 -0
- data/doc/rdoc/js/thickbox-compressed.js +10 -0
- data/doc/rdoc/log4r-rdoc.css +696 -0
- data/doc/rdoc/log4r_rb.html +207 -0
- data/doc/rdoc/rdoc.css +696 -0
- data/examples/rdoc-gen +2 -0
- data/src/log4r.rb +2 -2
- data/src/log4r/formatter/patternformatter.rb +15 -15
- data/src/log4r/outputter/udpoutputter.rb +4 -4
- data/tests/testchainsaw.rb +1 -1
- metadata +123 -8
- data/src/log4r/outputter/datefileoutputter.patch +0 -24
- data/src/log4r/outputter/diff +0 -14
- data/src/log4r/outputter/new-datefileoutputter.rb +0 -117
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="utf-8"?>
|
|
2
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
3
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
4
|
+
|
|
5
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
6
|
+
<head>
|
|
7
|
+
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
|
|
8
|
+
|
|
9
|
+
<title>File: xmlloader.rb [1.1.7 Log4r API]</title>
|
|
10
|
+
|
|
11
|
+
<link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet" />
|
|
12
|
+
|
|
13
|
+
<script src="../../js/jquery.js" type="text/javascript"
|
|
14
|
+
charset="utf-8"></script>
|
|
15
|
+
<script src="../../js/thickbox-compressed.js" type="text/javascript"
|
|
16
|
+
charset="utf-8"></script>
|
|
17
|
+
<script src="../../js/quicksearch.js" type="text/javascript"
|
|
18
|
+
charset="utf-8"></script>
|
|
19
|
+
<script src="../../js/darkfish.js" type="text/javascript"
|
|
20
|
+
charset="utf-8"></script>
|
|
21
|
+
</head>
|
|
22
|
+
|
|
23
|
+
<body class="file file-popup">
|
|
24
|
+
<div id="metadata">
|
|
25
|
+
<dl>
|
|
26
|
+
<dt class="modified-date">Last Modified</dt>
|
|
27
|
+
<dd class="modified-date">Thu Mar 18 19:31:09 -0800 2004</dd>
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
<dt class="requires">Requires</dt>
|
|
31
|
+
<dd class="requires">
|
|
32
|
+
<ul>
|
|
33
|
+
|
|
34
|
+
<li>rexml/document</li>
|
|
35
|
+
|
|
36
|
+
</ul>
|
|
37
|
+
</dd>
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
</dl>
|
|
42
|
+
</div>
|
|
43
|
+
|
|
44
|
+
<div id="documentation">
|
|
45
|
+
|
|
46
|
+
<div class="description">
|
|
47
|
+
<h2>Description</h2>
|
|
48
|
+
<p>
|
|
49
|
+
:nodoc:
|
|
50
|
+
</p>
|
|
51
|
+
|
|
52
|
+
</div>
|
|
53
|
+
|
|
54
|
+
</div>
|
|
55
|
+
</body>
|
|
56
|
+
</html>
|
|
57
|
+
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="utf-8"?>
|
|
2
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
3
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
4
|
+
|
|
5
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
6
|
+
<head>
|
|
7
|
+
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
|
|
8
|
+
|
|
9
|
+
<title>File: logevent.rb [1.1.7 Log4r API]</title>
|
|
10
|
+
|
|
11
|
+
<link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet" />
|
|
12
|
+
|
|
13
|
+
<script src="../js/jquery.js" type="text/javascript"
|
|
14
|
+
charset="utf-8"></script>
|
|
15
|
+
<script src="../js/thickbox-compressed.js" type="text/javascript"
|
|
16
|
+
charset="utf-8"></script>
|
|
17
|
+
<script src="../js/quicksearch.js" type="text/javascript"
|
|
18
|
+
charset="utf-8"></script>
|
|
19
|
+
<script src="../js/darkfish.js" type="text/javascript"
|
|
20
|
+
charset="utf-8"></script>
|
|
21
|
+
</head>
|
|
22
|
+
|
|
23
|
+
<body class="file file-popup">
|
|
24
|
+
<div id="metadata">
|
|
25
|
+
<dl>
|
|
26
|
+
<dt class="modified-date">Last Modified</dt>
|
|
27
|
+
<dd class="modified-date">Thu Mar 18 19:31:06 -0800 2004</dd>
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
<dt class="requires">Requires</dt>
|
|
31
|
+
<dd class="requires">
|
|
32
|
+
<ul>
|
|
33
|
+
|
|
34
|
+
</ul>
|
|
35
|
+
</dd>
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
</dl>
|
|
40
|
+
</div>
|
|
41
|
+
|
|
42
|
+
<div id="documentation">
|
|
43
|
+
|
|
44
|
+
<div class="description">
|
|
45
|
+
<h2>Description</h2>
|
|
46
|
+
<p>
|
|
47
|
+
:nodoc:
|
|
48
|
+
</p>
|
|
49
|
+
|
|
50
|
+
</div>
|
|
51
|
+
|
|
52
|
+
</div>
|
|
53
|
+
</body>
|
|
54
|
+
</html>
|
|
55
|
+
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="utf-8"?>
|
|
2
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
3
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
4
|
+
|
|
5
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
6
|
+
<head>
|
|
7
|
+
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
|
|
8
|
+
|
|
9
|
+
<title>File: logger.rb [1.1.7 Log4r API]</title>
|
|
10
|
+
|
|
11
|
+
<link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet" />
|
|
12
|
+
|
|
13
|
+
<script src="../js/jquery.js" type="text/javascript"
|
|
14
|
+
charset="utf-8"></script>
|
|
15
|
+
<script src="../js/thickbox-compressed.js" type="text/javascript"
|
|
16
|
+
charset="utf-8"></script>
|
|
17
|
+
<script src="../js/quicksearch.js" type="text/javascript"
|
|
18
|
+
charset="utf-8"></script>
|
|
19
|
+
<script src="../js/darkfish.js" type="text/javascript"
|
|
20
|
+
charset="utf-8"></script>
|
|
21
|
+
</head>
|
|
22
|
+
|
|
23
|
+
<body class="file file-popup">
|
|
24
|
+
<div id="metadata">
|
|
25
|
+
<dl>
|
|
26
|
+
<dt class="modified-date">Last Modified</dt>
|
|
27
|
+
<dd class="modified-date">Wed Sep 23 21:58:28 -0700 2009</dd>
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
<dt class="requires">Requires</dt>
|
|
31
|
+
<dd class="requires">
|
|
32
|
+
<ul>
|
|
33
|
+
|
|
34
|
+
<li>log4r/outputter/outputter</li>
|
|
35
|
+
|
|
36
|
+
<li>log4r/repository</li>
|
|
37
|
+
|
|
38
|
+
<li>log4r/loggerfactory</li>
|
|
39
|
+
|
|
40
|
+
<li>log4r/staticlogger</li>
|
|
41
|
+
|
|
42
|
+
</ul>
|
|
43
|
+
</dd>
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
</dl>
|
|
48
|
+
</div>
|
|
49
|
+
|
|
50
|
+
<div id="documentation">
|
|
51
|
+
|
|
52
|
+
<div class="description">
|
|
53
|
+
<h2>Description</h2>
|
|
54
|
+
<h1>Loggers</h1>
|
|
55
|
+
<p>
|
|
56
|
+
Loggers provide the interface for logging in <a
|
|
57
|
+
href="../Log4r.html">Log4r</a>. To create a logger, first come up with a
|
|
58
|
+
name for it. Good choices include the name of the class using it, a service
|
|
59
|
+
name, or the name of the file.
|
|
60
|
+
</p>
|
|
61
|
+
<p>
|
|
62
|
+
To create a logger named ‘mylog’:
|
|
63
|
+
</p>
|
|
64
|
+
<pre>
|
|
65
|
+
Logger.new('mylog')
|
|
66
|
+
</pre>
|
|
67
|
+
<p>
|
|
68
|
+
After creating a logger, it is stashed in a repository. The logger may be
|
|
69
|
+
retrieved at any time:
|
|
70
|
+
</p>
|
|
71
|
+
<pre>
|
|
72
|
+
Logger['mylog'] # get mylog back
|
|
73
|
+
</pre>
|
|
74
|
+
<p>
|
|
75
|
+
It will return nil if the logger is not found. Alternatively, if an
|
|
76
|
+
Exception is desired when a nonexistant logger is referenced, the
|
|
77
|
+
Logger#get command can be used:
|
|
78
|
+
</p>
|
|
79
|
+
<pre>
|
|
80
|
+
Logger.get('boguslog') # raises NameError if it doesn't exist
|
|
81
|
+
</pre>
|
|
82
|
+
<h2>Manipulating a Logger’s Outputters</h2>
|
|
83
|
+
<p>
|
|
84
|
+
Loggers start out with no outputters. They can be added using the
|
|
85
|
+
Logger#add method or set directly by modifying the Loggers#outputters
|
|
86
|
+
array:
|
|
87
|
+
</p>
|
|
88
|
+
<pre>
|
|
89
|
+
mylog = Logger['mylog']
|
|
90
|
+
|
|
91
|
+
# assume we've created Outputters out1 through out4
|
|
92
|
+
mylog.outputters = out1, out2
|
|
93
|
+
mylog.add(out3, out4)
|
|
94
|
+
mylog.each_outputter {|o| o.flush}
|
|
95
|
+
|
|
96
|
+
# assume out5 through out7 have names 'out5' through 'out7' resp.
|
|
97
|
+
mylog.outputters = 'out5', 'out6'
|
|
98
|
+
mylog.add('out7')
|
|
99
|
+
mylog.remove('out5','out7')
|
|
100
|
+
</pre>
|
|
101
|
+
<p>
|
|
102
|
+
Please see <a
|
|
103
|
+
href="outputter/outputter_rb.html">log4r/outputter/outputter.rb</a> and <a
|
|
104
|
+
href="../Log4r/Outputter.html">Log4r::Outputter</a> for more about
|
|
105
|
+
outputters.
|
|
106
|
+
</p>
|
|
107
|
+
<h2>Logging Methods</h2>
|
|
108
|
+
<p>
|
|
109
|
+
To log something at a certain priority, use the logging method named after
|
|
110
|
+
the lowercased priority level name:
|
|
111
|
+
</p>
|
|
112
|
+
<pre>
|
|
113
|
+
mylog.warn "This is a message with priority WARN"
|
|
114
|
+
mylog.fatal "A FATAL message"
|
|
115
|
+
</pre>
|
|
116
|
+
<p>
|
|
117
|
+
Blocks can also be logged:
|
|
118
|
+
</p>
|
|
119
|
+
<pre>
|
|
120
|
+
mylog.warn {"This is also a message with priority WARN"}
|
|
121
|
+
mylog.debug do
|
|
122
|
+
# some complicated string magic
|
|
123
|
+
return result
|
|
124
|
+
end
|
|
125
|
+
</pre>
|
|
126
|
+
<p>
|
|
127
|
+
The primary difference is that the block doesn’t get called unless
|
|
128
|
+
the Logger can log at that level. It is useful for doing computationaly
|
|
129
|
+
expensive things at a log event.
|
|
130
|
+
</p>
|
|
131
|
+
<h2>Query Methods</h2>
|
|
132
|
+
<p>
|
|
133
|
+
To ask <a href="../Log4r.html">Log4r</a> whether it is capable of logging a
|
|
134
|
+
certain level:
|
|
135
|
+
</p>
|
|
136
|
+
<pre>
|
|
137
|
+
mylog.warn? # are we logging WARN?
|
|
138
|
+
mylog.fatal? # how about FATAL?
|
|
139
|
+
</pre>
|
|
140
|
+
<p>
|
|
141
|
+
Query methods and blocks accomplish the same thing:
|
|
142
|
+
</p>
|
|
143
|
+
<pre>
|
|
144
|
+
mylog.warn "don't evaluate unless WARN is on" if mylog.warn?
|
|
145
|
+
mylog.warn {"don't evaluate unless WARN is on"}
|
|
146
|
+
</pre>
|
|
147
|
+
<h2>What About the Special Levels?</h2>
|
|
148
|
+
<p>
|
|
149
|
+
<tt>ALL</tt> and <tt>OFF</tt> can be querried, but not logged:
|
|
150
|
+
</p>
|
|
151
|
+
<pre>
|
|
152
|
+
log.off? # true iff level is OFF
|
|
153
|
+
log.all? # true iff level is ALL
|
|
154
|
+
log.all "Try to log" => Method not defined. (NameError)
|
|
155
|
+
</pre>
|
|
156
|
+
<h2>Custom Levels and Method Names</h2>
|
|
157
|
+
<p>
|
|
158
|
+
Suppose we’ve set up <a href="../Log4r.html">Log4r</a> with the
|
|
159
|
+
custom levels:
|
|
160
|
+
</p>
|
|
161
|
+
<pre>
|
|
162
|
+
Foo < Bar < Baz
|
|
163
|
+
</pre>
|
|
164
|
+
<p>
|
|
165
|
+
As one might expect, the logging methods are named after them:
|
|
166
|
+
</p>
|
|
167
|
+
<pre>
|
|
168
|
+
log.bar "something" # log at custom level Bar
|
|
169
|
+
log.bar? # are we logging at level Bar?
|
|
170
|
+
</pre>
|
|
171
|
+
<h1>Logger Inheritance</h1>
|
|
172
|
+
<p>
|
|
173
|
+
Normally, when a logger is created, its parent is set to RootLogger. If a
|
|
174
|
+
Logger’s level isn’t specified at creation, it will inherit the
|
|
175
|
+
level of its parent.
|
|
176
|
+
</p>
|
|
177
|
+
<p>
|
|
178
|
+
To specify an ancestors of a logger besides RootLogger, include the names
|
|
179
|
+
of the ancestors in order of ancestry and delimited by
|
|
180
|
+
Log4r::Log4rConfig::LoggerPathDelimiter. For example, if the delimiter is
|
|
181
|
+
the default <tt>::</tt>, our logger is ‘me’ and its ancestors
|
|
182
|
+
are ‘cain’, ‘grandpa’, and ‘pa’, we
|
|
183
|
+
create the logger like so:
|
|
184
|
+
</p>
|
|
185
|
+
<pre>
|
|
186
|
+
Logger.new('cain::grandpa::pa::me')
|
|
187
|
+
</pre>
|
|
188
|
+
<p>
|
|
189
|
+
This string is split into three compontents which can be used by a
|
|
190
|
+
Formatter to avoid parsing the name:
|
|
191
|
+
</p>
|
|
192
|
+
<table>
|
|
193
|
+
<tr><td valign="top">Logger#fullname:</td><td>The whole enchilada: ‘cain::grandpa::pa::me’
|
|
194
|
+
|
|
195
|
+
</td></tr>
|
|
196
|
+
<tr><td valign="top">Logger#name:</td><td>Just ‘me’
|
|
197
|
+
|
|
198
|
+
</td></tr>
|
|
199
|
+
</table>
|
|
200
|
+
<p>
|
|
201
|
+
To get this logger back from the repository,
|
|
202
|
+
</p>
|
|
203
|
+
<pre>
|
|
204
|
+
Logger['cain::grandpa::pa::me']
|
|
205
|
+
</pre>
|
|
206
|
+
<h1>Outputter Additivity</h1>
|
|
207
|
+
<p>
|
|
208
|
+
By default, Logger Outputters are <b>additive</b>. This means that a log
|
|
209
|
+
event will also be sent to all of a logger’s ancestors. To stop this
|
|
210
|
+
behavior, set a logger’s <tt>additive</tt> to false.
|
|
211
|
+
</p>
|
|
212
|
+
<pre>
|
|
213
|
+
Logger['foo'].additive = false
|
|
214
|
+
</pre>
|
|
215
|
+
<p>
|
|
216
|
+
A Logger’s level, additivity and trace can be changed dynamically,
|
|
217
|
+
but this is an expensive operation as the logging methods have to be
|
|
218
|
+
redefined.
|
|
219
|
+
</p>
|
|
220
|
+
<h1>RootLogger</h1>
|
|
221
|
+
<p>
|
|
222
|
+
<a href="../Log4r/RootLogger.html">Log4r::RootLogger</a> is the ancestor of
|
|
223
|
+
all loggers. Its level defines the global logging threshold. Any loggers
|
|
224
|
+
created <b>after</b> RootLogger’s level is set will not log below
|
|
225
|
+
that level. By default, RootLogger’s level is set to <tt>ALL</tt>
|
|
226
|
+
</p>
|
|
227
|
+
<p>
|
|
228
|
+
RootLogger is a singleton which gets created automaticallay. It can be
|
|
229
|
+
retrieved at any time with Logger.root, Logger.global,
|
|
230
|
+
Logger[‘root’] or Logger[‘global’].
|
|
231
|
+
</p>
|
|
232
|
+
<h2>Global Level</h2>
|
|
233
|
+
<p>
|
|
234
|
+
Suppose we want <em>everything</em> to ignore events less than FATAL. We
|
|
235
|
+
can accomplish this easily:
|
|
236
|
+
</p>
|
|
237
|
+
<pre>
|
|
238
|
+
Logger.global.level = FATAL
|
|
239
|
+
</pre>
|
|
240
|
+
<p>
|
|
241
|
+
Just be sure to set this before any other Loggers or Outputters are
|
|
242
|
+
defined.
|
|
243
|
+
</p>
|
|
244
|
+
<h2>RootLogger Does Nothing</h2>
|
|
245
|
+
<p>
|
|
246
|
+
RootLogger itself behaves as if its level were permanently set to
|
|
247
|
+
<tt>OFF</tt>, thus making it a sort of null object.
|
|
248
|
+
</p>
|
|
249
|
+
<h1>XML Configuration</h1>
|
|
250
|
+
<p>
|
|
251
|
+
Please see <a href="configurator_rb.html">log4r/configurator.rb</a> for an
|
|
252
|
+
overview of XML configuratoin.
|
|
253
|
+
</p>
|
|
254
|
+
<p>
|
|
255
|
+
It’s easy to configure a Logger in XML. The following example should
|
|
256
|
+
be sufficient:
|
|
257
|
+
</p>
|
|
258
|
+
<pre>
|
|
259
|
+
...
|
|
260
|
+
<logger name="papa::mylog" level="DEBUG" trace="true">
|
|
261
|
+
<additive>false</additive>
|
|
262
|
+
<outputter>stdout</outputter>
|
|
263
|
+
<outputters>stderr, dancer, doner, blitzen</outputters>
|
|
264
|
+
</logger>
|
|
265
|
+
<logger name="papa" outputters="stderr, stdout"/>
|
|
266
|
+
...
|
|
267
|
+
</pre>
|
|
268
|
+
<p>
|
|
269
|
+
The element <tt>outputter</tt> can occur multiple times, but cannot be an
|
|
270
|
+
attribute of <tt>logger</tt>. That is, it is not an <em>XML directive</em>.
|
|
271
|
+
However, the element <tt>outputters</tt> is an <em>XML directive</em>, as
|
|
272
|
+
are all the others.
|
|
273
|
+
</p>
|
|
274
|
+
<p>
|
|
275
|
+
For more examples, check the <tt>examples</tt> directory in the <a
|
|
276
|
+
href="../Log4r.html">Log4r</a> package.
|
|
277
|
+
</p>
|
|
278
|
+
<h2>Other Info</h2>
|
|
279
|
+
<table>
|
|
280
|
+
<tr><td valign="top">Version:</td><td>$Id: logger.rb,v 1.2 2009/09/24 04:58:28 colbygk Exp $
|
|
281
|
+
|
|
282
|
+
</td></tr>
|
|
283
|
+
<tr><td valign="top">Author:</td><td>Leon Torres <leon(at)ugcs.caltech.edu>
|
|
284
|
+
|
|
285
|
+
</td></tr>
|
|
286
|
+
</table>
|
|
287
|
+
|
|
288
|
+
</div>
|
|
289
|
+
|
|
290
|
+
</div>
|
|
291
|
+
</body>
|
|
292
|
+
</html>
|
|
293
|
+
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="utf-8"?>
|
|
2
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
3
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
4
|
+
|
|
5
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
6
|
+
<head>
|
|
7
|
+
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
|
|
8
|
+
|
|
9
|
+
<title>File: loggerfactory.rb [1.1.7 Log4r API]</title>
|
|
10
|
+
|
|
11
|
+
<link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet" />
|
|
12
|
+
|
|
13
|
+
<script src="../js/jquery.js" type="text/javascript"
|
|
14
|
+
charset="utf-8"></script>
|
|
15
|
+
<script src="../js/thickbox-compressed.js" type="text/javascript"
|
|
16
|
+
charset="utf-8"></script>
|
|
17
|
+
<script src="../js/quicksearch.js" type="text/javascript"
|
|
18
|
+
charset="utf-8"></script>
|
|
19
|
+
<script src="../js/darkfish.js" type="text/javascript"
|
|
20
|
+
charset="utf-8"></script>
|
|
21
|
+
</head>
|
|
22
|
+
|
|
23
|
+
<body class="file file-popup">
|
|
24
|
+
<div id="metadata">
|
|
25
|
+
<dl>
|
|
26
|
+
<dt class="modified-date">Last Modified</dt>
|
|
27
|
+
<dd class="modified-date">Thu Mar 18 19:31:07 -0800 2004</dd>
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
<dt class="requires">Requires</dt>
|
|
31
|
+
<dd class="requires">
|
|
32
|
+
<ul>
|
|
33
|
+
|
|
34
|
+
<li>log4r/base</li>
|
|
35
|
+
|
|
36
|
+
<li>log4r/repository</li>
|
|
37
|
+
|
|
38
|
+
<li>log4r/logevent</li>
|
|
39
|
+
|
|
40
|
+
</ul>
|
|
41
|
+
</dd>
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
</dl>
|
|
46
|
+
</div>
|
|
47
|
+
|
|
48
|
+
<div id="documentation">
|
|
49
|
+
|
|
50
|
+
<div class="description">
|
|
51
|
+
<h2>Description</h2>
|
|
52
|
+
<p>
|
|
53
|
+
:nodoc:
|
|
54
|
+
</p>
|
|
55
|
+
<table>
|
|
56
|
+
<tr><td valign="top">Version:</td><td>$Id: loggerfactory.rb,v 1.1.1.1 2004/03/19 03:31:07 fando Exp $
|
|
57
|
+
|
|
58
|
+
</td></tr>
|
|
59
|
+
</table>
|
|
60
|
+
|
|
61
|
+
</div>
|
|
62
|
+
|
|
63
|
+
</div>
|
|
64
|
+
</body>
|
|
65
|
+
</html>
|
|
66
|
+
|