Debian Codegraph @

logback-site/src/site/pages/news.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
4 <html xmlns="http://www.w3.org/1999/xhtml">
5 <head>
6 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
7 <title>News</title>
8 <link rel="stylesheet" type="text/css" href="css/common.css" />
9 <link rel="stylesheet" type="text/css" href="css/screen.css" media="screen" />
10 <link rel="stylesheet" type="text/css" href="css/_print.css" media="print" />
11 <link rel="stylesheet" type="text/css" href="css/prettify.css" media="screen" />
12 </head>
13
14 <body onload="prettyPrint()">
15 <script type="text/javascript">prefix='';</script>
16 <script type="text/javascript" src="js/prettify.js"></script>
17 <script src="templates/header.js" type="text/javascript"></script>
18 <div id="left">
19 <noscript>Please turn on Javascript to view this menu</noscript>
20 <script src="templates/left.js" type="text/javascript"></script>
21 </div>
22 <div id="right">
23 <script src="templates/right.js" type="text/javascript"></script>
24 </div>
25 <div id="content">
26
27 <h2>Logback News</h2>
28
29 <p>You can receive logback-related announcements by subscribing to
30 the <a href="http://www.qos.ch/mailman/listinfo/announce">QOS.ch
31 announce</a> mailing list.</p>
32
33 <!--
34 <hr width="80%" align="center" />
35
36
37 <p class="highlight">Version 1.3.x and later require JDK 1.7.</p>
38
39 <p>Version 1.3.x and later require JDK 1.7.</p>
40 -->
41
42 <hr width="80%" align="center" />
43
44 <h3>March 30th, 2017, Release of version 1.2.3</h3>
45
46 <p>Fix unintentional dependency on
47 <code>OutputStreamAppender</code> in
48 <code>LayoutWrappingEncoder</code> as reported in <a
49 href="https://jira.qos.ch/browse/LOGBACK-1287">LOGBACK-1287</a>.
50 </p>
51
52 <p>Fix spurious <code>System.out.println</code> in AsyncAppender's
53 worker thread. This issue was reported in <a
54 href="https://jira.qos.ch/browse/LOGBACK-1292">LOGBACK-1292</a> by
55 Nikolas Loutas with Thibault Meyer the relevant patch.</p>
56
57 <p>ConsoleAppender exception when run under Java WebStart. This
58 problem was reported in <a
59 href="https://jira.qos.ch/browse/LOGBACK-1282">LOGBACK-1282</a> by
60 Clas Forsberg.</p>
61
62 <h3>March 16th, 2017, Release of version 1.2.2</h3>
63
64 <p><code>AsyncAppender</code> no longer drops events when the
65 current thread has its interrupt flag set. This issue was reported
66 in <a
67 href="https://jira.qos.ch/browse/LOGBACK-1247">LOGBACK-1247</a> by
68 Jakob Bergendahl who also provided the relevant pull request.
69 </p>
70
71 <p>Removed <code>JMSQueueAppender</code> and
72 <code>JMSTopicAppender</code>. These appenders were undocumented
73 and had no apparent users.</p>
74
75 <p>Remove comment in logback-classic's
76 <code>META-INF/services/javax.servlet.ServletContainerInitializer</code>
77 file in order to keep Wildfly 8 happy. This issue was reported in
78 <a href="https://jira.qos.ch/browse/LOGBACK-1265">LOGBACK-1265</a>
79 by Andy Wilkinson.
80 </p>
81
82 <p><code>FileSize.toString()</code> now reports files sizes in GB
83 in addition to sizes in MB and KB and Bytes. This fixes issue <a
84 href="https://jira.qos.ch/browse/LOGBACK-1278">LOGBACK-1278</a>.</p>
85
86 <hr width="80%" align="center" />
87
88 <h3>March 1st, 2017, Release of version 1.1.11</h3>
89
90 <p>Fix thread-safety issue with <code>PatternLayoutBase</code>
91 reported in <a
92 href="https://jira.qos.ch/browse/LOGBACK-1270">LOGBACK-1270</a> by
93 Artem Bilan. Note that the fix was already present in the 1.2.x
94 series and was back-ported to the 1.1.x series.</p>
95
96 <hr width="80%" align="center" />
97
98 <h3>February 9th, 2017, Release of version 1.2.1</h3>
99
100 <p>To ensure backward compatibility of configuration files, the
101 <span class="prop">immediateFlush</span> property set for a
102 <code>LayoutWrappingEncoder</code> is propagated to the enclosing
103 <code>OutputStreamAppender</code>.
104 </p>
105
106 <hr width="80%" align="center" />
107
108 <h3>February 8th, 2017, Release of version 1.2.0</h3>
109
110 <div class="breaking">
111 <h4><code>Encoder</code> interface has changed and is no longer
112 expected to handle an <code>OutputStream</code>.</h4>
113 </div>
114
115
116 <p><code>Encoder</code> interface has changed and is no longer
117 expected to handle an <code>OutputStream</code>. This
118 simplification allows finer-grain locking resulting in <a class="big"
119 href="https://docs.google.com/spreadsheets/d/1cpb5D7qnyye4W0RTlHUnXedYK98catNZytYIu5D91m0/edit?usp=sharing">significantly
120 improved performance</a>.
121 </p>
122
123 <p class="highlight">Release 1.2.0 fixes a rather severe
124 serialization vulnerability in <code>SocketServer</code> and
125 <code>ServerSocketReceiver</code>. Users running these components
126 should upgrade immediately.</p>
127
128
129 <p>This release fixes a rather severe serialization vulnerability
130 in <code>SocketServer</code> and
131 <code>ServerSocketReceiver</code>. Users running these components
132 should upgrade immediately.
133 </p>
134
135 <p>In <code>TimeBasedRollingPolicy</code>, fixed issue with <span
136 class="option">totalSizeCap</span> of more than 2^31. This problem
137 was reported in <a
138 href="https://jira.qos.ch/browse/LOGBACK-1231">1231</a> by Simon
139 Teng.
140 </p>
141
142 <p>Logback-classic now searches for the file
143 <em>logback-test.xml</em> first, <em>logback.groovy</em> second
144 and <em>logback.xml</em> third. In previous versions
145 <em>logback.groovy</em> was looked up first which was non-sensical
146 in presense of <em>logback-test.xml</em>. This fixes <a
147 href="http://jira.qos.ch/browse/LOGBACK-1245">LOGBACK-1245</a>
148 reported by Joern Huxhorn.
149 </p>
150
151
152 <hr width="80%" align="center" />
153
154 <h3>February 5th, 2017, Release of version 1.1.10</h3>
155
156 <p>Several changes to improve throughput (see <a
157 href="https://docs.google.com/spreadsheets/d/1cpb5D7qnyye4W0RTlHUnXedYK98catNZytYIu5D91m0/edit?usp=sharing"><b>spreadsheet</b></a>)
158 </p>
159
160 <ol>
161 <li>The <code>ReentrantLock</code> in
162 <code>OutputStreamAppender</code> is now "unfair". In previous
163 versions of logback, a fair lock was used. Fair locks are much
164 slower. Just as importanly, logback has no mandate to influence
165 thread scheduling.
166 </li>
167
168 <li><code>FileAppender</code> now offers the <span
169 class="option">bufferSize</span> option. Previously, a
170 fixed-size 8K buffer was used. Increasing the <span
171 class="option">bufferSize</span>, for example to 256K,
172 significantly reduces thread-contention.
173 </li>
174
175 <li>Critical parts of the code now use
176 <code>COWArrayList</code>, a custom developed allocation-free
177 lock-free thread-safe implementation of the {@link List}
178 interface. It is optimized for cases where iterations over the
179 list vastly outnumber modifications on the list. It is based on
180 <code>CopyOnWriteArrayList</code> but allows allocation-free
181 iterations over the list.
182 </li>
183
184 <li>In <code>PatternLayoutBase</code> the same
185 <code>StringBuilder</code> is used over and over to reduce
186 memory allocation. This is safe as long as the owning appender
187 guarantees serial access to its layout. In the next version of
188 logback, i.e. 1.2.x, the read-write lock will no longer protect
189 access to the layout and there will be no guarantee of
190 serial access.
191 </li>
192 </ol>
193
194 <p>In web-applications, logback-classic will <a
195 href="manual/configuration.html#webShutdownHook">automatically
196 install a listener</a> which will stop the logging context and
197 release resources when your web-app is reloaded. This enhancement
198 was requested <a
199 href="https://jira.qos.ch/browse/LOGBACK-1170">LOGBACK-1170</a> by
200 Martin Wegner.
201 </p>
202
203 <p>The <code>AccessEvent.prepareForDeferredProcessing()</code>
204 method was not idempotent. This caused subtle bugs under
205 Jetty. See <a
206 href="https://jira.qos.ch/browse/LOGBACK-1189">LOGBACK-1189</a>
207 for details. Many thanks to Per Olesen, Evan Meagher, Nick Babcock
208 and Mark Elliot for hunting down this bug.
209 </p>
210
211 <p>As it may be time consuming in certain environments, the
212 HOSTNAME property is now computed lazily. This optimization
213 requested in <a
214 href="https://jira.qos.ch/browse/LOGBACK-1221">LOGBACK-1221</a> by
215 Eugene Petrenko.
216 </p>
217
218
219 <p>Joran now supports external XML entities. This feature was
220 requested in <a
221 href="https://jira.qos.ch/browse/LOGBACK-1091">1091</a> and the
222 relevant PR graciously provided by Jonas Neukomm.
223 </p>
224
225 <hr width="80%" align="center" />
226
227 <h3>January 20th, 2017, Release of version 1.1.9</h3>
228
229 <p>Logback's internal executor service had a thread pool size of 2
230 which could be used up rather quickly, e.g. configuration scanning
231 in addition to an active <code>ServerSocketAppender</code>. When
232 both threads where permanently in use, compression could not
233 proceed. To alleviate this problem, the thread pool size has been
234 increased to 8. See issue <a
235 href="https://jira.qos.ch/browse/LOGBACK-1238">LOGBACK-1238</a>
236 for more details.
237 </p>
238
239 <p>Fixed issue with <code>FileAppender</code> instances embedded
240 within <code>SiftingAppender</code> reporting filename collisions
241 after reaching timeout and subsequently restarted. This problem
242 was reported in <a
243 href="https://jira.qos.ch/browse/LOGBACK-1167">LOGBACK-1167</a> by
244 Michael Edgar.
245 </p>
246
247 <p>Fixed <code>SizeAndTimeBasedFNATP</code> deprecation warning
248 emitted even the replacement,
249 i.e. <code>SizeAndTimeBasedRollingPolicy</code>, is in use. See <a
250 href="http://jira.qos.ch/browse/LOGBACK-1236">LOGBACK-1236</a>. This
251 issue was reported by Claudius Nicolae.
252 </p>
253
254 <p>Added proper implementation for
255 <code>LobackValve.getScheduledExecutorService()</code> method. The
256 missing implementation manifested itself in the form of an
257 <code>UnsupportedOperationException</code> thrown by
258 LogbackValve. This problem is further described in <a
259 href="http://jira.qos.ch/browse/LOGBACK-1181">LOGBACK-1181</a>
260 reported by Andreas von Roepenack.
261 </p>
262
263 <hr width="80%" align="center" />
264
265 <h3>December 9th, 2016, Release of version 1.1.8</h3>
266
267 <p>Removed the two period safeguard, aka untouchable periods, for
268 archive removal beyond the size specified by <span
269 class="option">totalSizeCap</span> in
270 <code>TimeBasedRollingPolicy</code>. It turns out the safegaurd is
271 not required and is unexpected as attested by <a
272 href="http://jira.qos.ch/browse/LOGBACK-1166">LOGBACK-1166</a>.
273 </p>
274
275 <p>Fixed issue with Joran incorrectly reporting "Unexpected
276 aggregationType AS_BASIC_PROPERTY_COLLECTION". This issue was
277 raised in <a
278 href="http://jira.qos.ch/browse/LOGBACK-1158">LOGBACK-1158</a> by
279 Christian H&uuml;bner.
280 </p>
281
282 <p>Gaffer (logback's groovy configurator) now supports the
283 <code>valueOf</code> convention. This issue was raised in <a
284 href="http://jira.qos.ch/browse/LOGBACK-1232">LOGBACK-1232</a> by
285 Frans Orsel.
286 </p>
287
288 <p>The <code>org.slf4j.impl.StaticLoggerBinder</code> class
289 shipping in logback-classic no longer catches
290 <code>Throwable</code> but <code>Exception</code>. This change was
291 requested in <a
292 href="http://jira.qos.ch/browse/LOGBACK-1159">LOGBACK-1159</a> by
293 David J. M. Karlsen.
294 </p>
295
296 <p><code>BeanDescriptionFactory</code> no longer outputs a
297 superflous warning message in case the class contains bridge
298 methods. This fixes <a
299 href="http://jira.qos.ch/browse/LOGBACK-1164">LOGBACK-1164</a>
300 reported by Phil Clay.
301 </p>
302
303 <!--
304 <p>Added logback-bom module for use as a Maven "Bill of Materials"
305 <em>pom</em> file. This was requested in <a
306 href="http://jira.qos.ch/browse/LOGBACK-1157">LOGBACK-1157</a>
307 Joerg Sesterhenn.</p>
308 -->
309
310 <hr width="80%" align="center" />
311
312 <h3>March 29th, 2016, Release of version 1.1.7</h3>
313
314 <p>Logback is now <a href="
315 http://docs.oracle.com/javase/8/docs/technotes/guides/compactprofiles/compactprofiles.html">compact3
316 profile</a> compatible. This improvement was requested in <a
317 href="http://jira.qos.ch/browse/LOGBACK-1071">LOGBACK-1071</a> by
318 Axel Fontaine with Max Urech providing the relevant pull-request.
319 </p>
320
321 <p>Fixed <code>ConcurrentModificationException</code> being thrown
322 when the <code>reset()</code> method is invoked on the
323 <code>LoggerContext</code> instance. This issue was reported in <a
324 href="http://jira.qos.ch/browse/LOGBACK-397">LOGBACK-397</a> by
325 Szczepan Faber with Ross Sargant providing the relevant test case.
326 </p>
327
328 <p><code>TimeBasedRollingPolicy</code> now supports the <a
329 href="manual/appenders.html#tbrpTotalSizeCap"><span
330 class="option">totalSizeCap</span></a> property which allows the
331 user to limit the total size of archived logs.
332 </p>
333
334 <p><a
335 href="manual/appenders.html#SizeAndTimeBasedRollingPolicy"><code>SizeAndTimeBasedRollingPolicy</code></a>
336 offers the same functionality as
337 <code>SizeAndTimeBasedFNATP</code> did previously but with a
338 simpler configuration structure.
339 </p>
340
341 <p>Archive removal by <code>RollingFileAppender</code> is now
342 performed asynchronously.</p>
343
344 <p>Unnecessary and incompatible %i token in <span
345 class="option">fileNamePattern</span> option with
346 <code>RollingFileAppender/TimeBasedRollingPolicy</code> is now
347 detected and the user alerted to the misconfiguration
348 problem. This fixes <a
349 href="http://jira.qos.ch/browse/LOGBACK-1143">LOGBACK-1143</a>.
350 </p>
351
352
353 <p>Joran can now handle logger names ending with a $, i.e. the
354 first character in variable substitution. This issue was raised in
355 <a href="http://jira.qos.ch/browse/LOGBACK-1149">LOGBACK-1149</a>
356 by by Stevo Slavic.
357 </p>
358
359
360
361 <hr width="80%" align="center" />
362
363 <h3>February 29th, 2016, Release of version 1.1.6</h3>
364
365 <p><code>LogbackValve</code> (in logback-access) now attempts to
366 load the configuration file as a resource if it cannot be found on
367 the filesystem (<a
368 href="http://jira.qos.ch/browse/LOGBACK-1069">LOGBACK-1069</a>). This
369 is helpful in scenarios where applications are using an embedded
370 Tomcat server.</p>
371
372 <p><code>JMXConfigurator.reloadDefaultConfiguration()</code>
373 method now tolerates programmatic configuration without a
374 URL. This change was provided by Vedran Pavic in <a
375 href="https://github.com/qos-ch/logback/pull/302">PR 302</a>.
376 </p>
377
378 <p><code>RollingFileAppender</code> will output an error message
379 if the date time pattern in the %d token within the <span
380 class="option">fileNamePattern</span> is not collision free. This
381 fixes <a
382 href="http://jira.qos.ch/browse/LOGBACK-1137">LOGBACK-1137</a>. In
383 a similar vein, every instance of <code>FileAppender</code> will
384 now detect if it shares the same <span class="option">File</span>
385 option value as given for an appender defined earlier. In
386 addition, <code>RollingFileAppender</code> instances now check for
387 colliding <span class="option">FileNamePattern</span> values.</p>
388
389 <p>Fixed <code>NullPointerException</code> thrown by
390 <code>RollingFileAppender</code> if the name of the rollover
391 target path did not contain a parent. This issue was reported in
392 <a href="http://jira.qos.ch/browse/LOGBACK-1054">LOGBACK-1054</a>
393 by Paulius Matulionis. Analysis of the problem and the relevant PR
394 was provided by Ferenc Palkovics.</p>
395
396 <p><code>BasicConfigurator.configure</code> method call executes
397 significatly faster. Improved documentation for configuration
398 using JDK 1.6 service-provider facility. These changes are in
399 response to <a
400 href="http://jira.qos.ch/browse/LOGBACK-1141">LOGBACK-1141</a>
401 requesting faster logback start-up time.
402 </p>
403
404
405 <p>Fixed issue with variable substitution with the value ending in
406 a colon. This problem was reported in <a
407 href="http://jira.qos.ch/browse/LOGBACK-1140">LOGBACK-1140</a> by
408 Eric Cook.</p>
409
410 <hr width="80%" align="center" />
411
412 <h3>February 13th, 2016, Release of version 1.1.5</h3>
413
414 <div class="breaking">
415 <h4>MDC values are no longer inherited by child threads.</h4>
416 </div>
417
418 <p>Child threads no longer inherit MDC values. In previous
419 versions of logback as well as log4j 1.x, MDC values were
420 inherited by child threads. Several users have argued convincingly
421 that MDC inheritance by child threads was unhelpful and even
422 dangerous. This change fixes <a
423 href="http://jira.qos.ch/browse/LOGBACK-422">LOGBACK-422</a> and <a
424 href="http://jira.qos.ch/browse/LOGBACK-624">LOGBACK-624</a>
425 </p>
426
427 <p>When the <code>FileNamePattern</code> string for
428 <code>RollingFileAppender/SizeAndTimeBasedFNATP</code> lacks a %i
429 token, then compression for the second archive in the same period
430 cannot occur as the target file already exists. Under those
431 circumstances, logback leaves behind .tmp files as reported in <a
432 href="http://jira.qos.ch/browse/LOGBACK-992">LOGBACK-992</a>, <a
433 href="http://jira.qos.ch/browse/LOGBACK-173">LOGBACK-173</a> and
434 <a
435 href="http://jira.qos.ch/browse/LOGBACK-920">LOGBACK-920</a>. In
436 this release, this particular condition is detected by
437 <code>RollingFileAppender</code> which will not start but alert
438 the user instead.
439 </p>
440
441 <p>AsyncAppender is now configurable to never block. This feature
442 was requested by Jeff Wartes in <a
443 href="http://jira.qos.ch/browse/LOGBACK-898">LOGBACK-898</a> with
444 Jeff Wartes and Gareth Davis providing the relevant patch.
445 </p>
446
447
448 <hr width="80%" align="center" />
449
450 <h3>February 11th, 2016, Release of version 1.1.4</h3>
451
452 <div class="breaking">
453 <h4>Logback 1.1.4 requires SLF4J version 1.7.16 or later.</h4>
454 </div>
455
456 <p>Added event replay support as introduced in SLF4J version
457 1.7.15. In most circumstances, logack-classic should run fine with
458 earlier versions of slf4j-api, including all versions in the 1.6.x
459 and 1.7.x series. However, with a version of slf4j-api.jar earlier
460 than 1.7.15 in the classpath, attempting introspection of a
461 <code>Logger</code> instance will result in a
462 <code>NoClassDefFoundError</code> similar to that shown below.
463 </p>
464
465 <pre class="prettyprint source">Exception in thread "main" java.lang.NoClassDefFoundError: org/slf4j/event/LoggingEvent
466 at java.lang.Class.getDeclaredMethods0(Native Method)
467 at java.lang.Class.privateGetDeclaredMethods(Class.java:2451)
468 at java.lang.Class.privateGetPublicMethods(Class.java:2571)
469 at java.lang.Class.getMethods(Class.java:1429)
470 at java.beans.Introspector.getPublicDeclaredMethods(Introspector.java:1261)
471 at java.beans.Introspector.getTargetMethodInfo(Introspector.java:1122)
472 at java.beans.Introspector.getBeanInfo(Introspector.java:414)
473 at java.beans.Introspector.getBeanInfo(Introspector.java:161)
474 </pre>
475
476 <p>
477 </p>
478
479 <div class="breaking">
480 <h4>Packaging data (as output in stack traces) is now disabled
481 by default.
482 </h4>
483 </div>
484
485 <p>In case an application throws exceptions frequently, then
486 computing packaging data can be very costly and will cause the
487 application to run slower. Making bad worse. To alleviate this
488 problem, packaging data is no longer computed by default. It has
489 to be <a href="manual/configuration.html#packagingData">enabled
490 explicitly</a>. In the absence of explicit instructions, i.e the
491 user has not specified a converter handling exceptions,
492 <code>PatternLayout</code> in logback-classic will follow the
493 settings defining for the logging environment. If packaging data
494 is disabled, then it add %ex as a suffix in the pattern, and if
495 packaging data is enabled then %xEx will be added. These changes
496 fix <a
497 href="http://jira.qos.ch/browse/LOGBACK-730">LOGBACK-730</a> and
498 <a href="http://jira.qos.ch/browse/LOGBACK-966">LOGBACK-966</a>.
499 </p>
500
501
502 <p>Fixed a bug in
503 <code>TimeBasedFileNamingAndTriggeringPolicyBase</code> causing
504 time-based rolling policies to always rollover according to the
505 local system time and ignore the time zone passed in the file name
506 pattern. The issue was reported by Lukasz Sanek who also provided
507 the the relevant fix. </p>
508
509 <p><code>AsyncAppenderBase</code> now restores the current
510 thread's interrupt flag when catching an
511 <code>InterruptedException</code>. The issue
512 (<a href="http://jira.qos.ch/browse/LOGBACK-910">LOGBACK-910</a>) was
513 raised by Henrik Nordvik who also provided the relevant fix.</p>
514
515 <hr width="80%" align="center" />
516
517 <h3>24th of March 2015, Release of version 1.1.3</h3>
518
519
520 <div class="breaking">
521 <h4>As of version 1.1.3, all logback modules require JDK 1.6
522 instead of previously JDK 1.5. This change was put to
523 consultation on the logback mailing lists with no objections
524 raised.</h4>
525 </div>
526
527
528 <p>Fixed <code>FileAppender</code>'s prudent mode so that it properly recovers
529 from IO Errors
530 (<a href="http://jira.qos.ch/browse/LOGBACK-1046">LOGBACK-1046</a>) </p>
531
532 <p>Irrelevant or internal stack trace lines can now be omitted. Pull request
533 provided by Tomasz Nurkiewicz
534 (<a href="http://jira.qos.ch/browse/LOGBACK-540">LOGBACK-540</a>).</p>
535
536 <p><code>AccessEvent</code> now creates a copy of request attributes when
537 its <code>prepareForDeferredProcessing()</code> method is called. This makes
538 attributes visible even if an appender uses a background thread to process
539 events.
540 (<a href="http://jira.qos.ch/browse/LOGBACK-1033">LOGBACK-1033</a>)</p>
541
542 <p>All threads opened by <code>ch.qos.logback.core.util.ExecutorServiceUtil#THREAD_FACTORY</code>
543 are now daemons, which fixes an application hang on shutdown when <code>LoggerContext#stop()</code>
544 is not called (<a href="http://jira.qos.ch/browse/LOGBACK-929">LOGBACK-929</a>).
545 Note that daemon threads are abruptly terminated by the JVM, which may cause
546 undesirable results, such as corrupted files written by the <code>FileAppender</code>.
547 It is still highly recommended for the application to call <code>LoggerContext#stop()</code>
548 (e.g., in a shutdown hook) to gracefully shutdown appenders.</p>
549
550 <p>Fixed an issue with <code>RollingFileAppender</code> where the first
551 rollover file could be unintentionally deleted, depending on the specified
552 filename pattern
553 (<a href="http://jira.qos.ch/browse/LOGBACK-894">LOGBACK-894</a>).</p>
554
555 <p>Fixed an issue with <code>TeeHttpServletResponse</code>
556 where the system default encoding would be used instead of the
557 response encoding when constructing a new writer
558 (<a href="http://jira.qos.ch/browse/LOGBACK-1023">LOGBACK-1023</a>).</p>
559
560 <p>Fixed <code>ConfigurationDelegate.groovy</code> to allow any appender
561 that implements <code>AppenderAttachable</code>, which supports third-party
562 appenders, such as <b>reactor-logback's</b> <code>AsyncAppender</code>
563 (<a href="http://jira.qos.ch/browse/LOGBACK-1008">LOGBACK-1008</a>)</p>
564
565 <p>Added support for specifying the callstack depth range in the
566 <code>PatternLayout</code>. For example, <code>%caller{1..2}</code>
567 displays the first two calls in the callstack.</p>
568
569 <p>Added HTTP request method to <code>MDCInsertingServletFilter</code>.</p>
570
571 <p>Fixed time-zone dependent code in <code>RollingCalendarTest</code>.
572 (<a href="http://jira.qos.ch/browse/LOGBACK-116">LOGBACK-116</a>)
573 </p>
574
575 <p>Simplified connection logic of SocketApender to reduce multi-threading
576 overhead and unnecessary instantiation of <code>SocketConnector</code>
577 objects.</p>
578
579 <p>Fixed race condition in <code>SMTPAppenderBase</code> causing missing or
580 duplicate emails.
581 (<a href="http://jira.qos.ch/browse/LOGBACK-909">LOGBACK-909</a>)
582 </p>
583
584 <p>Fixed an issue with <code>FileAppender</code> in prudent mode, where
585 an interrupt could prevent further access to the file
586 (<a href="http://jira.qos.ch/browse/LOGBACK-875">LOGBACK-875</a>).</p>
587
588 <p>Fixed <code>IllegalStateException</code> when multiple threads
589 write files to same directory
590 (<a href="http://jira.qos.ch/browse/LOGBACK-128">LOGBACK-128</a>).</p>
591
592 <p>Changed queue consumption strategy in <code>AbstractSocketAppender</code>
593 from "take" to "peek/remove" in order to avoid losing an event on each socket
594 connection break. Zero is now a deprecated queue size. A queue size of one
595 should be taken instead to indicate synchronous processing.
596 (<a href="http://jira.qos.ch/browse/LOGBACK-977">LOGBACK-977</a>)
597 </p>
598
599 <p><code>RequestLogImpl</code> now has an overridable <code>configure</code>
600 method to allow extending implementations to configure it via methods
601 other than the <code>logback-access.xml</code> file.</p>
602
603 <p>Fixed a bug in <code>AccessEvent</code> which could cause any
604 <code>AsyncAppender</code> based appender to corrupt the request
605 headers, request parameters, or response headers, before logging.</p>
606
607 <p>SQL scripts to setup your logback database are now provided as
608 JAR resources
609 (<a href="http://jira.qos.ch/browse/LOGBACK-948">LOGBACK-948</a>).
610 </p>
611
612 <p>Threads created internally by logback are now named
613 <i>logback-n</i>, where <i>n</i> is an integer. For the
614 first thread <i>n</i> is set to 1, for each successive thread
615 <i>n</i> is incremented by 1.</p>
616
617 <p>Added max runtime parameter to <code>AsyncAppender</code> to allow
618 the appender to flush events, up to a maximum delay, during a stop
619 of the LoggerContext. This can be used to ensure that all queued
620 events are flushed.</p>
621
622 <p>Added new configuration element <code>shutdownHook</code> to allow the
623 user to specify a ShutdownHook implementation that will stop the Logback
624 context upon JVM exit.
625 </p>
626
627 <p><code>BasicStatusManager</code> now prevents adding more than
628 one instance of <code>OnConsoleStatusListener</code> as a status
629 listener. This fixes <a
630 href="http://jira.qos.ch/browse/LOGBACK-976">LOGBACK-976</a>.
631 </p>
632
633 <p><code>TimeBasedRollingPolicy</code> now accepts a time zone in
634 its <code>%d</code> conversion pattern. (<a
635 href="http://jira.qos.ch/browse/LOGBACK-611">LOGBACK-611</a>)
636 </p>
637
638 <p>It is now possible to configure the character encoding used by
639 <code>SyslogAppender</code> to encode messages using the
640 <code>setCharset()</code> method. This fixes <a
641 href="http://jira.qos.ch/browse/LOGBACK-732">LOGBACK-732</a>
642 </p>
643
644 <h3>2nd of April, 2014 - Release of version 1.1.2</h3>
645
646 <p>Create an abstract method, createOutputStream, as an extension point
647 for subclasses of SyslogBaseAppender to create their own OutputStream.
648 <a href="http://jira.qos.ch/browse/LOGBACK-890">LOGBACK-890</a>
649 </p>
650
651 <p>Removed deprecated constructors in <code>SocketAppender</code>
652 and related classes.</p>
653
654 <p>Fixed incorrect date format in <code>SyslogAppender</code>.
655 (<a href="http://jira.qos.ch/browse/LOGBACK-936">LOGBACK-936</a>)
656 </p>
657
658 <p>Fixed <code>NullPointerException</code> when substituting blank variables
659 (<a href="http://jira.qos.ch/browse/LOGBACK-959">LOGBACK-959</a>)</p>
660
661 <p>Fixed <code>NullPointerException</code> that occurs when stopping a
662 <code>SyslogAppender</code> that did not properly initialize, e.g.,
663 due to a hostname resolution failure.
664 (<a href="http://jira.qos.ch/browse/LOGBACK-960">LOGBACK-960</a>)
665 </p>
666
667 <p>Use fair locking in <code>OutputStreamAppender</code>. Patch provided by
668 Sergey Bykov.
669 (<a href="http://jira.qos.ch/browse/LOGBACK-268">LOGBACK-268</a>)
670 </p>
671
672 <p>In case of missing included files, IncludeAction no longer
673 prints a stack trace but prints a warning instead. (<a
674 href="http://jira.qos.ch/browse/LOGBACK-954">LOGBACK-954</a>)</p>
675
676 <p>Fixed character escaping in XMLLayout
677 (<a href="http://jira.qos.ch/browse/LOGBACK-728">LOGBACK-728</a>)
678 and HTMLLayout
679 (<a href="http://jira.qos.ch/browse/LOGBACK-440">LOGBACK-440</a>).</p>
680
681 <hr width="80%" align="center" />
682
683 <h3>5th of February, 2014 - Release of version 1.1.1</h3>
684
685 <p>Logback now supports an unlimited level of <a
686 href="manual/configuration.html#variableSubstitution">variable</a>
687 resolution graphs rather than being limited to one level deep
688 resolution. This enhancement was requested by Anton Wiedermann in
689 <a href="http://jira.qos.ch/browse/LOGBACK-943">LOGBACK-943</a>
690 with Eric Dahl providing the relevant pull request.
691 </p>
692
693 <p>Fixed <a
694 href="http://jira.qos.ch/browse/LOGBACK-942">LOGBACK-942</a> which
695 was causing <code>SocketAppender</code> to drop events. Eric Dahl
696 provided the relevant pull request.
697 </p>
698
699 <hr width="80%" align="center" />
700
701 <h3>January 28th, 2014 - Release of version 1.1.0</h3>
702
703 <p>Previously, logback silently ignored configuration files that did
704 not have the ".xml" or ".groovy" file extension. Now, a <code>LogbackException</code>
705 is thrown to flag this error.
706 </p>
707
708 <p>Groovy configuration now supports <code>appenderRef</code>, which
709 allows the use of <code>AsyncAppender</code> in Groovy.
710 (<a href="http://jira.qos.ch/browse/LOGBACK-269">LOGBACK-269</a>)
711 </p>
712
713 <p><code>SizeAndTimeBasedFNATP</code> now supports a protected function
714 <code>#createArchiveRemover</code> that allows subclasses to specify
715 a custom archive remover used in <code>RollingFileAppender</code>. The
716 default archive remover is <code>SizeAndTimeBasedArchiveRemover</code>.
717 </p>
718
719 <p><code>PackagingDataCalculator</code> now catches and ignores
720 <code>UnsupportedOperationException</code> so that it can determine
721 whether the JVM supports <code>Reflection#getCallerClass()</code>
722 without printing that exception's stack trace. This only affects
723 Java 7u40+, which removed support for <code>Reflection#getCallerClass()</code>.
724 (<a href="http://jira.qos.ch/browse/LOGBACK-885">LOGBACK-885</a>)
725 </p>
726
727 <p>To facilitate debugging, <code>SimpleSocketServer</code> now names
728 its threads: "<b>Logback SimpleSocketServer (port <i>PORTNUM</i>)</b>".
729 <code>SocketNode</code> client threads are named:
730 "<b>Logback SocketNode (client: <i>IPADDR</i>)</b>".
731 </p>
732
733 <p>Fixed silently lost messages from <code>SyslogAppender</code>
734 when they exceeded the system datagram size limit. The default max
735 message size was hard coded to 65KB but now matches the system limit
736 (as read from
737 <a href="http://docs.oracle.com/javase/6/docs/api/java/net/DatagramSocket.html#getSendBufferSize()">
738 <code>DatagramSocket#getSendBufferSize()</code></a>) unless a
739 nonzero limit is specified via <code>SyslogAppender#setMaxMessageSize()</code>.
740 (<a href="http://jira.qos.ch/browse/LOGBACK-926">LOGBACK-926</a>)
741 </p>
742
743 <p>Fixed various documentation typos, including
744 <a href="http://jira.qos.ch/browse/LOGBACK-466">LOGBACK-466</a>,
745 <a href="http://jira.qos.ch/browse/LOGBACK-768">LOGBACK-768</a>,
746 <a href="http://jira.qos.ch/browse/LOGBACK-904">LOGBACK-904</a>,
747 <a href="http://jira.qos.ch/browse/LOGBACK-921">LOGBACK-921</a>,
748 and
749 <a href="http://jira.qos.ch/browse/LOGBACK-927">LOGBACK-927</a>.
750 </p>
751
752 <p><code>ContextBase.setStatusManager</code> now correctly validates
753 the given status manager.
754 (<a href="http://jira.qos.ch/browse/LOGBACK-912">LOGBACK-912</a>)
755 </p>
756
757 <p>The <code>SocketNode</code> creates an <code>ObjectInputStream</code>
758 using the socket's input stream, which blocks waiting for the
759 stream header. This wait has been moved from the constructor to
760 <code>SocketNode.run()</code> so that the node can be created without
761 blocking.
762 (<a href="http://jira.qos.ch/browse/LOGBACK-350">LOGBACK-350</a>)
763 </p>
764
765 <p>Fixed <code>SecurityException</code> during initialization
766 in Google AppEngine.
767 (<a href="http://jira.qos.ch/browse/LOGBACK-760">LOGBACK-760</a>)
768 </p>
769
770 <p>The <code>&lt;include&gt;</code> element now allows optional
771 resources (previously, only optional files).
772 (<a href="http://jira.qos.ch/browse/LOGBACK-644">LOGBACK-928</a>)
773 </p>
774
775 <p>Added new layout conversion word (<b>%D</b> or <b>%elapsedTime</b>),
776 which gets the time taken to serve the request. This applies
777 only to Jetty and Tomcat logs via logback-access.
778 (<a href="http://jira.qos.ch/browse/LOGBACK-320">LOGBACK-320</a>)
779 </p>
780
781 <p>Fixed SMTP error when the subject line contained multiple
782 new-lines.
783 (<a href="http://jira.qos.ch/browse/LOGBACK-865">LOGBACK-865</a>)
784 </p>
785
786 <p>Fixed unnecessary re-initialization of the servlet's
787 <code>LoggerContext</code> while attempting to destroy it.
788 </p>
789
790 <p>Added the following syslog facilities to <code>SyslogStartConverter</code>:
791 NTP, AUDIT, ALERT, CLOCK
792 (<a href="http://jira.qos.ch/browse/LOGBACK-754">LOGBACK-754</a>)
793 </p>
794
795 <p>Fixed <code>NullPointerException</code> when setting a JUL
796 logger's level to null, which should have reset the logger level
797 to the parent's effective level.
798 (<a href="http://jira.qos.ch/browse/LOGBACK-906">LOGBACK-906</a>)
799 </p>
800
801 <p>Added support to get suppressed exceptions. This is currently
802 only implemented for <code>RootCauseFirstThrowableProxyConverter</code>
803 and <code>ThrowableProxyConverter</code>.
804 (<a href="http://jira.qos.ch/browse/LOGBACK-516">LOGBACK-516</a>)
805 </p>
806
807 <p>Fixed problem of Janino classes not found in some environments
808 (axis2, GWT, etc.).
809 (<a href="http://jira.qos.ch/browse/LOGBACK-832">LOGBACK-832</a>)
810 </p>
811
812 <p>Fixed various unit tests, including modifications for consistent
813 results in Jenkins.
814 (<a href="http://jira.qos.ch/browse/LOGBACK-842">LOGBACK-842</a>)
815 </p>
816
817 <p>Allow Gaffer to read the <code>logback.debug</code> system
818 property to enable verbose output during Groovy-based configuration.
819 Also added debug statements to Gaffer.
820 </p>
821
822 <p>Fixed <code>IllegalArgumentException</code> when missing periods
823 and dollar signs in the logger name.
824 (<a href="http://jira.qos.ch/browse/LOGBACK-384">LOGBACK-384</a>)
825 </p>
826
827 <p>Fixed <code>NullPointerException</code> during JNDI lookup.</p>
828
829 <p>Fixed dangling data source connections from <code>DBAppender</code>
830 that caused <i>"maximum open cursors exceeded"</i>.</p>
831
832 <p>Fixed incorrect stack trace depth when specifying <code>%throwable</code>
833 with argument.
834 (<a href="http://jira.qos.ch/browse/LOGBACK-160">LOGBACK-160</a>)
835 </p>
836
837 <p>Fixed MySQL setup script to use lower-case table name to
838 match the references in the file. This had caused an error
839 on systems where case sensitivity matters.</p>
840
841 <p>Fixed <code>NullPointerException</code> when getting code source in
842 <code>PackagingDataCalculator</code>.</p>
843
844 <p>The search path for <code>logback-access.xml</code> is now
845 <code>${catalina.base}</code> and then <code>${catalina.home}</code>
846 if not found.
847 (<a href="http://jira.qos.ch/browse/LOGBACK-844">LOGBACK-844</a>)
848 </p>
849
850 <p>The <code>LoggingEvent</code> constructor delays message
851 formatting so that it can be computed lazily by the
852 <code>getFormattedMessage</code> method. This fixes <a
853 href="http://jira.qos.ch/browse/LOGBACK-873">LOGBACK-873</a> and
854 re-fixes <a
855 href="http://jira.qos.ch/browse/LOGBACK-495">LOGBACK-495</a>.
856 </p>
857
858 <p><code>PackagingDataCalculator</code> now checks for the case
859 where the caller has no protection domain. This fixes <a
860 href="http://jira.qos.ch/browse/LOGBACK-617">LOGBACK-617</a>
861 reported by Yuri de Wit. The relevant fix was provided by Mikhail
862 Mazursky.
863 </p>
864
865
866 <hr width="80%" align="center" />
867
868 <h3>May 10th, 2013 - Release of version 1.0.13</h3>
869
870 <p>In logback-access MANIFEST file, imports of Jetty and Tomcat
871 are now optional. This fixes <a
872 href="http://jira.qos.ch/browse/LOGBACK-300">LOGBACK-300</a>
873 reported by Christian Brensing who also provided the appropriate
874 pull request.
875 </p>
876
877 <p>Logback will now correctly parses variables with a default
878 separator string nested within accolades, e.g. "{a:-b}". Such
879 strings resemble variable references but lack the $ prefix, e.g
880 "${a:-b}". This fixes <a
881 href="http://jira.qos.ch/browse/LOGBACK-859">LOGBACK-859</a>
882 reported by Yoni Moses.</p>
883
884 <p>In <code>InterpretationContext</code> class replaced code using
885 JDK 1.6 API with code using JDK 1.5. This fixes <a
886 href="http://jira.qos.ch/browse/LOGBACK-860">LOGBACK-860</a>
887 reported by Bas Stoker.
888 </p>
889
890 <p>Updated the "org.fusesource.jansi:jansi" dependency to version
891 1.9.</p>
892
893 <hr width="80%" align="center" />
894
895 <h3>April 26th, 2013 - Release of version 1.0.12</h3>
896
897 <p>A new <code>SSLSocketAppender</code> extends the basic
898 <code>SocketAppender</code> providing the ability to deliver
899 logging events over the Secure Socket Layer (SSL). The
900 corresponding <code>SimpleSSLSocketServer</code> extends the classic
901 <code>SimpleSocketServer</code> as a basic logging server
902 application that receives logging events from a
903 <code>SSLSocketAppender</code>.</p>
904
905 <p class="highlight">Receiver components are configured in
906 logback.xml just like any other logback component.</p>
907
908 <p>While <code>SimpleSocketServer</code> (and its new SSL-enabled
909 counterpart, <code>SimpleSSLSocketServer</code>) provide an
910 easy-to-use standalone logging server application, a new component
911 type known as a <em>receiver</em> allows <em>any</em> application
912 to receive logging events from remote appenders over a TCP/IP network
913 connection, using Logback Classic. Receiver components are
914 configured in <em>logback.xml</em> just like any other logback
915 component.</p>
916
917 <p>A receiver can either listen passively for connections from
918 remote <code>SocketAppender</code> components acting as clients,
919 or it can assume the client role, initiating a connection to a
920 remote appender acting as a server. The receiver components
921 shipped with Logback include full support for logging event
922 delivery over the Secure Sockets Layer (SSL).</p>
923
924 <p>All of the new socket-based receiver and appender components were
925 contributed by Carl Harris. See
926 <a href="manual/receivers.html">Receivers</a> in the Logback Manual
927 for more information on configuring receiver components. See
928 <a href="manual/appenders.html#SocketAppender">SocketAppender</a> and
929 <a href="manual/appenders.html#serverSocketAppender">ServerSocketAppender</a>
930 for information on configuring appenders as event sources for
931 receiver components.</p>
932
933 <p><code>RollingFileAppender</code> will now detect when <span
934 class="option">file</span> property collides with <span
935 class="option">fileNamePattern</span>, emit <a
936 href="codes.html#rfa_collision">an error message</a> and refuse to
937 initialize. This was requested in <a
938 href="http://jira.qos.ch/browse/LOGBACK-796">LOGBACK-796</a> by
939 Karl Pietrzak who also provided a patch.
940 </p>
941
942 <p>In configuration files, the <code>&lt;include></code> element
943 now admits the <span class="attr">optional</span> attribute. This
944 fixes <a
945 href="http://jira.qos.ch/browse/LOGBACK-230">LOGBACK-230</a>
946 reported by Attila Kiraly. Many thanks to Tommy Becker who
947 contributed a patch.</p>
948
949 <p>In response to <a
950 href="http://jira.qos.ch/browse/LOGBACK-829">LOGBACK-829</a>,
951 serialization of <code>Logger</code> instances has been
952 significantly simplified and much unnecessary bloat removed. As an
953 added bonus, the new serialization of <code>Logger</code> objects
954 is also compatible with serialization streams using older Logger
955 instances. <code>Logger</code> instances serialized by logback
956 1.0.11 and earlier can be read by logback version 1.0.12 and later
957 and <em>vice-versa</em>.
958 </p>
959
960 <p>The code detecting whether Groovy is available on the class
961 path deals with the case where logback binaries are installed as
962 endorsed libraries. This fixes <a
963 href="http://jira.qos.ch/browse/LOGBACK-831">LOGBACK-831</a>.
964 </p>
965
966 <p class="highlight">Groovy configurator no longer supports
967 <code>SiftingAppender</code>.</p>
968
969 <p>In response to <a
970 href="http://jira.qos.ch/browse/LOGBACK-244">LOGBACK-244</a>, <a
971 href="http://jira.qos.ch/browse/LOGBACK-724">LOGBACK-724</a> and
972 in particular patches provided by Tommy Becker and David Roussel
973 component tracking code has been simplified and completely
974 re-written. <code>SiftingAppender</code> now supports the <a
975 href="manual/appenders.html#siftTimeout">timeout</a> and <a
976 href="manual/appenders.html#siftMaxAppenderCount">maxAppenderCount</a>
977 parameters. As a direct consequence of modifications to component
978 tracking code, the groovy configurator no longer supports
979 <code>SiftingAppender</code>.</p>
980
981 <p>SiftingAppender now propagates properties defined elsewhere in
982 the configuration file into the configuration process of nested
983 appenders. This fixes <a
984 href="http://jira.qos.ch/browse/LOGBACK-833">LOGBACK-833</a> with
985 David Roussel providing the appropriate patch.
986 </p>
987
988 <p>As all other actions affecting properties,
989 <code>TimestampAction</code> now inserts the user-specified
990 property into the local scope by default. The property was
991 inserted into the context scope in earlier versions of logback.
992 This fixes <a
993 href="http://jira.qos.ch/browse/LOGBACK-835">LOGBACK-835</a> with
994 David Roussel providing the appropriate patch.
995 </p>
996
997 <p>Logback is now able to retrieve the name of localhost when
998 running under OS X and Java 7. This issue was reported by <a
999 href="http://jira.qos.ch/browse/LOGBACK-749">LOGBACK-749</a> by
1000 Oliver Schrenk with patches provided by Ralph Goers and Pavel
1001 Valodzka.
1002 </p>
1003
1004 <p>The <a href="manual/layouts.html#mdc">mdc</a> converter can now
1005 handle default values. This feature was requested in <a
1006 href="http://jira.qos.ch/browse/LOGBACK-246">LOGBACK-246</a> by
1007 Michael Osipov with Denis Bazhenov providing a patch.
1008 </p>
1009
1010 <p><code>DBAppender</code> in logback-classic module no longer
1011 assumes that caller information is always available. This fixes <a
1012 href="http://jira.qos.ch/browse/LOGBACK-805">LOGBACK-805</a>
1013 reported by Daris Cooper who also provided a corrective patch.</p>
1014
1015 <p>In order to simplify our build, several unit tests have been
1016 ported from Scala to Java. It follows that logback no longer
1017 depends on Scala, not even during the test phase of the build.</p>
1018
1019 <h3>25th of March, 2013 - Release of version 1.0.11</h3>
1020
1021
1022 <p>Under Unix*, the basic/quick file rename method supplied by
1023 Java does not work if the source and target files are on different
1024 file systems. This problem was reported in <a
1025 href="http://jira.qos.ch/browse/LOGBACK-108">LOGBACK-108</a> by
1026 Daniel Potter. In order to deal with this issue, logback now will
1027 perform rename by copying if the source and target files are on
1028 different file systems and the host JDK is version 1.7 or
1029 later. See also the related <a
1030 href="codes.html#renamingError">error code</a>.</p>
1031
1032
1033 <p>The "cn" conversion word now correctly maps to
1034 <code>ContextNameConverter</code> class. This fixes <a
1035 href="http://jira.qos.ch/browse/LOGBACK-463">LOGBACK-463</a>
1036 reported by Michael Osipov with Mark A. Ziesemer providing the
1037 appropriate patch.
1038 </p>
1039
1040 <p>Added gray to the list of <a
1041 href="manual/layouts.html#coloring">ANSI colors supported by
1042 logback</a>. The relevant pull request was kindly provided by
1043 Craig P. Motlin.</p>
1044
1045 <p>The <code>discoverConnectionProperties()</code> method in class
1046 <code>ConnectionSourceBase</code> no longer leaks
1047 connections. This fixes <a
1048 href="http://jira.qos.ch/browse/LOGBACK-798">LOGBACK-798</a>
1049 reported by Sayevskiy Viacheslav. Many thanks to Ivan
1050 (Wee-Willie-Winkie) who contributed the appropriate fix.
1051 </p>
1052
1053 <p>In logback-access, more correct determination of whether
1054 contents of an <code>HttpServletRequest</code> are URL encoded or
1055 not. The <a href="https://github.com/qos-ch/logback/pull/71">bug
1056 fix</a> was submitted by David Schneider. The same issue was later
1057 independently reported by Grzegorz Kuligowski in <a
1058 href="http://jira.qos.ch/browse/LOGBACK-814">LOGBACK-814</a>.</p>
1059
1060 <p>Both <code>SocketAppenderBase</code> and
1061 <code>SimpleSocketServer</code> now use a socket factory to create
1062 sockets. These changes were asked in <a
1063 href="http://jira.qos.ch/browse/LOGBACK-815">LOGBACK-815</a> and
1064 <a href="http://jira.qos.ch/browse/LOGBACK-816">LOGBACK-816</a> by
1065 Carl Harris who also contributed the relevant patch.
1066 </p>
1067
1068 <hr width="80%" align="center" />
1069
1070 <h3>15th of March, 2013 - Release of version 1.0.10</h3>
1071
1072 <p>Upgraded the (optional) groovy dependency to version 2.0.7
1073 (from 2.0.0).</p>
1074
1075 <p>The logger cache field in <code>LoggerContext</code> now uses a
1076 <code>ConcurrentHashMap</code> instead of a regular
1077 <code>HashMap</code>. This dramatically improves the speed of
1078 logger retrieval and incidentally fixes <a
1079 href="http://jira.qos.ch/browse/LOGBACK-142">LOGBACK-142</a>.
1080 </p>
1081
1082 <p>In <code>SyslogAppender</code> allow <a
1083 href="manual/appenders.html#syslogSuffixPattern">suffixPattern</a>
1084 to begin with literal text. This issue was reported Bruno Polaco
1085 in <a href="http://jira.qos.ch/browse/LOGBACK-782">LOGBACK-782</a>
1086 who also provided the relevant patch.
1087 </p>
1088
1089 <p>In order to reduce unnecessary boilerplate several common types
1090 and packages are now <a
1091 href="manual/groovy.html#AutomaticImports">imported
1092 automatically</a>. This feature was contributed by Joris
1093 Kuipers.</p>
1094
1095 <p>Computation of caller information now takes into account Groovy
1096 frames (if nunning under Groovy). This fixes <a
1097 href="http://jira.qos.ch/browse/LOGBACK-811">LOGBACK-811</a>.</p>
1098
1099
1100
1101 <hr width="80%" align="center" />
1102
1103 <h3>December 5th, 2012 - Release of version 1.0.9</h3>
1104
1105 <p>Removed an erroneous compile-time dependency on Tomcat in the
1106 logback-classic module. This issue was reported by Arnaud
1107 Heritier.</p>
1108
1109 <hr width="80%" align="center" />
1110
1111 <h3>December 4th, 2012 - Release of version 1.0.8</h3>
1112
1113 <div class="breaking">
1114 <h4>logback-classic updated to use SLF4J version 1.7.2 instead
1115 of version 1.6.6.</h4>
1116 <p>The logback-classic module now uses SLF4J version 1.7.2
1117 instead of version 1.6.6. This only impacts projects running
1118 under an OSGi platform as SLF4J versions 1.7.x and 1.6.x are
1119 100% binary compatible.</p>
1120 </div>
1121
1122 <p>Fixed incorrect <code>BufferStream</code> assignment after
1123 recovery in <code>ResilientFileOutputStream</code>. This issue was
1124 reported in <a
1125 href="http://jira.qos.ch/browse/LOGBACK-765">LOGBACK-765</a> by
1126 David Markwick.
1127 </p>
1128
1129 <p>Fixed incorrect parsing of variables in case of colon character
1130 followed by a dollar character. This issue was reported in <a
1131 href="http://jira.qos.ch/browse/LOGBACK-744">LOGBACK-744</a>.</p>
1132
1133 <p><code>SyslogAppender</code> now sends out the header line of
1134 stack traces. This issue was reported <a
1135 href="http://jira.qos.ch/browse/LOGBACK-411">LOGBACK-411</a> and
1136 separately as <a
1137 href="http://jira.qos.ch/browse/LOGBACK-750">LOGBACK-750</a>.</p>
1138
1139 <p>A <code>StatusListener</code> implementing
1140 <code>LifeCycle</code> interface was not started if specified via
1141 the <code>logback.statusListenerClass</code> system property. This
1142 issue was reported in <a
1143 href="http://jira.qos.ch/browse/LOGBACK-767">LOGBACK-767</a> by
1144 Adam Sokowicz.
1145 </p>
1146
1147 <p>In order to avoid duplication, automatic status printing will
1148 be disabled if the user explicitly registers a status
1149 listerner.</p>
1150
1151 <p>Added <code>OnErrorConsoleStatusListener</code> to print status
1152 messages on the error console, i.e. on System.err. This feature
1153 was requested in <a
1154 href="http://jira.qos.ch/browse/LOGBACK-292">LOGBACK-292</a> by
1155 Abraham Lin. </p>
1156
1157 <p>Added <code>NopStatusListener</code> class which simply drops
1158 incoming status messages. By <a
1159 href="manual/configuration.html#logback.statusLC">explicitly
1160 registering</a> a <code>NopStatusListener</code> listener,
1161 automatic status printing can be turned off.
1162 </p>
1163
1164
1165 <hr width="80%" align="center" />
1166
1167 <h3>24th of August, 2012 - Release of version 1.0.7</h3>
1168
1169 <div class="breaking">
1170 <h4>Janino library upgraded to version 2.6.1.</h4>
1171
1172 <p>As of Janino version 2.6.0, in addition to
1173 <em>janino.jar</em>, <em>commons-compiler.jar</em> needs to be
1174 on the class path as well. Please see the <a
1175 href="setup.html#janino">Janino setup</a> instructions.</p>
1176 </div>
1177
1178 <p>
1179 </p>
1180
1181 <div class="breaking">
1182 <h4>Groovy dependency upgraded to version 2.0.0.</h4>
1183
1184 <p>Please see the <a href="setup.html#groovy">Groovy setup</a>
1185 instructions.</p>
1186 </div>
1187
1188 <p>The code handling variable substitution has been completely
1189 re-written. As requested in <a
1190 href="http://jira.qos.ch/browse/LOGBACK-729">LOGBACK-729</a>,
1191 variables can be now be nested arbitrarily, even within the
1192 default value section. For example,
1193 <code>${a${b:-c}:-${d:-e}}</code> is now a valid logback variable
1194 expression yielding "e", assuming variables with the keys 'd', 'b'
1195 and 'ac' are undefined. The new variable substitution code is
1196 designed to be backward compatible with existing configuration
1197 files.
1198 </p>
1199
1200
1201 <p>Substitution properties are now correctly recognized by <span
1202 class="attr">scan</span> and <span class="attr">scanPeriod</span>
1203 attributes of <code>&lt;configuration></code> element in
1204 configuration files. This fixes <a
1205 href="http://jira.qos.ch/browse/LOGBACK-396">LOGBACK-396</a>
1206 reported by Oh Chin Boon</p>
1207
1208 <p>The color-related conversion words now set the default color
1209 correctly. Xu Huisheng provided the relavant patch.
1210 </p>
1211
1212 <p>Fixed a race-condition in <code>AsyncAppender</code> and its
1213 worker thread. This issue was reported in <a
1214 href="http://jira.qos.ch/browse/LOGBACK-720">LOGBACK-720</a> by
1215 Arnd Hannemann who also supplied the relevant patch.</p>
1216
1217
1218 <p>If a <code>PropertyDefiner</code> implements
1219 <code>LifeCycle</code>, then its <code>start()</code> method will
1220 now be invoked.</p>
1221
1222 <p>Added the <span class="prop">includeCallerData</span> property
1223 in <code><a
1224 href="manual/appenders.html#smtpIncludeCallerData">SMTPAppender</a></code>
1225 to precompute caller data before storing events for future
1226 transmission. This property addresses <a
1227 href="http://jira.qos.ch/browse/LOGBACK-734">LOGBACK-734</a>
1228 reported by Patrick Hogarty.
1229 </p>
1230
1231 <hr width="80%" align="center" />
1232
1233 <h3>7th of June, 2012 - Release of version 1.0.6</h3>
1234
1235 <p><a
1236 href="manual/appenders.html#SMTPAppender"><code>SMTPAppender</code></a>
1237 now supports the retrieval of a <code>javax.mail.Session</code>
1238 resource from JNDI. This feature was requested in <a
1239 href="http://jira.qos.ch/browse/LBCLASSIC-332">LBCLASSIC-332</a>
1240 by Hrotko Gabor.</p>
1241
1242 <p>Listeners passed to <code>statusListener()</code> method in
1243 <code>GafferConfigurator</code> (the groovy configurator) are now
1244 correctly started.</p>
1245
1246 <hr width="80%" align="center" />
1247
1248 <h3>6th of June, 2012 - Release of version 1.0.5</h3>
1249
1250 <p><a
1251 href="manual/appenders.html#ConsoleAppender"><code>ConsoleAppender</code></a>
1252 can now activate the <a href="http://jansi.fusesource.org">Jansi
1253 library</a> for ANSI color code support on Windows
1254 systems. Unix-based operating systems such as Linux and Mac OS X
1255 already support ANSI color codes by default.</p>
1256
1257
1258 <p><code>PatternLayout</code> now supports <a
1259 href="manual/layouts.html#coloring">composite conversion
1260 specifiers for coloring</a>.</p>
1261
1262 <hr width="80%" align="center" />
1263
1264 <h3>31st of May, 2012 - Release of version 1.0.4</h3>
1265
1266 <p>Added <code>AsyncAppender</code> for asyncronous invocation of
1267 nested appenders. This was a long standing and popular request as
1268 attested by <a
1269 href="http://jira.qos.ch/browse/LBCLASSIC-177">LBCLASSIC-177</a>,
1270 <a href="http://jira.qos.ch/browse/LBCORE-92">LBCORE-92</a> and <a
1271 href="http://jira.qos.ch/browse/LBCLASSIC-242">LBCLASSIC-242</a>.</p>
1272
1273 <p><code>SMTPAppender</code> now admits the <span
1274 class="prop">asynchronousSending</span> property, set to 'true' by
1275 default. However, it can be set to 'false' for synchronous email
1276 transmission. This property was requested in <a
1277 href="http://jira.qos.ch/browse/LBCLASSIC-323">LBCLASSIC-323</a>
1278 by Patrick Houk.</p>
1279
1280 <p>It is now possible to set a system property called <a
1281 href="manual/configuration.html#automaticStatusPrinting">"logback.debug"</a>
1282 in order to force printing of internal status messages on the
1283 console regardless of the value of the <span
1284 class="attr">debug</span> attribute found within the
1285 <code>&lt;configuration></code> element. This behavior was
1286 requested in <a
1287 href="http://jira.qos.ch/browse/LBCLASSIC-225">LBCLASSIC-225</a>
1288 by Aaron Digulla with the relevant patch kindly provided by Antony
1289 Stubbs.
1290 </p>
1291
1292 <p><code>MarkerFilter</code> now correctly recognizes nested
1293 markers. This issue was reported in <a
1294 href="http://jira.qos.ch/browse/LBCLASSIC-295">LBCLASSIC-295</a>
1295 by Paolo Mazzoncini who also provided the relevant patch.</p>
1296
1297 <p>Fixed invalid multiple configuration warning when deployed
1298 under Weblogic. This issue was reported in <a
1299 href="http://jira.qos.ch/browse/LBCLASSIC-159">LBCLASSIC-159</a>
1300 by Hontv&aacute;ri J&oacute;zsef and with the appropriate patch
1301 provided by Derek Mahar.
1302 </p>
1303
1304 <p><a
1305 href="manual/appenders.html#SyslogAppender"><code>SyslogAppender</code></a>
1306 now admits the <span class="prop">throwableExcluded</span>
1307 property allowing the exclusion of throwable data if so
1308 desired. This solves <a
1309 href="http://jira.qos.ch/browse/LBCLASSIC-327">LBCLASSIC-327</a>
1310 reported by Don Faulkner.
1311 </p>
1312
1313 <p><a
1314 href="manual/appenders.html#SyslogAppender"><code>SyslogAppender</code></a>
1315 now admits the <span class="prop">stackTracePattern</span>
1316 property allowing the customization of the string appearing just
1317 before each stack trace line. This fixes <a
1318 href="http://jira.qos.ch/browse/LBCLASSIC-333">LBCLASSIC-333</a>
1319 reported by Ingebrigt Berg who also provided the relavant patch.
1320 </p>
1321
1322 <p><code>DBAppender</code> now supports SQLite. This feature was
1323 requested in <a
1324 href="http://jira.qos.ch/browse/LBGENERAL-53">LBGENERAL-53</a> by
1325 Tony Trinh who also provided the relevant patch.</p>
1326
1327
1328 <h3>4th of May, 2012 - Release of version 1.0.3</h3>
1329
1330 <p><code>PatternLayoutEncoder</code> class now admits the <span
1331 class="prop"><a
1332 href="manual/encoders.html#LayoutWrappingEncoder">immediateFlush</a></span>
1333 property (set to true by default). By setting this property to
1334 'false', logging throughput can be quintupled, although your
1335 mileage may vary. This enhancement was requested in <a
1336 href="http://jira.qos.ch/browse/LBCORE-243">LBCORE-243</a>.
1337 </p>
1338
1339 <p>In order to facilitate parsing of log files, logback can now <a
1340 href="manual/encoders.html#outputPatternAsHeader">output the
1341 pattern</a> used for the log output at the top of log files as a
1342 header. This feature was requested by James Strachan in <a
1343 href="http://jira.qos.ch/browse/LBCORE-234">LBCORE-234</a>.
1344 </p>
1345
1346 <p><code>SMTPAppender</code> failed to transmit messages under JDK
1347 1.5. After some investigation, Dave discovered that this was due to
1348 setting the <code>corePoolSize</code> parameter of the relevant
1349 <code>ThreadPoolExecutor</code> to 0. Setting
1350 <code>corePoolSize</code> to a higher value, e.g. 1, under JDK 1.5
1351 solves the problem and fixes <a
1352 href="http://jira.qos.ch/browse/LBCLASSIC-323">LBCLASSIC-323</a>
1353 reported by Lutz Huehnken.
1354 </p>
1355
1356 <p><code>LevelChangePropagator</code> now retains references to
1357 j.u.l. loggers whose level it sets. This fixes garbage collection
1358 issues reported in <a
1359 href="http://jira.qos.ch/browse/LBCLASSIC-256">LBCLASSIC-256</a>
1360 by Samuel Stanojevic who also provided the appropriate patch.
1361 </p>
1362
1363
1364 <h3>26th of April, 2012 - Release of version 1.0.2</h3>
1365
1366 <div class="breaking">
1367
1368 <h4><span class="label">Breaking change partially reverted in
1369 1.0.3</span><br/>By default <code>PatternLayout</code> will now output
1370 its pattern at the top of log files</h4>
1371
1372 <p>This feature, although still available, is no longer enabled by
1373 default. See release notes for version 1.0.3 for details.
1374 </p>
1375
1376
1377 </div>
1378
1379 <p><code>ReconfigureOnChangeFilter</code> will avoid excessive
1380 syncronization in case of CPU intensive applications. This fixes
1381 <a
1382 href="http://jira.qos.ch/browse/LBCLASSIC-234">LBCLASSIC-234</a>,
1383 a recalcitrant bug reported by Uri Unger who also provided the key
1384 steps for reproducing it.
1385 </p>
1386
1387 <p><code>RollingFileAppender</code> now creates missing
1388 directories for compressed archive files. This fixes <a
1389 href="http://jira.qos.ch/browse/LBCORE-169">LBCORE-169</a>
1390 reported by Tomasz Nurkiewicz with patches supplied by Paulo
1391 Andrade and Mats Henrikson.
1392 </p>
1393
1394 <p><code>SizeAndTimeBasedFNATP</code> will now remove files with
1395 indexes higher than 99. It will also correctly compute the highest
1396 index value when an application is restarted. This fixes bug <a
1397 href="http://jira.qos.ch/browse/LBCORE-221">LBCORE-221</a>
1398 reported by Dieter Mueller and Dawid Chodura.</p>
1399
1400
1401 <hr width="80%" align="center" />
1402
1403 <h3>7th of March, 2012 - Release of version 1.0.1</h3>
1404
1405 <p>Setting the debug attribute to true in the
1406 <code>&lt;configuration></code> element now registers a
1407 <code>OnConsoleStatusListener</code> with the
1408 <code>StatusManager</code>. Thus, problems occurring during the
1409 lifetime of your application, well after logback is initialized,
1410 can be reported when the <span class="attr">debug</span> attribute
1411 is set. This behavior is closer to what users expect.
1412 </p>
1413
1414 <p>Added new property the <span
1415 class="prop">cleanHistoryOnStart</span> to <a
1416 href="manual/appenders.html#TimeBasedRollingPolicy">TimeBasedRollingPolicy</a>.
1417 By setting this property to <code>true</code>, history removal
1418 will work as expected even in the case of short lived
1419 applications. This fixes <a
1420 href="http://jira.qos.ch/browse/LBCORE-226">LBCORE-226</a>
1421 reported by Bruce E. Irving.
1422 </p>
1423
1424 <p>It is now possible to specify multiple %d tokens in the file
1425 name pattern of <a
1426 href="manual/appenders.html#TimeBasedRollingPolicy">TimeBasedRollingPolicy</a>. Auxiliary
1427 %d tokens must be marked as such by passing the AUX
1428 parameter. This feature was requested in <a
1429 href="http://jira.qos.ch/browse/LBCORE-242">LBCORE-242</a> by
1430 Thomas Corte.</p>
1431
1432 <p>Logback now supports suppressed exceptions introduced in Java
1433 7. This fixes <a
1434 href="http://jira.qos.ch/browse/LBCLASSIC-276">LBCLASSIC-276</a>.
1435 </p>
1436
1437 <p><code>SMTPAppender</code> clears the relevant cyclic buffer
1438 before asynchronous transmission. This corrects <a
1439 href="http://jira.qos.ch/browse/LBCLASSIC-221">LBCLASSIC-221</a>
1440 as reported by Chris Cheshire.
1441 </p>
1442
1443 <p><code>SiftingAppender</code> will consider stale and
1444 consequently remove nested appenders which are closed or
1445 improperly started. This caters for the use case described in <a
1446 href="http://jira.qos.ch/browse/LBCLASSIC-316">LBCLASSIC-316</a>
1447 by Guus Bloemsma.</p>
1448
1449 <p><code>RequestLogImpl</code> can now lookup for the
1450 logback-access configuration file as a class path resource. This
1451 feature was requested in <a
1452 href="http://jira.qos.ch/browse/LBACCESS-26">LBACCESS-26</a> by
1453 Marshall Pierce.
1454 </p>
1455
1456 <p>Updated the Janino dependency to version 2.5.16. In addition,
1457 the code checking for the availability of Janino on the class path
1458 was updated to take Janino 2.6 into account, thus fixing <a
1459 href="http://jira.qos.ch/browse/LBCORE-210">LBCORE-210</a>.
1460 </p>
1461
1462
1463 <hr width="80%" align="center" />
1464
1465 <h3>1st of November, 2011 - Release of version 1.0.0</h3>
1466
1467 <p>The logback-access module now targets Tomcat 7.x and Jetty 7.x
1468 &amp; 8.x as its servlet container platforms. This fixes <a
1469 href="http://jira.qos.ch/browse/LBACCESS-17">LBACCESS-17</a>
1470 reported by Grzegorz Grzybek.</p>
1471
1472 <div class="breaking">
1473
1474 <h4>Breaking change: properties are no longer automatically
1475 inserted into the context</h4>
1476
1477 <p>Properties now have a scope. Previously, the definition of a
1478 property added it to the context. As of version 1.0, properties
1479 are local, i.e. transient by default. For further details, please
1480 refer to the <a
1481 href="manual/configuration.html#variableSubstitution">documentation
1482 on properties</a>.</p>
1483 </div>
1484
1485 <p>Environment variables are now looked up during property
1486 substitution. This feature was requested in <a
1487 href="http://jira.qos.ch/browse/LBCORE-212">LBCORE-212</a> by
1488 Alexandre Garnier.
1489 </p>
1490
1491 <p><code>SMTPAppender</code> now sends emails asynchronously.</p>
1492
1493 <p>Investigation of <a
1494 href="http://jira.qos.ch/browse/LBCORE-224">LBCORE-224</a>
1495 reported by Cesar Alvarez Nunez points to bug in the JVM rather
1496 than in logback. A workaround has been found by using
1497 <code>CopyOnWriteArrayList</code> instead of the apparently buggy
1498 <code>ReadWriteLock</code>.</p>
1499
1500 <p>In STARTTLS mode, "mail.smtp.auth" property is no longer set
1501 automatically. This fixes <a
1502 href="http://jira.qos.ch/browse/LBCORE-225">LBCORE-225</a>
1503 reported by Mark Woon.</p>
1504
1505 <p>Logback-access now supports conditional configuration. This
1506 fixes <a
1507 href="http://jira.qos.ch/browse/LBACCESS-27">LBACCESS-27</a>
1508 reported by Marshall Pierce.</p>
1509
1510 <p>Logback-access now supports inclusion of configuration
1511 files. See the <a
1512 href="manual/configuration.html#fileInclusion">chapter about
1513 configuration</a> in the logback's online manual for more
1514 information. </p>
1515
1516 <p>Added <code>ch.qos.logback.core.read</code> to "Import-Package"
1517 declaration in logback-classic's manifest file. This fixes <a
1518 href="http://jira.qos.ch/browse/LBCLASSIC-131">LBCLASSIC-131</a>
1519 reported by Michal Prihoda and Thomas Jaeckle.</p>
1520
1521 <p>Fixed infinitely recursive calls in
1522 <code>AccessConverter#addError</code> methods as reported in <a
1523 href="http://jira.qos.ch/browse/LBACCESS-25">LBACCESS-25</a> by
1524 Pierre Queinnec.
1525 </p>
1526
1527 <p>Fixed incorrect switch fallthrough while selecting between the
1528 H2 and HSQL dialects as reported in <a
1529 href="http://jira.qos.ch/browse/LBCORE-218">LBCORE-218</a> by
1530 Pierre Queinnec.
1531 </p>
1532
1533 <h3>September 21st, 2011 - Release of version 0.9.30</h3>
1534
1535 <p>Archive removal can now deal with prolonged periods of
1536 application inactivity and application stop and restarts. The
1537 issue is described in <a
1538 href="http://jira.qos.ch/browse/LBCORE-147">LBCORE-147</a>
1539 reported by Rafael Diaz Maurin.
1540 </p>
1541
1542 <p>Logback-classic now supports printing stack traces "root cause
1543 first" instead of the standard "root cause last". See the
1544 documentation for <a
1545 href="manual/layouts.html#rootException">%rootException</a>
1546 converter for further details. The <code>%rootException</code>
1547 converter was contributed by Tomasz Nurkiewicz in relation with <a
1548 href="http://jira.qos.ch/browse/LBCLASSIC-217">LBCLASSIC-217</a>.
1549 </p>
1550
1551 <p>In the <code>ILoggingEvent</code> interface the
1552 <code>getMDC</code> method is now deprecated and replaced by
1553 <code>getMDCPropertyMap</code>. The latter method was already part
1554 of the <code>ILoggingEvent</code> interface in prior versions of
1555 logback-classic. Furthermore, the value returned by
1556 <code>ILoggingEvent.getMDCPropertyMap</code> can now be an empty
1557 map but never null.</p>
1558
1559
1560 <p><code>LoggingEvent</code> no longer assumes that
1561 <code>LogbackMDCAdapter</code> is the only possible implementation
1562 of the <code>MDCAdapter</code> interface. This fixes <a
1563 href="http://jira.qos.ch/browse/LBCLASSIC-275">LBCLASSIC-275</a>
1564 reported by Chris Dolan.
1565 </p>
1566
1567 <p><code>LogbackMDCAdapter</code> now synchronizes over its thread
1568 local map. This prevents
1569 <code>ConcurrentModificationException</code> from occurring while a
1570 child thread copies the map from the parent. This fixes <a
1571 href="http://jira.qos.ch/browse/LBCLASSIC-289">LBCLASSIC-289</a>
1572 reported by Josh Oddman.</p>
1573
1574 <p>It is now possible to specify multiple destination addresses
1575 separated by commas in the the <span class="prop">to</span>
1576 property of <code>SMTPAppender</code>. This fixes <a
1577 href="http://jira.qos.ch/browse/LBCORE-213">LBCORE-213</a>
1578 reported by Alexandre Garnier who also provided the relevant
1579 patch. In previous versions of logback multiple destination
1580 addresses could only be specified by using multiple <span
1581 class="prop">to</span> properties. As of version 0.9.30 both
1582 comma separated addresses and multiple <span
1583 class="prop">to</span> properties are supported.
1584 </p>
1585
1586 <p>When debug attribute is set to true within the
1587 <code>&lt;configuration></code> element, status messages are
1588 printed on the console after Joran (re)configures
1589 logback. Previously, all status messages were printed. With this
1590 release, only status messages created during (re)configuration are
1591 printed. This change fixes <a
1592 href="http://jira.qos.ch/browse/LBCLASSIC-273">LBCLASSIC-273</a>
1593 reported by Joern Huxhorn.
1594 </p>
1595
1596 <p>Single quotes within a date conversion specifier in filename
1597 patterns are now handled correctly. This fixes <a
1598 href="http://jira.qos.ch/browse/LBCORE-214">LBCORE-214</a>
1599 reported by Derek Libby.
1600 </p>
1601
1602 <hr width="80%" align="center" />
1603
1604 <h3>June 9th, 2011 - Release of version 0.9.29</h3>
1605
1606 <p>Fixed <a
1607 href="http://jira.qos.ch/browse/LBCLASSIC-254">LBCLASSIC-254</a>,
1608 a performance issue in <code>LogbackMDCAdapter</code> as reported
1609 by Michael Franz.</p>
1610
1611 <p>Given that events reference a snapshot of the current MDC map,
1612 the snapshot should not be cleared upon invocation of the
1613 MDC.clear operation. This issue was reported in <a
1614 href="http://jira.qos.ch/browse/LBCLASSIC-253">LBCLASSIC-253</a>
1615 by Tommy Becker and independently fixed by the changes designated
1616 to fix LBCLASSIC-254.</p>
1617
1618 <p>As reported by Deepak Vadgama in <a
1619 href="http://jira.qos.ch/browse/LBCORE-199">LBCORE-199</a>, the
1620 entry in every zip file created by
1621 <code>FixedWindowRollingPolicy</code> had the same name. The issue
1622 was solved by adding a timestamp to the name of the entry in the
1623 zip files as suggested by a Benoit Xhenseval.</p>
1624
1625 <p><code>ConfigurationWatchList</code> no longer emits an error
1626 message when it encounters a configuration file placed in a jar
1627 file, fixing <a
1628 href="http://jira.qos.ch/browse/LBCLASSIC-246">LBCLASSIC-246</a>
1629 as reported by Joern Huxhorn. This release also fixes <a
1630 href="http://jira.qos.ch/browse/LBCLASSIC-247">LBCLASSIC-247</a>
1631 reported by Michael Franz.
1632 </p>
1633
1634
1635 <p>Logback now emits a clearer error message in case a conversion
1636 pattern misses a closing parenthesis or if an opening
1637 parenthesis is misplaced. This fixes <a
1638 href="http://jira.qos.ch/browse/LBCORE-193">LBCORE-193</a>
1639 reported by B. K. Oxley.</p>
1640
1641 <p>Fixed thread safety issue in LRUMessageCache reported in <a
1642 href="http://jira.qos.ch/browse/LBCLASSIC-255">LBCLASSIC-255</a>
1643 by C&eacute;sar &Aacute;lvarez N&uacute;&ntilde;ez.
1644 </p>
1645
1646 <p>The AccessEvent class in logback-access module now implements
1647 the <code>IAccessEvent</code> interface. This fixes <a
1648 href="http://jira.qos.ch/browse/LBACCESS-12">LBACCESS-12</a>
1649 reported by Joern Huxhorn.</p>
1650
1651 <hr width="80%" align="center" />
1652
1653 <h3>January 25th, 2011 - Release of version 0.9.28</h3>
1654
1655 <div class="breaking">
1656
1657 <h4>Breaking change: In the Context interface, the previously
1658 misspelled property <code>bithTime</code> is now renamed as
1659 <code>birthTime</code>.</h4>
1660
1661 <p>In the <a
1662 href="apidocs/ch/qos/logback/core/Context.html">Context</a>
1663 interface, the previously misspelled property
1664 <code>bithTime</code> is now renamed as
1665 <code>birthTime</code>. This is a backward-incompatible
1666 change. All pre-existing references to "bithTime" property now
1667 need to referenced as "birthTime".</p>
1668 </div>
1669
1670 <p>Fixed <a href="http://jira.qos.ch/browse/LBCLASSIC-238">issue
1671 238</a> reported by Robert Elliot. <code>GEventEvaluator</code>'s
1672 start method now correctly sets the state of the instance.
1673 </p>
1674
1675 <p><code>JaninoEventEvaluator</code> now expects Java blocks
1676 instead of boolean expressions. For even moderately complex
1677 logical statements, blocks can be more convenient to read or to
1678 write compared with boolean expressions. To ensure backward
1679 compatibility, existing boolean expressions are converted into
1680 blocks on the fly.
1681 </p>
1682
1683 <p>Corrected handling of null valued arguments by DBAppender. This
1684 fixes <a
1685 href="http://jira.qos.ch/browse/LBCLASSIC-239">LBCLASSIC-239</a>
1686 reported by Artyom Kalita.</p>
1687
1688 <p>It is now possible to use the context birth time as the time
1689 reference for the <a
1690 href="manual/appenders.html#uniquelyNamed"><code>&lt;timestamp></code></a>
1691 element in configuration files.</p>
1692
1693 <p>Logback can now scan for included files as well. This solves <a
1694 href="http://jira.qos.ch/browse/LBCLASSIC-245">LBCLASSIC-245</a>.
1695 </p>
1696
1697 <hr width="80%" align="center" />
1698
1699 <h3>December 22nd, 2010 - Release of version 0.9.27</h3>
1700
1701 <p>Added a new section in the documentation about <a
1702 href="recipes/index.html">real-world inspired recipes</a>.</p>
1703
1704 <p><code>PatternLayout</code> now supports compound conversion
1705 words of which <a
1706 href="manual/layouts.html#replace">"%replace"</a> is one
1707 example. This change involved a significant re-write of the
1708 pattern tokenizer, the pattern parser and the pattern
1709 compiler. However, the changes should be backward compatible as far
1710 as users are concerned.
1711 </p>
1712
1713 <p>The <a href="manual/appenders.html#smtpTo"><span
1714 class="prop">to</span></a> option of SMTPAppender now admits a
1715 pattern and is evaluated dynamically.</p>
1716
1717 <p><code>TeeServletInputStream</code> no longer chokes on input
1718 over 8K in size. This fixes <a
1719 href="http://jira.qos.ch/browse/LBACCESS-10">LBACCESS-10</a> as
1720 reported by Augusto Rodriguez.
1721 </p>
1722
1723 <p><code>TeeFilter</code> now takes include and exclude parameters
1724 so that it can be enabled or disabled by host. This solves <a
1725 href="http://jira.qos.ch/browse/LBACCESS-15">LBACCESS-15</a>.</p>
1726
1727 <p>Fixed <a
1728 href="http://jira.qos.ch/browse/LBCLASSIC-231">LBCLASSIC-231</a>
1729 as reported by Jeff Skjonsby. When configuring
1730 <code>SizeAndTimeBasedFNATP</code>,
1731 <code>GaggerConfigurator</code> (Groovy) will no longer throw a
1732 <code>NullPointerException</code>.
1733 </p>
1734
1735 <p>Every context now returns its own name when asked for the
1736 property <code>CONTEXT_NAME</code>. This fixes <a
1737 href="http://jira.qos.ch/browse/LBCORE-178">LBCORE-178</a> as
1738 requested by Michael Osipov.
1739 </p>
1740
1741
1742 <h3>20th of October, 2010 - Release of version 0.9.26</h3>
1743
1744
1745 <p>Fixed <a
1746 href="http://jira.qos.ch/browse/LBCLASSIC-183">LBCLASSIC-183</a>
1747 as reported by Anthony Whitford. Upon application restart, Tomcat
1748 should no longer complain about ThreadLocal variables created
1749 internally by logback.
1750 </p>
1751
1752 <p><code>SMPTAppender</code> now lets users to set a custom buffer
1753 size for the outgoing messages. This fixes <a
1754 href="http://jira.qos.ch/browse/LBCORE-170">LBCORE-170</a> as
1755 requested by Peter Royal.
1756 </p>
1757
1758 <p>When stopped, <code>RollingFileAppender</code> now calls
1759 <code>stop()</code> on its policy objects, fixing <a
1760 href="http://jira.qos.ch/browse/LBCORE-114">LBCORE-114</a>
1761 reported by Anders Wallgren.</p>
1762
1763 <p>Added mapping for OFF and ALL levels in <code>JULHelper</code>
1764 as requested in <a
1765 href="http://jira.qos.ch/browse/LBCLASSIC-226">LBCLASSIC-226</a>
1766 by Christian Brensing.
1767 </p>
1768
1769 <h3>October 13th, 2010 - Release of version 0.9.25</h3>
1770
1771 <p>Logback-classic now supports <a
1772 href="manual/configuration.html#LevelChangePropagator">propagation
1773 of level changes from logback-classic onto the
1774 j.u.l. framework</a>. This significantly reduces the performance
1775 impact of disabled log statements making it reasonable for
1776 real-world applications to use the <a
1777 href="http://slf4j.org/legacy.html#jul-to-slf4j">jul-to-slf4j
1778 bridge</a>.
1779 </p>
1780
1781 <p>The <code>&lt;appender-ref></code> element now supports
1782 <a href="manual/configuration.html#variableSubstitution">variable substitution</a>, thus fixing <a
1783 href="http://jira.qos.ch/browse/LBCLASSIC-224">LBCLASSIC-224</a>
1784 as reported by David Harrigan.
1785 </p>
1786
1787 <p>As reported in <a
1788 href="http://jira.qos.ch/browse/LBCORE-164">LBCORE-164</a>,
1789 <code>SizeAndTimeBasedFNATP</code> would cause previous logging
1790 files with indexes over nine to be overwritten on application
1791 restart. This complex bug was reported and precisely diagnosed by
1792 Dieter Mueller. He has also proposed a fix which was subsequently
1793 adopted as is.</p>
1794
1795 <hr width="80%" align="center" />
1796
1797 <h3>June 30th, 2010 - Release of version 0.9.24</h3>
1798
1799 <p>Fixed NullPointerException thrown by
1800 <code>MDCBasedDiscriminator</code> in case the MDC map is
1801 null.</p>
1802
1803 <p>Fixed issue with <code>SizeAndTimeBasedFNATP</code> in presence
1804 of application stop/restart and non-null file property. This issue
1805 was reported by Tom Liu in <a
1806 href="http://jira.qos.ch/browse/LBCORE-131">LBCORE-131</a>.</p>
1807
1808 <hr width="80%" align="center" />
1809
1810 <h3>June 29th, 2010 - Release of version 0.9.23</h3>
1811
1812 <p>Fixed Groovy runtime dependency problem with
1813 ReconfigureOnChangeFilter, i.e. the auto-scan filter, when using
1814 non-groovy configuration files. This problem was reported in <a
1815 href="http://jira.qos.ch/browse/LBCLASSIC-214">LBCLASSIC-214</a>
1816 by Alvin Chee.</p>
1817
1818 <p>Fixed <code>MDCBasedDiscriminator</code> so that it supports deferred
1819 processing. This issue was reported in <a
1820 href="http://jira.qos.ch/browse/LBCLASSIC-213">LBCLASSIC-213</a>
1821 by Torsten Juergeleit.</p>
1822
1823 <hr width="80%" align="center" />
1824
1825 <h3>June 21st, 2010 - Release of version 0.9.22</h3>
1826
1827 <p>Logback now supports <a href="manual/groovy.html">configuration
1828 files written in Groovy</a> which are more convenient than
1829 configuration files written in XML. We have also developed a tool
1830 to <a
1831 href="http://logback.qos.ch/translator/asGroovy.html">automatically
1832 migrate your logback.xml files to logback.groovy</a>.
1833 </p>
1834
1835 <p>Inspired by the functionality offered by
1836 <code>SiftingAppender</code>, <code>SMTPApppender</code> now can
1837 <a href="manual/appenders.html#smtpDiscriminator">track multiple
1838 buffers according to selection information returned by a
1839 discriminator</a>.
1840 </p>
1841
1842 <p>Fixed synchronization issue in <code>ConsoleAppender</code> as
1843 reported in <a
1844 href="http://jira.qos.ch/browse/LBCORE-158">LBCORE-158</a> by
1845 David Roussel who also supplied a corrective patch.</p>
1846
1847
1848 <hr width="80%" align="center" />
1849
1850 <h3>May 8th, 2010 - Release of version 0.9.21</h3>
1851
1852 <p>SLF4J dependency upgraded to 1.6.0</p>
1853
1854 <p>Fixed concurrency problem in <code>SiftingAppender</code> as
1855 reported in <a
1856 href="http://jira.qos.ch/browse/LBCLASSIC-203">LBCLASSIC-203</a>
1857 by Ellen Strnod.
1858 </p>
1859
1860 <p>Added <a
1861 href="manual/filters.html#GEventEvaluator">GEventEvaluator</a>
1862 which processes boolean expression written in the Groovy language.
1863 </p>
1864
1865 <p>Fixed rollover problem occurring when the target directory was
1866 missing as reported in <a
1867 href="http://jira.qos.ch/browse/LBCORE-151">LBCORE-151</a> by
1868 Torsten Juergeleit. A closely related problem was reported in <a
1869 href="http://jira.qos.ch/browse/LBCLASSIC-167">LBCLASSIC-167</a>
1870 by Rick Janda.
1871 </p>
1872
1873
1874 <hr width="80%" align="center" />
1875
1876 <h3>April 2nd, 2010 - Release of version 0.9.20</h3>
1877
1878 <p>Fixed issue related to charsets in
1879 <code>LayoutWrappingEncoder</code> not being recognized in config
1880 files.</p>
1881
1882 <p>Logback now supports <a
1883 href="manual/configuration.html#conditional">conditional
1884 processing</a> of configuration files.</p>
1885
1886 <p>A new extension point for <a
1887 href="manual/configuration.html#definingPropsOnTheFly">defining
1888 properties on the fly</a> has been added. The code for this
1889 enhancement was provided by Aleksey Didik in <a
1890 href="http://jira.qos.ch/browse/LBCLASSIC-182">LBCLASSIC-182</a>.</p>
1891
1892 <p>Logback now provides <a
1893 href="http://logback.qos.ch/manual/loggingSeparation.html">an
1894 answer</a> to the longstanding logging separation problem for
1895 static logger references in shared libraries. This fixes <a
1896 href="http://jira.qos.ch/browse/LBCLASSIC-166">LBCLASSIC-166</a>
1897 and <a
1898 href="http://jira.qos.ch/browse/LBCLASSIC-87">LBCLASSIC-87</a>.
1899 </p>
1900
1901 <p>Removed the previously deprecated <code>getFirstFilter</code>
1902 method in <code>FilterAttachable</code> interface.</p>
1903
1904 <!-- ============================================================== -->
1905
1906 <hr width="80%" align="center" />
1907
1908 <h3>March 24, 2010 - Release of version 0.9.19</h3>
1909
1910
1911 <div class="breaking">
1912
1913 <h4>Breaking change: FileAppender now expects an Encoder</h4>
1914
1915 <p>In response to <a
1916 href="http://jira.qos.ch/browse/LBCORE-128">LBCORE-128</a>,
1917 <code>WriterAppender</code> has been renamed as
1918 <code>OutputStreamAppender</code>, <code>FileAppender</code> now
1919 sub-classing the latter. <code>OutputStreamAppender</code> and
1920 sub-classes now take an <code>Encoder</code> instead of a
1921 <code>Layout</code>.
1922 </p>
1923
1924 <p>Contrary to layouts which simply transform a logging event into
1925 a String, an encoder is responsible for writing the actual event
1926 or more accurately the representation of the event onto the output
1927 stream. The role of the enclosing appender is now limited to
1928 managing the output stream (opening/closing) but not writing
1929 actual contents onto the stream. This change will require <a
1930 href="codes.html#layoutInsteadOfEncoder"> modifications to
1931 existing configuration files</a>. We hope to make up for this
1932 inconvenience with cool new features which are only possible using
1933 encoders. <b>During a transition period, layouts passed as
1934 parameter will be automatically wrapped by an encoder so that
1935 configuration files in the old format (using a layout instead of
1936 encoder) will continue to work unmodified.</b>
1937 </p>
1938
1939 </div>
1940
1941 <br/>
1942
1943 <div class="breaking">
1944
1945
1946 <h4>Breaking change: DBAppender in logback-classic expects four
1947 additional columns
1948 </h4>
1949
1950 <p>Instead of lumping log request arguments into a field,
1951 <code>DBAppender</code> (in logback-classic) now outputs up to
1952 four arguments in the logging request in separate columns, named
1953 <code>arg0</code>, <code>arg1</code>, <code>arg2</code> and
1954 <code>arg4</code>. This solves <a
1955 href="http://jira.qos.ch/browse/LBCLASSIC-187">LBCLASSIC-187</a>
1956 reported by Greg Thomas.</p>
1957
1958 <p>Existing databases can be migrated to the new table structure
1959 by altering the existing tables. Here is how it would be done
1960 in PostgreSQL and MySQL.</p>
1961
1962 <pre class="prettyprint">ALTER TABLE logging_event ADD COLUMN arg0 VARCHAR(254);
1963 ALTER TABLE logging_event ADD COLUMN arg1 VARCHAR(254);
1964 ALTER TABLE logging_event ADD COLUMN arg2 VARCHAR(254);
1965 ALTER TABLE logging_event ADD COLUMN arg3 VARCHAR(254);</pre>
1966
1967 <p>In Oracle:</p>
1968
1969 <pre class="prettyprint">ALTER TABLE logging_event ADD arg0 VARCHAR(254);
1970 ALTER TABLE logging_event ADD arg1 VARCHAR(254);
1971 ALTER TABLE logging_event ADD arg2 VARCHAR(254);
1972 ALTER TABLE logging_event ADD arg3 VARCHAR(254);</pre>
1973
1974
1975 </div>
1976 <p><code>FileAppender</code> and derived classes can now
1977 gracefully deal with IO failures and recover quickly after the
1978 original cause of the IO failure is corrected. For example, if the
1979 log file is located on a <a
1980 href="http://en.wikipedia.org/wiki/Network-attached_storage">network-attached
1981 storage (NAS)</a>, and the connection to the NAS server is lost,
1982 <code>FileAppender</code> and derived classes will recover quickly
1983 after the connection to the server is re-established.
1984 </p>
1985
1986 <p>The packages under <code>ch.qos.logback.classic</code>
1987 namespace no longer depend on <code>org.slf4j.impl</code>. This
1988 fixes <a
1989 href="http://jira.qos.ch/browse/LBCLASSIC-184">LBCLASSIC-184</a>
1990 reported by Gunnar Wagenknecht.
1991 </p>
1992
1993 <p>Fixed <a
1994 href="http://jira.qos.ch/browse/LBCLASSIC-193">LBCLASSIC-193</a>.
1995 <code>SyslogAppender</code> will no longer shutdown when messages
1996 over 256Kb cause an <code>IOException</code>.
1997 </p>
1998
1999 <p>Added <a
2000 href="manual/appenders.html#OnMarkerEvaluator">OnMarkerEvaluator</a>
2001 which evaluates to true in the presence of user-specified
2002 markers. When used with <code>SMTPAppender</code>, it can trigger
2003 an outgoing email message when an event matches user-specified
2004 marker.</p>
2005
2006 <p>Request header names in AccessEvent (logback-access) are now
2007 stored in a case insensitive way as specified in RFC 2616. This
2008 prevents compatibility issues, in particular with recent versions
2009 of Tomcat which store request header names in lower-case.</p>
2010
2011
2012 <p>Fixed <a
2013 href="http://jira.qos.ch/browse/LBCORE-134">LBCORE-134</a>
2014 reported by Michael Franz. While reading configuration files (in
2015 XML), the event handler will correctly process body text, in
2016 particular spaces, even when delivered in multiple chunks. The
2017 previous behavior of trimming leading and trailing white space has
2018 been preserved. Moreover, body text consisting of white space
2019 surrounding child elements is ignored.
2020 </p>
2021
2022 <p><code>SiftingAppender</code> now exposes its
2023 <code>AppenderTracker</code>. Moreover, the
2024 <code>stopAndRemoveNow(String key)</code> method was added to
2025 <code>AppenderTracker</code>, allowing immediate removal of a
2026 nested appender.
2027 </p>
2028
2029 <p>Fixed <a
2030 href="http://jira.qos.ch/browse/LBCORE-130">LBCORE-130</a>.
2031 <code>FileNamePattern</code> no longer treats parenthesis as
2032 special.
2033 </p>
2034
2035 <p>The <span class="prop">CharsetEncoder</span> property in
2036 <code>SMTPAppender</code> can now be accessed and set from
2037 configuration files. This fixes <a
2038 href="http://jira.qos.ch/browse/LBCLASSIC-194">LBCLASSIC-194</a>.
2039 </p>
2040
2041 <p>Instead of sending its output to the System.out/err reference
2042 that was effective at initialization, <code>ConsoleAppender</code>
2043 will now seek the most current System.out/err reference and send
2044 its output there. This fixes <a
2045 href="http://jira.qos.ch/browse/LBCORE-143">LBCORE-143</a> as
2046 reported by Tom SH Liu.
2047 </p>
2048
2049 <p>DBAppender now outputs exception class and message. It will
2050 also output root causes, fixing
2051 <a href="http://jira.qos.ch/browse/LBCLASSIC-170">LBCLASSIC-170</a>
2052 reported by Tomasz Nurkiewicz.
2053 </p>
2054
2055 <p>You can now override table and column names in DBAppender. This
2056 feature was requested in <a
2057 href="http://jira.qos.ch/browse/LBCLASSIC-188">LBCLASSIC-188</a>
2058 reported by Tomasz Nurkiewicz.
2059 </p>
2060
2061 <p>Fixed missing EVENT_ID column problem on PostgreSQL as reported
2062 in <a href="http://jira.qos.ch/browse/LBCORE-126">LBCORE-126</a>
2063 by Brian Edwards.</p>
2064
2065 <p>Event id values in DBAppender are now 64bit instead of 32. This
2066 change was requested in <a
2067 href="http://jira.qos.ch/browse/LBCLASSIC-198">LBCLASSIC-198</a>
2068 by Michael Lynch.
2069 </p>
2070
2071 <p>Added Sybase SQLAnywhere support in DBAppender. This feature
2072 was requested by Michael Lynch in <a
2073 href="http://jira.qos.ch/browse/LBCLASSIC-197">LBCLASSIC-197</a>.
2074 </p>
2075
2076 <p>Added H2 support in DBAppender.</p>
2077
2078
2079 <p>Fixed <a
2080 href="http://jira.qos.ch/browse/LBSITE-36">LBSITE-36</a> reported
2081 by John Jimenez.</p>
2082
2083 <hr width="80%" align="center" />
2084
2085 <!-- ======================================================================== -->
2086
2087 <h3>3rd of December 2009 - Release of version 0.9.18</h3>
2088
2089 <p>After a very long investigation resulting in somewhat a better
2090 understanding of licensing issues, logback is now <a
2091 href="license.html">dual-licensed</a> under the EPL 1.0 and LGPL
2092 2.1.
2093 </p>
2094
2095 <p>Due to a clerical error <a
2096 href="http://jira.qos.ch/browse/LBCORE-26">LBCORE-26</a> has
2097 re-raised its ugly head. It has now been tamed for good.</p>
2098
2099 <p>Fixed Private-Package and Export-Package sections in
2100 logback-classic.jar MANIFEST as reported in <a
2101 href="http://jira.qos.ch/browse/LBCLASSIC-165">LBCLASSIC-165</a>
2102 and <a
2103 href="http://jira.qos.ch/browse/LBCLASSIC-121">LBCLASSIC-121</a>
2104 by applying the relevant patches supplied by Hugues Malphettes.
2105 </p>
2106
2107 <p>Made the OSGi import declarations for Janino and javax optional
2108 as proposed by David Varnes in <a
2109 href="http://jira.qos.ch/browse/LBCORE-101">LBCORE-101</a>.</p>
2110
2111 <p><code>ReconfigureOnChangeFilter</code> did not pick up changes
2112 for configuration files containing spaces. This issue was reported
2113 in <a href="http://jira.qos.ch/browse/LBCORE-119">LBCORE-119</a>
2114 by Anders Wallgren.
2115 </p>
2116
2117 <p>Added tests cases which run logback artifacts as bundles within
2118 Felix. This should solve a series of problems related to OSGi.</p>
2119
2120 <p>When ill-formed configuration files fragments were included in
2121 another configuration file, the included file was not closed
2122 correctly. This issue was reported in <a
2123 href="http://jira.qos.ch/browse/LBCORE-122">LBCORE-122</a> by
2124 Michael Franz.
2125 </p>
2126
2127 <p>JaninoEventEvaluator now passes the throwable associated with
2128 an event as a <code>java.lang.Throwable</code> instead of an
2129 <code>IThrowableProxy</code>. This fixes <a
2130 href="http://jira.qos.ch/browse/LBCLASSIC-155">LBCLASSIC-155</a>
2131 as reported by Hontv&aacute;ri J&oacute;zsef. See <a
2132 href="manual/filters.html#evalutatorFilter">EvaluatorFilter
2133 documentation</a> for more details.</p>
2134
2135 <p>The name of the log file nested within .zip archives was
2136 incorrectly set to be that of the tmp file logback creates during
2137 compression. Anders Wallgren reported and posted an appropriate
2138 patch for this problem in <a
2139 href="http://jira.qos.ch/browse/LBCORE-98">LBCORE-98</a>. The
2140 nested file is now named after the zip archive file. Analysis
2141 showed that this was an appropriate strategy in all the cases we
2142 considered.</p>
2143
2144 <p>Fixed <a
2145 href="http://jira.qos.ch/browse/LBCLASSIC-149">LBCLASSIC-149</a>. The
2146 ContextNameConverter now correctly uses the context name of the
2147 event instead of its own context name.
2148 </p>
2149
2150 <p>When a logger is named after an inner class, the '$' is used as
2151 a separator, instead of the usual '.'. This fixes the level
2152 inheritance issue described in <a
2153 href="http://jira.qos.ch/browse/LBCLASSIC-102">LBCLASSIC-102</a>
2154 and as reported by Joern Huxhorn.</p>
2155
2156 <p>Fixed deadlock issue observed with appender which invoke
2157 loggers as reported in <a
2158 href="http://jira.qos.ch/browse/LBCLASSIC-154">LBCLASSIC-154</a>
2159 by Andrew Perrine and debugged by Ralph Goers who also proposed
2160 the relevant patch.</p>
2161
2162 <hr width="80%" align="center" />
2163
2164 <h3>9th of August 2009 - Release of version 0.9.17</h3>
2165
2166 <p><code>PackagingDataCalculator</code> now correctly deals with
2167 <code>NoClassDefFoundError</code> thrown by class loaders. This
2168 fixes <a
2169 href="http://jira.qos.ch/browse/LBCLASSIC-125">LBCLASSIC-125</a>
2170 reported by Roland Klein and independently by Didier Besset.
2171 </p>
2172
2173 <p>In configuration files, all tags names associated with explicit
2174 actions are now case-insensitive. This should diminish
2175 case-related errors users may make when writing configuration
2176 files. Tag names associated with implicit actions which are
2177 closely linked to the actual Java class being configured, still
2178 need to follow the camelCase convention. If you are unsure which
2179 case to use for a given tag name, just follow the camelCase
2180 convention for tag names which should be correct in most
2181 cases. </p>
2182
2183 <p>It is now possible to create <a
2184 href="manual/appenders.html#uniquelyNamed">uniquely named files by
2185 timestamp</a>. Such files are appropriate for log files associated
2186 with batch applications. This enhancement fulfills <a
2187 href="http://jira.qos.ch/browse/LBCORE-91">LBCORE-91</a> as
2188 requested by Rick Beton and Szel Zoltan.
2189 </p>
2190
2191 <p>Append mode is now mandatory in
2192 <code>RollingFileAppender</code>. This was already the default and
2193 truncation mode is unreasonable in most cases. For example, in
2194 truncate mode when an application stops and is quickly re-started,
2195 any pre-existing log file for the current period will be lost.</p>
2196
2197 <p>The <code>activeFile</code> field in
2198 <code>RollingFileAppender</code> is now properly updated, fixing
2199 <a href="http://jira.qos.ch/browse/LBCORE-90">LBCORE-90</a> as
2200 reported by Valery Shorin.</p>
2201
2202
2203 <p>The <code>TimeBasedTriggeringPolicy</code> has been heavily
2204 refactored. It is now possible to trigger rolling simultaneously
2205 by <a href="manual/appenders.html#SizeAndTimeBasedFNATP">time and
2206 by size</a>, fixing <a
2207 href="http://jira.qos.ch/browse/LBCORE-61">LBCORE-61</a>.
2208 </p>
2209
2210 <p>Fixed <a
2211 href="http://jira.qos.ch/browse/LBCLASSIC-145">LBCLASSIC-145</a>
2212 reported by Joern Huxhorn. The <code>LoggingEventVO</code> class
2213 now correctly populates its callerData field if the original
2214 <code>ILoggingEvent</code> already has it.</p>
2215
2216 <hr width="80%" align="center" />
2217
2218 <h3>15th of July 2009 - Release of version 0.9.16</h3>
2219
2220 <p>In addition to nifty new features, this release contains
2221 several important internal changes. Given the importance of some
2222 of those internal changes, <em>this release may be less stable
2223 than previous logback releases</em>.</p>
2224
2225 <p>In logback-classic, <a
2226 href="xref/ch/qos/logback/classic/spi/LoggingEvent.html"><code>LoggingEvent</code></a>
2227 now implements the <a
2228 href="xref/ch/qos/logback/classic/spi/ILoggingEvent.html"><code>ILoggingEvent</code></a>
2229 interface. All logback-classic components expect to process
2230 <code>ILoggingEvent</code> instances. Moreover, events which sent
2231 to a remote host are now of type <a
2232 href="xref/ch/qos/logback/classic/spi/LoggingEventVO.html"><code>LoggingEventVO</code></a>.
2233 </p>
2234
2235 <p>Logback-classic will now <a
2236 href="manual/configuration.html#autoScan">automatically
2237 re-configure itself</a> when its configuration file is
2238 modified. This enhancement was requested in <a
2239 href="http://jira.qos.ch/browse/LBCORE-59">LBCORE-59</a> by
2240 Michael Osipov.</p>
2241
2242 <p>FileAppender and its derived class RolllingFileAppender are now
2243 based on a finer-grain synchronization model. This change is aimed
2244 at reducing various synchronization related bugs, namely <a
2245 href="http://jira.qos.ch/browse/LBCLASSIC-135">LBCLASSIC-135</a>
2246 and its various sub-tasks.
2247 </p>
2248
2249 <p>Fixed a bug in the localLevelReset() method in the
2250 <code>Logger</code> class which inadvertently used the DEBUG_INT
2251 value in the org.slf4j.spi.LocationAwareLogger interface instead
2252 of the DEBUG_INT value in ch.qos.logback.classic.Level class. The
2253 issue was first identified by Andy Ruch <a
2254 href="http://qos.ch/pipermail/logback-user/2009-February/000955.html">in
2255 a message</a> to the logback-user list
2256 </p>
2257
2258 <p>If the logger name had 12 or more segments, a the logger
2259 conversion specified would throw an
2260 <code>ArrayIndexOfBounds</code> exception. Lukas Zapletal has
2261 kindly reported this problem in <a
2262 href="http://jira.qos.ch/browse/LBCLASSIC-110">LBCLASSIC-110</a>
2263 and provided a test case.
2264 </p>
2265
2266 <p>A new discriminator class called "ContextBasedDiscriminator"
2267 allows SiftingAppender to separate logging based on the context
2268 name. This fits nicely with the requirements expressed in <a
2269 href="http://jira.qos.ch/browse/LBCLASSIC-117">LBCLASSIC-117</a>
2270 by Rick Janda.
2271 </p>
2272
2273 <p>When a context is reset, then its object and property maps are
2274 now cleared. This fixes <a
2275 href="http://jira.qos.ch/browse/LBCORE-104">LBCORE-104</a>
2276 reported by Johan Bos.
2277 </p>
2278
2279 <p>Fixed <a
2280 href="http://jira.qos.ch/browse/LBCORE-105">LBCORE-105</a>. Configuration
2281 files placed in jar files will no longer lock the jar file. This
2282 issue was initially reported for log4j in <a
2283 href="https://issues.apache.org/bugzilla/show_bug.cgi?id=47465">bug
2284 47465</a> Mark Thomas.
2285 </p>
2286
2287 <p>Fixed <a
2288 href="http://jira.qos.ch/browse/LBCORE-94">LBCORE-94</a>. While
2289 configuring a RollingFileAppender, if the File property is
2290 declared after any rolling or triggering policies, then logback will
2291 now generate an error status message.
2292 </p>
2293
2294 <p>Fixed <a
2295 href="http://jira.qos.ch/browse/LBCLASSIC-134">LBCLASSIC-134</a>
2296 reported by Darryl Smith. <code>DuplicateMessageFilter</code> will
2297 now behave correctly when invoked via
2298 <code>Logger.isXXXEnabled</code> methods.
2299 </p>
2300
2301 <p>Fixed <a
2302 href="http://jira.qos.ch/browse/LBCORE-107">LBCORE-107</a>,
2303 incorrectly set context information for the
2304 <code>NestedBasicPropertyIA</code> instance in Joran, reported by
2305 L&oacute;r&aacute;nt Pint&eacute;r.
2306 </p>
2307
2308 <p>Fixed <a
2309 href="http://jira.qos.ch/browse/LBCLASSIC-109">LBCLASSIC-109</a>,
2310 reported by Andrew Ruch when a logger context was reset, the trace
2311 level was erroneously enabled.
2312 </p>
2313
2314 <hr width="80%" align="center" />
2315
2316 <h3>12th of February 2009 - Release of version 0.9.15</h3>
2317
2318 <p>When the reset() method in <code>LoggerContext</code> is
2319 called, registered turbo filters are first stopped before being
2320 unregistered. This fixes <a
2321 href="http://jira.qos.ch/browse/LBCLASSIC-89">LBCLASSIC-89</a>
2322 reported by Alexis Morillo.
2323 </p>
2324
2325 <p>Added a servlet for viewing internal status messages as an HTML
2326 table. Two separate implementations are available; one for <a
2327 href="manual/configuration.html#viewingStatusMessages">logback-classic</a>
2328 and the other for <a
2329 href="access.html#viewingStatusMessages">logback-access</a>.</p>
2330
2331 <p>Added the <code>clear()</code> method to the
2332 <code>StatusManager</code> interface. After reconfiguration, it
2333 may be desirable to clear the status list maintained by a
2334 <code>StatusManager</code>. This change was requested by Alexis
2335 Morillo in <a
2336 href="http://jira.qos.ch/browse/LBCORE-77">LBCORE-77</a>.
2337 </p>
2338
2339 <p>Fixed problem <a
2340 href="http://jira.qos.ch/browse/LBCLASSIC-104">LBCLASSIC-104</a>
2341 related to loss of MDC information in deferred logging events.
2342 </p>
2343
2344 <p>Fixed issue <a
2345 href="http://jira.qos.ch/browse/LBCLASSIC-101">LBCLASSIC-101</a>. Logback
2346 jar files now include full OSGi bundle information in their
2347 manifests. This information is automatically added by Apache
2348 Felix' Maven bundle plug-in. The generated manifest files contain
2349 an appropriate Bundle-RequiredExecutionEnvironment directive,
2350 fixing <a
2351 href="http://jira.qos.ch/browse/LBGENERAL-8">LBGENERAL-8</a>.
2352 </p>
2353
2354 <p>The setter and getter methods for the layout property in
2355 <code>AppenderBase</code> class now have reasonable default
2356 implementations, instead of nop previously. This change was
2357 requested by Thilo Tanner in <a
2358 href="http://jira.qos.ch/browse/LBCORE-56">LBCORE-56</a>.
2359 </p>
2360
2361
2362 <p>Added <em>log4j.dtd</em> compatible <a
2363 href="manual/layouts.html#log4jXMLLayout"><code>XMLLayout</code></a>
2364 as requested in <a
2365 href="http://jira.qos.ch/browse/LBCLASSIC-22">LBCLASSIC-22</a>.
2366 </p>
2367
2368 <p>New chapter <a href="manual/onJoran.html">on Joran</a>.</p>
2369
2370 <hr width="80%" align="center" />
2371
2372 <h3>29th of December 2008 - Release of version 0.9.14</h3>
2373
2374 <p>Corrected a serious dead-lock problem occurring during
2375 configuration. It was reported in <a
2376 href="http://jira.qos.ch/browse/LBCLASSIC-81">LBCLASSIC-81</a> by
2377 Holger Mense.</p>
2378
2379 <p>Corrected thread leakage observed with
2380 <code>TimeBasedRollingPolicy</code>'s
2381 <code>AsynchronousCompressor</code>. This bug was reported in <a
2382 href="http://jira.qos.ch/browse/LBCORE-78">LBCORE-78</a> by Szel
2383 Zoltan.</p>
2384
2385 <p>Added <a
2386 href="manual/filters.html#DuplicateMessageFilter">DuplicateMessageFilter</a>,
2387 a turbo filter which detects duplicate messages, and beyond a
2388 certain number of repetitions, drops repeated messages.</p>
2389
2390 <p>Added a new appender called <a
2391 href="manual/appenders.html#SiftingAppender"><code>SiftingAppender</code></a>. As
2392 its name intimates, a <code><code>SiftingAppender</code></code>
2393 can be used to separate (or sift) logging according to a given
2394 runtime attribute. For example, <code>SiftingAppender</code> can
2395 separate logging events according to user sessions, so that the
2396 logs generated by each user go into distinct log files, one log
2397 file per user.
2398 </p>
2399
2400 <p><code>BasicStatusManager</code>'s internal buffer is now split
2401 into two parts, the header part and the tail part. The header part
2402 stores the fist H status messages whereas the tail part stores the
2403 last T messages. At present time H=T=150, although these values may
2404 change in future releases.</p>
2405
2406 <p>Fixed <code>NullPointerException</code> thrown when calling
2407 <code>setContextMap</code> on a fresh MDC. <a
2408 href="http://jira.qos.ch/browse/LBCLASSIC-98">Issue was</a>
2409 reported by Francois Terrier.
2410 </p>
2411
2412
2413 <p>Evaluators are now wired into an appender automatically
2414 (implicit rules) without the help of
2415 <code>EvaluatorAction</code>. EvaluatorAction is now only needed
2416 for global evaluator elements. It follows that name attribute is
2417 necessary only for global evaluators. Embedded evaluators no
2418 longer need a name. This change fixes <a
2419 href="http://jira.qos.ch/browse/LBCLASSIC-100">LBCLASSIC-100</a>. In
2420 addition, <code>EvaluatorAction</code> has been modified to accept
2421 evaluators of any type and not just instances of
2422 <code>JaninoEvaluator</code>.
2423 </p>
2424
2425 <p>Logback-classic default configuration process will now
2426 automatically print status data on the console in case of warnings
2427 as well as errors. Previously, status data was printed only in
2428 case of errors.</p>
2429
2430 <p><code>ContextInitializer</code> will now print the url of the
2431 configuration it is using. This should help reduce confusion when
2432 multiple config files are found on the class path. This change
2433 resolves <a
2434 href="http://jira.qos.ch/browse/LBCLASSIC-55">LBCLASSIC-55</a>
2435 reported by Anton Tagunov and Henric Larsson.
2436 </p>
2437
2438 <p>In case multiple configuration files are found on the class
2439 path, <code>ContextInitializer</code> will now emit a
2440 warning. This fixes <a
2441 href="http://jira.qos.ch/browse/LBCLASSIC-85">LBCLASSIC-85</a>
2442 filed by Szel Zoltan.
2443 </p>
2444
2445 <p><code>HTMLLayout</code> now honors custom conversion words,
2446 thus fixing <a
2447 href="http://jira.qos.ch/browse/LBCORE-74">LBCORE-74</a> as
2448 reported by Natan Cox.</p>
2449
2450 <p>Fixed <a
2451 href="http://jira.qos.ch/browse/LBCORE-69">LBCORE-69</a> as
2452 reported by Andrey Rybin. <code>SMTPAppenderBase</code> now has
2453 support for charset encodings so that email messages can contain
2454 characters beyond US-ASCII.
2455 </p>
2456
2457 <p><code>SMTPAppender</code> in logback-classic now defaults to
2458 <code>OnErrorEvaluator</code> instead of a janino-based
2459 evaluator. Thus, by default <code>SMTPAppender</code> no longer
2460 depends on Janino.</p>
2461
2462 <p>Added UnsynchronizedAppenderBase class based on Ralph Goers'
2463 contribution in <a
2464 href="http://jira.qos.ch/browse/LBCORE-58">LBCORE-58</a>. Note
2465 that <code>AppenderBase</code> remains unchanged. Appenders which
2466 need to handle synchronization on their own can do so by deriving
2467 from <code>UnsynchronizedAppenderBase</code>.</p>
2468
2469 <h3>5th of December 2008 - Release of version 0.9.13</h3>
2470
2471 <p>A <code>NullPointerException</code> was being thrown when a the
2472 level of a logger was set to null. The logger in question had to
2473 have children. This problem was reported in <a
2474 href="http://jira.qos.ch/browse/LBCLASSIC-91">LBCLASSIC-91</a>
2475 by Mateusz Jedruch.
2476 </p>
2477
2478 <h3>4th of December 2008 - Release of version 0.9.12</h3>
2479
2480 <p>Fixed <a href="http://jira.qos.ch/browse/LBCORE-26">bug
2481 LBCORE-26</a> reported by Tsutomu YANO and independently by
2482 Hontv&aacute;ri J&oacute;zsef and Gamaliel
2483 Amaudruz. <code>RollingFileAppender</code> when used in conjunction
2484 with <code>DateBasedRollingPolicy</code> will rollover existing log
2485 files at initialization if their timestamp warrants it.
2486 </p>
2487
2488 <p>Added support for file appending in <a
2489 href="manual/appenders.html#prudent">prudent mode</a>. Thus,
2490 multiple <code>FileAppender</code> instances running on multiple
2491 JVMs can safely write to the same log file. With certain
2492 limitations, prudent mode extends to
2493 <code>RollingFileAppender</code>.
2494 </p>
2495
2496
2497 <p>Fixed <a
2498 href="http://jira.qos.ch/browse/LBCLASSIC-83">LBCLASSIC-83</a>.
2499 It is now possible to set the level of a logger to null, even if
2500 it was previously set to a non-null level. Previously, a
2501 <code>NullPointerException</code> would be thrown.
2502 </p>
2503
2504 <p>In response to <a
2505 href="http://jira.qos.ch/browse/LBCLASSIC-61">LBCLASSIC-61</a>, <a
2506 href="http://jira.qos.ch/browse/LBCLASSIC-33">LBCLASSIC-33</a>, <a
2507 href="http://jira.qos.ch/browse/LBCLASSIC-14">LBCLASSIC-24</a> and
2508 <a href="http://jira.qos.ch/browse/LBCLASSIC-24">LBCLASSIC-14</a>
2509 <code>JMXConfigurator</code> has been redesigned.
2510 </p>
2511
2512 <p>Fixed <a
2513 href="http://jira.qos.ch/browse/LBGENERAL-22">LBGENERAL-22</a>. The
2514 <a href="http://logback.qos.ch/translator/">log4j.properties
2515 translator</a> web-application has been significantly refactored.
2516 </p>
2517
2518 <p>Fixed improvement request <a
2519 href="http://jira.qos.ch/browse/LBCLASSIC-59">LBCLASSIC-59</a>
2520 relation to StatusListeners, originally submitted by Anton Tagunov.
2521 </p>
2522
2523 <p>The logger and class name converters now consider zero as
2524 having special meaning, and will return the simple class name,
2525 removing the package name prefix. This feature was asked by
2526 Silvano Maffeis.</p>
2527
2528 <p>In response to <a
2529 href="http://jira.qos.ch/browse/LBCLASSIC-54"> LBCLASSIC-54</a>
2530 support for turbo filters has refactored. The present code is safe
2531 under concurrent access while still offering good performance.
2532 </p>
2533
2534 <p>Fixed <a
2535 href="http://jira.qos.ch/browse/LBCORE-43">LBCORE-43</a> reported
2536 by Bruno Navert. Configuration files can now look up property
2537 files from classpath resources.
2538 </p>
2539
2540 <p>Fixed <a
2541 href="http://jira.qos.ch/browse/LBCLASSIC-86">LBCLASSIC-86</a>
2542 related to <code>AccessControlException</code> thrown when run in
2543 a JVM with a <code>SecurityManager</code>.
2544 </p>
2545
2546 <p>Invoking the <code>LoggerContext.reset()</code> method resets
2547 logger levels to their default value, that is <code>DEBUG</code>
2548 for the root logger and <code>null</code> for all other
2549 loggers. This was requested in <a
2550 href="http://jira.qos.ch/browse/LBCLASSIC-90">LBCLASSIC-90</a> by
2551 Mateusz Jedruch.
2552 </p>
2553
2554 <!-- ======================== minor ================== -->
2555
2556 <p>Fixed <a href="http://jira.qos.ch/browse/LBCLASSIC-69">bug
2557 LBCLASSIC-69</a> reported by Anton Tagunov. The
2558 LevelToSyslogSeverity now correctly handles the TRACE level.
2559 </p>
2560
2561 <p>Fixed <a href="http://jira.qos.ch/browse/LBCLASSIC-57">bug
2562 LBCLASSIC-57</a> reported by Anton Tagunov. SyslogAppender could
2563 overwhelm the Syslog server with very large messages. SyslogAppender
2564 now limits its message size to 256K.
2565 </p>
2566
2567 <p>Logback now supports <a
2568 href="manual/configuration.html#contextName">setting the logger context
2569 name</a> as well as inserting variables <a
2570 href="manual/configuration.html#insertFromJNDI">stored in JNDI</a> as
2571 properties.
2572 </p>
2573
2574 <p>Fixed issue <a
2575 href="http://jira.qos.ch/browse/LBCLASSIC-49">LBCLASSIC-49</a>
2576 reported by Oliver Lietz. The getLogger() method in
2577 <code>LoggerContext</code> class will now throw an
2578 <code>IllegalArgumentException</code> when invoked with a null
2579 argument.
2580 </p>
2581
2582
2583 <hr width="80%" align="center" />
2584
2585 <h3>28th of October 2008 - Release of version 0.9.11</h3>
2586
2587 <p>Fixed <a
2588 href="http://jira.qos.ch/browse/LBCLASSIC-77">LBCLASSIC-77</a>
2589 reported independently by Gianni Doe, Yannick Haudry and Yossi Shaul.
2590 The childValue() method of <code>CopyOnInheritThreadLocal</code>
2591 class part of MDC code no longer throws a
2592 <code>NullPointerException</code>.
2593 </p>
2594
2595 <hr width="80%" align="center" />
2596
2597 <h3>27th of October 2008 - Release of version 0.9.10</h3>
2598
2599 <p>In case of errors during initialization, logback-classic now
2600 <em>automatically</em> prints out its internal status. This has been
2601 a frequently requested feature.
2602 </p>
2603
2604 <p>The LogbackValve in logback-access (ensuring integration with
2605 Tomcat), will now systematically print its internal status upon
2606 initialization, unless told to be quiet. This greatly helps
2607 troubleshooting the configuration of logback-access under Tomcat.
2608 </p>
2609
2610 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=147">bug
2611 147</a> which occurred when the user inadvertently attempted to set
2612 the layout of a <code>SyslogAppender</code>. The code now actively
2613 prevents this. Documentation has been updated to reflect the change.
2614 </p>
2615
2616 <p>Fixed <a href="http://jira.qos.ch/browse/LBCLASSIC-56">bug
2617 LBCLASSIC-56</a> originally reported by Michel Colette. Backslash
2618 characters are now correctly interpreted in filename patterns.
2619 </p>
2620
2621 <p>The TurboFilterChain in a LoggerContext is <a
2622 href="http://svn.qos.ch/viewvc?view=rev&amp;revision=1678">now
2623 cleared</a> when the <code>reset</code>() method is called. This
2624 problem was reported on May 1st, 2008, by Julia Hu on the logback
2625 developers list.
2626 </p>
2627
2628 <!-- ========================== LB CORE ================== -->
2629
2630 <p>Fixed issue <a
2631 href="http://jira.qos.ch/browse/LBCORE-48">LBCORE-48</a>. During
2632 rollover, compression of large files would bring all logging to a
2633 halt. In this latest release, the rolled over file is first renamed,
2634 which is a relatively fast operation, and only then is the renamed
2635 file compressed asynchronously (in a separate thread).
2636 </p>
2637
2638 <p>Fixed issue <a
2639 href="http://jira.qos.ch/browse/LBCORE-11">LBCORE-11</a>. It is now
2640 possible to instruct TimeBasedRollingPolicy to delete old files,
2641 thus controlling then number of archived log files.</p>
2642
2643 <p>Fixed issue <a
2644 href="http://jira.qos.ch/browse/LBCORE-42">LBCORE-42</a>. If the
2645 parent directory of the log file does not exist, then FileAppender
2646 will create it, including any necessary but nonexistent parent
2647 directories.
2648 </p>
2649
2650 <p>Fixed <a href="http://jira.qos.ch/browse/LBCORE-15">LBCORE-15</a>
2651 reported by Klaus Unger and others. DBAppender should now work with
2652 Oracle 9, 10g and 11g, regardless of the JDBC driver type used.
2653 </p>
2654
2655 <p>Fixed issue <a
2656 href="http://jira.qos.ch/browse/LBCORE-17">LBCORE-17</a> reported by
2657 Thorbj&oslash;rn Ravn Andersen. Logback now relies on Geronimo JMS
2658 API specifications instead of Sun's JMS API specification, the
2659 latter requiring manual installation. With Geronimo JMS, logback can
2660 be built using Maven without needing to manually install any
2661 dependencies.
2662 </p>
2663
2664 <p>Fixed issue <a
2665 href="http://jira.qos.ch/browse/LBCORE-23">LBCORE-23</a>. In
2666 PatternLayout, parenthesis can be used to group conversion
2667 patterns. It follows that the '(' and ')' carry special meaning and
2668 need to be escaped to be used as literals. This is now properly
2669 documented.
2670 </p>
2671
2672 <p>The location of the default configuration file can be specified
2673 by a system property. This feature was requested in <a
2674 href="http://jira.qos.ch/browse/LBCORE-32">LBCORE-32</a> by Ted
2675 Graham, Matt Fowles, Ivan Biddles and Ralph Goers.
2676 </p>
2677
2678 <p>Fixed issue <a
2679 href="http://jira.qos.ch/browse/LBCORE-55">LBCORE-55</a> reported by
2680 Natan Cox. <code>WriterAppender</code> now outputs its presentation
2681 footer and file footer in the the correct order.
2682 </p>
2683
2684
2685 <p>Fixed issue <a
2686 href="http://jira.qos.ch/browse/LBCORE-27">LBCORE-27</a> reported by
2687 Peter Royal. <code>SMTPAppender</code> now outputs its presentation
2688 footer and file footer in the the correct order.
2689 </p>
2690
2691 <!-- ========================== LB CLASSIC ================== -->
2692
2693 <p>Fixed issue <a
2694 href="http://jira.qos.ch/browse/LBCLASSIC-67">LBCLASSIC-67</a>
2695 reported by Alessandro Fustini. SMTPAppender now correctly
2696 configures the layout used to format the subject line of the
2697 outgoing email. It no longer appends a lengthy stack trace to the
2698 subject line.
2699 </p>
2700
2701
2702 <p>Fixed issue <a
2703 href="http://jira.qos.ch/browse/LBCLASSIC-68">LBCLASSIC-68</a>
2704 reported by Gili Tzabari. In environments where the TCCL (Thread
2705 Context Class Loader) was not set, logback was unable to located its
2706 default configuration files. Logback now uses the class loader that
2707 loaded logback itself to locate its resources instead of the
2708 TCCL. This approach is simpler and deemed to cover more
2709 environments, i.e. more widely applicable.
2710 </p>
2711
2712
2713 <p>Fixed issue <a
2714 href="http://jira.qos.ch/browse/LBGENERAL-24">LBGENERAL-24</a>
2715 reported by Hung Tang. SMTPAppender now supports plain
2716 username/password authentication as well as both the STARTTLS
2717 command and SSL connections.
2718 </p>
2719
2720
2721 <p>Fixed issue <a
2722 href="http://jira.qos.ch/browse/LBCLASSIC-48">LBCLASSIC-48</a>
2723 reported by Peter Royal. SyslogAppender now correctly outputs hours
2724 as 0-23 and not as 1-12 as previously.
2725 </p>
2726
2727 <p>Added a new TurboFilter called DynamicThresholdFilter which can
2728 filter events depending on MDC values based on a variety of criteria
2729 such as company name, product or the end user. This filter was
2730 contributed by Ralph Goers in <a
2731 href="http://jira.qos.ch/browse/LBCLASSIC-53">LBCLASSIC-53</a>.
2732 </p>
2733
2734
2735 <hr width="80%" align="center" />
2736
2737
2738
2739 <h3>26th of March 2008 - Release of version 0.9.9</h3>
2740
2741 <p>MDC data in now inherited by child threads. This behaviour was
2742 already specified in the javadocs. The issue was raised by Martin
2743 Benda in <a href="http://bugzilla.qos.ch/show_bug.cgi?id=64">bug
2744 64</a> and independently by Peter Huber.
2745 </p>
2746
2747 <p>Logback no longer includes retro-weaver generated jars for JDK
2748 1.4. There seems to be little interest in JDK 1.4 builds. Calling
2749 retro-weaver increases logback's build time by a few seconds each
2750 time &ndash; seconds in which we can do more productive things.
2751 </p>
2752
2753 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=104">bug
2754 104</a>, silly but but nonetheless serious copy-and-paste errors in
2755 the c.q.l.classic.Logger class, reported by Joern Huxhorn.
2756 </p>
2757
2758 <p>Having been replaced by <code>SimpleSocketServer</code>, the
2759 <code>SocketServer</code> class has been removed.
2760 </p>
2761
2762 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=105">bug
2763 105</a>, sockets created by <code>SocketAppenderBase</code> is now
2764 closed, reported by Joern Huxhorn. More generally,
2765 <code>SimpleSocketServer</code> is much more careful to track open
2766 client connections and to close them.
2767 </p>
2768
2769 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=110">bug
2770 110</a> in relation with the <code>requestParameterMap</code> field
2771 in <code>AccessEvent</code> - reported by Joern Huxhorn.
2772 </p>
2773
2774 <p>Fixed <a href="http://bugzilla.slf4j.org/show_bug.cgi?id=66">
2775 SLF4J bug 66</a> in relation with caller data when using
2776 log4j-over-slf4j - reported by Frnack Routier.
2777 </p>
2778
2779 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=129">bug
2780 129</a> reported by Michael Franz. As a result, Joran now supports
2781 nested as well as multiple file inclusions.
2782 </p>
2783
2784 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=100">bug
2785 100</a> reported by Joern Huxhorn. At serialization time, object
2786 array passed as parameter, when the LoggingEvent is are now
2787 serialized as strings.
2788 </p>
2789
2790 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=109">bug
2791 109</a> reported by Joern Huxhorn. There should no longer be any
2792 NullPointerExceptions thrown by deserialized
2793 <code>AccessEvent</code> instances.
2794 </p>
2795
2796 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=8">bug
2797 8</a> reported by Sebastien Pennec. The documentation has been
2798 updated to reflect the fact that that in the context of conversion
2799 patterns the percent sign carries special meaning, in order to
2800 include the percent sign as a literal, it must be escaped with a
2801 backslash.
2802 </p>
2803
2804 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=52">bug
2805 52</a> reported by Kenichi Masuko. The bug has been fixed on March
2806 8th, 2007. Starting with this release, Joran will support the
2807 injection of any enum type, not just <code>FilterReply</code>.
2808 </p>
2809
2810 <hr width="80%" align="center" />
2811
2812
2813 <h3>22th of August 2007 - Release of version 0.9.8</h3>
2814
2815 <p>This version of logback synchronizes with SLF4J version 1.4.3. In
2816 particular, logback now natively supports SLF4J's MDC API introduced
2817 in SLF4J version 1.4.1. If you are using SLF4J version 1.4.1 or
2818 later please make sure upgrade to logback version 0.9.8 or later.
2819 </p>
2820
2821 <p>Fixed a number of documentation related bugs, in particular <a
2822 href="http://bugzilla.qos.ch/show_bug.cgi?id=90">bug 90</a> reported
2823 by Luc Maisonobe and <a
2824 href="http://bugzilla.qos.ch/show_bug.cgi?id=90">bug 88</a> reported
2825 by Sebastian Davids.
2826 </p>
2827
2828 <p>It is now possible to include configuration file fragments (in
2829 XML) as a resource. Previously, it was only possible to include a
2830 file by specifying a path to a file or a URL. This feature was
2831 requested by Michael Newcomb in <a
2832 href="http://bugzilla.qos.ch/show_bug.cgi?id=89">bug 89</a>.
2833 </p>
2834
2835 <p>Fixed caller data extraction problem as reported in <a
2836 href="http://bugzilla.qos.ch/show_bug.cgi?id=78">bug 78</a> by Hans
2837 van der Meer.
2838 </p>
2839
2840 <p>The LoggingEvent class' constructor now correctly takes into
2841 account the argument array passed by the user. This problem was
2842 reported in <a href="http://bugzilla.qos.ch/show_bug.cgi?id=85">bug
2843 85</a> by Robert Christian.
2844 </p>
2845
2846 <hr width="80%" align="center" />
2847
2848
2849 <h3>29th of May 2007 - Release of version 0.9.7</h3>
2850
2851
2852 <p>This release corrects packaging bugs <a
2853 href="http://bugzilla.qos.ch/show_bug.cgi?id=75">75</a> and <a
2854 href="http://bugzilla.qos.ch/show_bug.cgi?id=76">76</a> related to
2855 the migration of logback to SLF4J version 1.4.0. There are no other
2856 changes.
2857 </p>
2858
2859
2860 <hr width="80%" align="center" />
2861
2862 <h3>23rd of May 2007 - Release of version 0.9.6</h3>
2863
2864
2865 <p>Logback is now aligned and compatible with SLF4J version 1.4.0,
2866 thus correcting <a
2867 href="http://bugzilla.qos.ch/show_bug.cgi?id=73">bug 73</a> as
2868 reported by Andy Gerweck.
2869 </p>
2870
2871 <p>Fixed <code>NoClassDefFoundError</code> problem when running
2872 under JDK 1.4 <a
2873 href="http://www.qos.ch/pipermail/logback-user/2007-April/000206.html">as
2874 reported</a> by Brian Suksomwong.
2875 </p>
2876
2877 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=63">bug
2878 63</a> as reported by La Canea Rosario. Calling log4j (bridge) with
2879 the trace level will no longer cause an IllegalStateException to be
2880 thrown.
2881 </p>
2882
2883 <p>Fixed <a href="http://bugzilla.qos.ch/show_bug.cgi?id=70">bug
2884 70</a> as reported by Dirk Ooms. The %throwable conversion word is
2885 now recognized as documented in the logback manual. Moreover, the
2886 manual now mentions the %nopex word which can be used to force
2887 <code>PatternLayout</code> to ignore the exception contained in the
2888 logging request.
2889 </p>
2890
2891
2892 <p>As in most releases, the documentation has been improved.</p>
2893
2894 <hr width="80%" align="center" />
2895
2896
2897 <h3>April 2nd, 2007 - Release of version 0.9.5</h3>
2898
2899 <p>Fixed methods <code>isInfoEnabled</code>,
2900 <code>isWarnEnabled</code> and <code>isErrorEnabled</code> methods
2901 in <code>ch.qos.logback.classic.Logger</code> class which failed to
2902 work correctly. This bug was reported today by Pavel Kral on the
2903 slf4j-user list.
2904 </p>
2905
2906 <p>Contrary to previous versions of logback, the various
2907 Logger.isXYZEnabled(Marker) methods now take into account the marker
2908 information passed as parameter.
2909 </p>
2910
2911
2912 <p>As discussed in <a
2913 href="http://bugzilla.qos.ch/show_bug.cgi?id=54">bug 54</a>, during
2914 automatic initialization, it makes better sense to first check for
2915 <em>logback-test.xml</em> file and only if that fails, to check for
2916 <em>logback.xml</em>. Maven2 will guarantee that the
2917 logback-test.xml file, if places under test/resources will not be
2918 included in the artifact it produces.
2919 </p>
2920
2921
2922 <hr width="80%" align="center" />
2923
2924 <h3>March 29th, 2007 - Release of version 0.9.4</h3>
2925
2926 <p>Significant bug fixes made to <code>c.q.l.access.TeeFilter</code>
2927 and Co. Images and other binary files are now intercepted and
2928 replayed correctly. As for "x-www-form-urlencoded" post requests,
2929 their input buffer is left untouched. In a best-effort attempt, the
2930 input buffer for "x-www-form-urlencoded" post requests is later
2931 reconstructed through the request parameters. However, it may differ
2932 from the original buffer.
2933 </p>
2934
2935 <p>The logback team released today the first version of a plugin for
2936 Eclipse that allows developers to visualize logs generated by a
2937 running application. It offers several nice features. Please check
2938 the <a href="consolePlugin.html">console plugin-in guide</a> for
2939 more details.
2940 </p>
2941
2942
2943 <h3>March 20th, 2007 - Release of version 0.9.3</h3>
2944
2945 <p>Includes in configuration files are now supported by Joran,
2946 logback's configuration framework. A file can contain an
2947 <em>include</em> element that has a <em>file</em> or <em>url</em>
2948 attribute pointing to a configuration file. See the <a
2949 href="manual/configuration.html#fileInclusion">chapter about
2950 configuration</a> in the logback's online manual for more
2951 information.
2952 </p>
2953
2954 <p>Corrected bug 53 reported by Wilkins Poe. There is now a <a
2955 href="dependencies.html">dependencies page</a> that shows the
2956 requirements of each of logback's modules.
2957 </p>
2958
2959 <p>After a <a
2960 href="http://www.slf4j.org/pipermail/user/2007-March/000297.html">
2961 discussion on the SLF4J mailing list</a> started by Franck Routier,
2962 a correction has been made when logging using the
2963 <em>JCL104-over-slf4j</em> module. Logback now correctly shows the
2964 caller location information.
2965 </p>
2966
2967 <p>As in most logback releases, the documentation has been improved.
2968 </p>
2969
2970
2971 <h3>March 5th, 2007 - Release of version 0.9.2</h3>
2972
2973 <p>The documentation is now in the <em>docs/</em> directory to allow an
2974 easier access to the logback manual and website for offline viewing.
2975 </p>
2976
2977 <h3>March 5th, 2007 - Release of version 0.9.1</h3>
2978
2979 <p>Logback-class now depends on SLF4J version 1.3.0 instead of
2980 1.2.</p>
2981
2982 <p>Numerous improvements to the documentation.</p>
2983
2984 <p><a href="http://bugzilla.qos.ch/show_bug.cgi?id=46">Bug #46</a>
2985 reported by Mark Renyolds has been fixed. The
2986 <code>TimeUtilTest</code> should now run fine under any time
2987 zone.</p>
2988
2989 <p><a href="http://bugzilla.qos.ch/show_bug.cgi?id=45">Bug
2990 #45</a>, also reported by Mark Reynolds, has been fixed. There
2991 should be no <code>ClassCastException</code> thrown anymore when
2992 passing an <code>Object</code> to the printing methods using the
2993 log4j-bridge module. </p>
2994
2995 <hr width="80%" align="center" />
2996
2997 <h3>January 31st, 2007 - Release of version 0.9</h3>
2998
2999 <p>This version contains a new component, namely the
3000 <code>ContextSelector</code>, that provides context separation and
3001 management when logback is used by several web-apps running under
3002 the same server. A <a href="manual/contextSelector.html">new
3003 chapter</a> was added to the logback manual to detail the use of the
3004 <code>ContextSelector</code>, along with its associated components.
3005 </p>
3006
3007 <p>The <code>JMXConfigurator</code> has been improved. It now shows
3008 the context's Status objects, which lets users check the internal
3009 state of logback.
3010 </p>
3011
3012 <p>The logback manual's chapter 2, about <a
3013 href="manual/architecture.html">logback's architecture</a>, has been
3014 updated with two sections: Under the hood and Performance.
3015 </p>
3016
3017 <hr width="80%" align="center" />
3018
3019 <h3>January 23th, 2007 - Release of version 0.8.1</h3>
3020
3021 <p>This version contains new components in the Access module,
3022 allowing users to display the full HttpServletRequest or
3023 HttpServletResponse of an access event.
3024 </p>
3025
3026 <p>The documentation section has been updated. The short
3027 introduction was split into the chapter 1 and chapter 2 of the
3028 logback manual. The chapters about Appenders and Layouts have been
3029 updated to document new components of logback.
3030 </p>
3031
3032 <p>A demonstration webApp presenting logback's major components is
3033 available. A document explains how to run it, and provides a
3034 step-by-step visit of the demo.
3035 </p>
3036
3037 <p>A first translation of logback jars to JDK1.4 is present in
3038 this release.
3039 </p>
3040
3041
3042 <hr width="80%" align="center" />
3043
3044 <h3>January 12th, 2007 - Release of version 0.8</h3>
3045
3046 <p>This version contains a whole new chapter, namely Chapter 3,
3047 about logback configuration. Several other documentation pages
3048 have been improved.
3049 </p>
3050
3051 <p>Logback now uses Generics in many components.
3052 </p>
3053
3054 <p>Several new components have been added to logback. A JMX
3055 Configurator now allows users to see and modify loggers or reload
3056 configuration among other possibilities. A <a
3057 href="jmxConfig.html">document</a> about this configurator is
3058 available in the <a href="documentation.html">corresponding
3059 section</a> of the site. We'd like to thank Sebastian Davids for his
3060 ideas and contributions to this component.
3061 </p>
3062
3063 <p>A JMSTopicAppender and JMSQueueAppender are now available, as
3064 well as two new filters: LevelFilter and ThresholdFilter. A
3065 refactoring was done in the filters objects to ease the
3066 implementation of custom filters.
3067 </p>
3068
3069 <hr width="80%" align="center" />
3070
3071
3072 <h3>December 19th, 2006 - Release of version 0.7.1</h3>
3073
3074 <p>Version 0.7.1 of logback has been released.
3075 </p>
3076
3077 <p>This version contains more detailed information about logback
3078 access module, and its JMX components. A <a
3079 href="access.html">dedicated page</a> explains how to configure and
3080 use logback access in Tomcat and Jetty, and access some of its
3081 components via JMX.
3082 </p>
3083
3084 <hr width="80%" align="center" />
3085
3086 <h3>December 18th, 2006 - Release of version 0.7</h3>
3087
3088 <p>Version 0.7 of logback has been released.</p>
3089
3090 <p>Logback now ships with a new module: <em>log4j-bridge</em>. This
3091 new module can be used to intercept log4j calls and redirects them
3092 to logback components. More information about this module can be
3093 found in the corresponding <a href="bridge.html">documentation
3094 page</a>.
3095 </p>
3096
3097 <p>The documentation has been vastly updated. Two new chapters,
3098 namely Filters and MDC, are available in the manual section.
3099 </p>
3100
3101 <hr width="80%" align="center" />
3102
3103 <h3>November 30th, 2006 - Release of version 0.6</h3>
3104
3105 <p>Version 0.6 of logback has been released.
3106 </p>
3107
3108 <p>Logback classic now supports automatic configuration, allowing
3109 test and production environment
3110 configuration. <code>TurboFilters</code> make their first appearance
3111 in a logback release. They provide ultra-fast filtering
3112 possibilities. The logging context now supports listeners which
3113 will be contacted each time the context is reset or
3114 started. <code>SMTPAppender</code> allows for much more flexible
3115 configuration than before.
3116 </p>
3117
3118 <p>In logback access, new Appenders are available, namely
3119 <code>SocketAppender</code> and <code>DBAppender</code>. Logback
3120 access now supports filtering and event evaluations. A
3121 <code>CountingFilter</code> has been added. It provides statistical
3122 views of server access, reachable via JMX.
3123 </p>
3124
3125 <p>The documentation has also been improved. A complete new chapter
3126 has been added about Appenders, the short introduction to logback
3127 classic has been updated and a new module, containing many
3128 configuration examples has been added.
3129 </p>
3130
3131 <p>Logback now uses continuous integration in its development.
3132 </p>
3133
3134 <p>Tests have been improved, many new have been added. This release
3135 also provides some bug fixes.
3136 </p>
3137
3138 <hr width="80%" align="center" />
3139
3140 <h3>October 26th, 2006 - Release of version 0.5</h3>
3141
3142 <p>Version 0.5 of logback has been released.
3143 </p>
3144
3145 <p>This release offers a important improvements in Joran. In
3146 particular, Joran can now replay configuration elements.
3147 </p>
3148
3149 <p>As in the previous release, a major area of work is the
3150 documentation which is being continuously improved.
3151 </p>
3152
3153 <hr width="80%" align="center" />
3154
3155 <h3>October 9th, 2006 - Release of version 0.4</h3>
3156
3157 <p>Version 0.3 of logback has been released.
3158 </p>
3159
3160 <p>This release includes an improved access module, with specific
3161 implementations for the Jetty and Tomcat servers. Documentation was
3162 also added to show how to integrate logback-access with Jetty.
3163 </p>
3164
3165 <p>As for the classic module, several appenders and layouts have
3166 been added or improved. The error reporting of logback has also
3167 been enhanced, presenting the user with a link to an online page
3168 explaining possible reasons for the error.
3169 </p>
3170
3171 <p>Joran documentation was added, with examples in the core
3172 module.
3173 </p>
3174
3175 <hr width="80%" align="center" />
3176
3177 <h3>September 8th, 2006 - Release of version 0.3</h3>
3178 <p>
3179 Version 0.3 of logback has been released.
3180 </p>
3181
3182 <p>This release offers several new Appenders, support for Mapped
3183 Diagnostic Context, improved tests and documentation<br />
3184 </p>
3185
3186 <p>In response to a bug report by Rickard Nilsson on the logback
3187 mailing list, a bug affecting parametrized logging was fixed.
3188 </p>
3189
3190 <p>We also released a <a
3191 href="http://logback.qos.ch/translator/">PropertiesTranslator</a>
3192 webapp that converts <em>log4j.properties</em> files to joran
3193 configuration files (in XML format).<br />
3194 </p>
3195
3196 <hr width="80%" align="center" />
3197
3198 <h3>August 23th, 2006 - Release of version 0.2.5</h3>
3199
3200 <p> Version 0.2.5 of logback has been released. </p>
3201
3202 <p>This release offers better documentation, with a number of
3203 corrections made in the short introduction to logback-classic.
3204 </p>
3205
3206 <hr width="80%" align="center" />
3207
3208
3209 <h3>August 15th, 2006 - Release of version 0.2</h3>
3210
3211 <p>Version 0.2 of logback has been released.</p>
3212
3213 <p>It offers better tests, some more functionality, and enhanced
3214 documentation. We also improved the site design to make it simpler
3215 and more efficient.
3216 </p>
3217
3218 <hr width="80%" align="center" />
3219
3220 <h3>July 26th, 2006 - Release of version 0.1</h3>
3221
3222 <p>Version 0.1 of logback has been released.</p>
3223
3224 <hr width="80%" align="center" />
3225
3226 <h3>February 9th, 2006 - Logback web-site goes live</h3>
3227
3228 <p>The logback web-site goes live on the 9th of February. At its
3229 present state, it is pretty primitive but updates will follow.
3230 </p>
3231
3232
3233 <script src="templates/footer.js" type="text/javascript"></script>
3234 </div>
3235 </body>
3236 </html>