log4javascript
Version:
91 lines (88 loc) • 4.66 kB
HTML
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>log4javascript - backwards incompatibilities in version 1.4</title>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<meta name="author" content="Tim Down - tim@log4javascript.org" />
<meta name="description" content="log4javascript, a logging framework for JavaScript based on log4j" />
<meta name="robots" content="all" />
<link rel="stylesheet" type="text/css" media="screen,print" href="../main.css" title="Default" />
</head>
<body>
<div id="container" class="nonav">
<div id="header">
<h1><a href="/index.html">log4javascript</a></h1>
</div>
<div id="content">
<div id="nav">
<a class="navitem" href="../index.html">home</a>
| <a class="navitem" href="http://sourceforge.net/projects/log4javascript" target="_blank" title="Download (opens in new window)">download</a>
| <a class="navitem" href="index.html">docs</a>
| <a class="navitem" href="quickstart.html">quick start</a>
| <a class="navitem" href="../demos/index.html">demos</a>
| <a class="navitem" href="http://log4javascript.org" target="_blank">website</a>
| <a class="navitem" href="http://www.timdown.co.uk" target="_blank">timdown.co.uk</a>
</div>
<h1>Backwards incompatibilities in log4javascript 1.4</h1>
<ul>
<li>
Loggers are now hierarchical. This means logger names containing full stops have
special meaning. For example, from version 1.4 the logger named <code>myapp.ajax</code>
by default inherits all the appenders of the logger named <code>myapp</code>, while
prior to version 1.4 these loggers would be entirely independent;
</li>
<li>
The signature of the <code>log</code> method of <code>Logger</code> has changed.
However, you should not use this method directly; instead, use one of the level-specific
wrapper functions (<code>debug</code>, <code>info</code>, <code>error</code> etc.);
</li>
<li>
Appenders can no longer be configured via constructor parameters. Instead you must use
setter methods;
</li>
<li>
The format of requests sent via <code><a href="manual.html#ajaxappender">AjaxAppender</a></code>
has changed when using <code><a href="manual.html#jsonlayout">JsonLayout</a></code> or
<code><a href="manual.html#xmllayout">XmlLayout</a></code>: the formatted log messages are sent
as a name-value pair (with default name <code>data</code>) rather than a single unencoded string;
</li>
<li>
All timestamps returned by <code><a href="manual.html#xmllayout">XmlLayout</a></code>,
<code><a href="manual.html#jsonlayout">JsonLayout</a></code> and
<code><a href="manual.html#httppostdatlayout">HttpPostDataLayout</a></code> are
now measured in milliseconds since January 1st 1970 (previously they were returned
as seconds since January 1st 1970);
</li>
<li>
The constructors for <a href="manual.html#jsonlayout">JsonLayout</a> and
<a href="manual.html#httppostdatlayout">HttpPostDataLayout</a> have changed; the property names
used for the properties of the logging event are now set via <code>setKeys</code> rather than
in the constructor;
</li>
<li>
<code>setReadable</code> has been removed from <a href="manual.html#jsonlayout">JsonLayout</a>.
The <code>readable</code> property should now be set via the constructor;
</li>
<li>
<code>addErrorListener</code> and <code>removeErrorListener</code> removed from
the <code>log4javascript</code> object and replaced with the more generic
<code><a href="manual.html#log4javascriptaddeventlistener">addEventListener</a></code>
and <code>removeEventListener</code> methods. The listener functions are passed
different parameters.
</li>
</ul>
</div>
<div id="footer">
<span class="externallinkinfo">
<strong>NB.</strong> All external links open in a new window.
</span>
Written by Tim Down. <a href="mailto:tim@log4javascript.org">tim@log4javascript.org</a>
<br />
log4javascript is distributed under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html"
title="Apache License, Version 2.0 (opens in new window)" target="_blank">Apache License,
Version 2.0</a>
</div>
</div>
</body>
</html>