<?xml version="1.0"?> | |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | |
<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> |