planetstack/core/static/log4javascript-1.4.6/docs/backwardsincompatibilities.html

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