Siobhan Tully | e18b344 | 2014-02-23 14:23:34 -0500 | [diff] [blame] | 1 | <?xml version="1.0"?>
|
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
| 3 | <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
| 4 | <head>
|
| 5 | <title>log4javascript - backwards incompatibilities in version 1.4</title>
|
| 6 | <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
|
| 7 | <meta name="author" content="Tim Down - tim@log4javascript.org" />
|
| 8 | <meta name="description" content="log4javascript, a logging framework for JavaScript based on log4j" />
|
| 9 | <meta name="robots" content="all" />
|
| 10 | <link rel="stylesheet" type="text/css" media="screen,print" href="../main.css" title="Default" />
|
| 11 | </head>
|
| 12 | <body>
|
| 13 | <div id="container" class="nonav">
|
| 14 | <div id="header">
|
| 15 | <h1><a href="/index.html">log4javascript</a></h1>
|
| 16 | </div>
|
| 17 | <div id="content">
|
| 18 | <div id="nav">
|
| 19 | <a class="navitem" href="../index.html">home</a>
|
| 20 | | <a class="navitem" href="http://sourceforge.net/projects/log4javascript" target="_blank" title="Download (opens in new window)">download</a>
|
| 21 | | <a class="navitem" href="index.html">docs</a>
|
| 22 | | <a class="navitem" href="quickstart.html">quick start</a>
|
| 23 | | <a class="navitem" href="../demos/index.html">demos</a>
|
| 24 | | <a class="navitem" href="http://log4javascript.org" target="_blank">website</a>
|
| 25 | | <a class="navitem" href="http://www.timdown.co.uk" target="_blank">timdown.co.uk</a>
|
| 26 | </div>
|
| 27 | <h1>Backwards incompatibilities in log4javascript 1.4</h1>
|
| 28 | <ul>
|
| 29 | <li>
|
| 30 | Loggers are now hierarchical. This means logger names containing full stops have
|
| 31 | special meaning. For example, from version 1.4 the logger named <code>myapp.ajax</code>
|
| 32 | by default inherits all the appenders of the logger named <code>myapp</code>, while
|
| 33 | prior to version 1.4 these loggers would be entirely independent;
|
| 34 | </li>
|
| 35 | <li>
|
| 36 | The signature of the <code>log</code> method of <code>Logger</code> has changed.
|
| 37 | However, you should not use this method directly; instead, use one of the level-specific
|
| 38 | wrapper functions (<code>debug</code>, <code>info</code>, <code>error</code> etc.);
|
| 39 | </li>
|
| 40 | <li>
|
| 41 | Appenders can no longer be configured via constructor parameters. Instead you must use
|
| 42 | setter methods;
|
| 43 | </li>
|
| 44 | <li>
|
| 45 | The format of requests sent via <code><a href="manual.html#ajaxappender">AjaxAppender</a></code>
|
| 46 | has changed when using <code><a href="manual.html#jsonlayout">JsonLayout</a></code> or
|
| 47 | <code><a href="manual.html#xmllayout">XmlLayout</a></code>: the formatted log messages are sent
|
| 48 | as a name-value pair (with default name <code>data</code>) rather than a single unencoded string;
|
| 49 | </li>
|
| 50 | <li>
|
| 51 | All timestamps returned by <code><a href="manual.html#xmllayout">XmlLayout</a></code>,
|
| 52 | <code><a href="manual.html#jsonlayout">JsonLayout</a></code> and
|
| 53 | <code><a href="manual.html#httppostdatlayout">HttpPostDataLayout</a></code> are
|
| 54 | now measured in milliseconds since January 1st 1970 (previously they were returned
|
| 55 | as seconds since January 1st 1970);
|
| 56 | </li>
|
| 57 | <li>
|
| 58 | The constructors for <a href="manual.html#jsonlayout">JsonLayout</a> and
|
| 59 | <a href="manual.html#httppostdatlayout">HttpPostDataLayout</a> have changed; the property names
|
| 60 | used for the properties of the logging event are now set via <code>setKeys</code> rather than
|
| 61 | in the constructor;
|
| 62 | </li>
|
| 63 | <li>
|
| 64 | <code>setReadable</code> has been removed from <a href="manual.html#jsonlayout">JsonLayout</a>.
|
| 65 | The <code>readable</code> property should now be set via the constructor;
|
| 66 | </li>
|
| 67 | <li>
|
| 68 | <code>addErrorListener</code> and <code>removeErrorListener</code> removed from
|
| 69 | the <code>log4javascript</code> object and replaced with the more generic
|
| 70 | <code><a href="manual.html#log4javascriptaddeventlistener">addEventListener</a></code>
|
| 71 | and <code>removeEventListener</code> methods. The listener functions are passed
|
| 72 | different parameters.
|
| 73 | </li>
|
| 74 | </ul>
|
| 75 | </div>
|
| 76 | <div id="footer">
|
| 77 | <span class="externallinkinfo">
|
| 78 | <strong>NB.</strong> All external links open in a new window.
|
| 79 | </span>
|
| 80 | Written by Tim Down. <a href="mailto:tim@log4javascript.org">tim@log4javascript.org</a>
|
| 81 | <br />
|
| 82 | log4javascript is distributed under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html"
|
| 83 | title="Apache License, Version 2.0 (opens in new window)" target="_blank">Apache License,
|
| 84 | Version 2.0</a>
|
| 85 |
|
| 86 | </div>
|
| 87 | </div>
|
| 88 |
|
| 89 | </body>
|
| 90 | </html>
|