log4javascript

在不知道log4javascript为何物时，总喜欢在javascript中用alert()来跟踪代码信息，那叫烦，总是弹出对话框。
有问题就得解决问题啊，google……，搜索到log4javascript。
读了下tutorial发现工具很好用，马上放到自己正在开发的一个项目中，准备体验一下效果。使用步骤如下（基本上是对文档的翻译）：
1、下载地址：http://sourceforge.net/projects/log4javascript

2、解压下载的文件并拷贝log4javascript.js到你需要的地方，其他文件可选

3、在web页面中初始化log4javascript。

<script type="text/javascript" src="log4javascript.js"></script>
<script type="text/javascript">
	var log = log4javascript.getDefaultLogger();
</script>

默认的logger使用PopUpAppender，它会打开一个窗口。默认情况下，这个窗口会在写第一条日志时打开。如果你不想要弹出这个窗口，你可以使用如下代码，屏蔽它。

log.setEnabled(false);

4、包括你的logging语句在你的代码里
你有6种写日志的方法，这取决于你希望记录日志内容的严重性。默认情况下，所有的消息在弹出窗口中打印。logging方法如下：

log.trace(message[, message2, ... ][, exception]) 
log.debug(message[, message2, ... ][, exception]) 
log.info(message[, message2, ... ][, exception]) 
log.warn(message[, message2, ... ][, exception]) 
log.error(message[, message2, ... ][, exception]) 
log.fatal(message[, message2, ... ][, exception])

5、Logging示例
（1）简单的logging消息字符串

log.info("Hello World");

显示如下

19:52:03 INFO  - Hello world

（2）记录错误消息串

try 
{
    throw new Error("Faking something going wrong!");
} 
catch (e) 
{
    log.error("An error occurred", e);
}

显示如下

19:52:32 ERROR - An error occurred Exception: Faking something going wrong! on line number 80 in file basic.html

（3）一条log语句记录多条信息

var a = "Hello";
var b = 3;
log.debug(a, b);

显示如下

19:53:05 DEBUG  - Hello 3

（4）log记录对象

var obj = new Object();
obj.name = "Octopus";
obj.tentacles = 8;
log.info(obj);

显示如下

19:53:17 INFO  - {
	name: Octopus,
	tentacles: 8
}

6、改变默认的logger
开始的时候使用默认的logger可能感觉不错，但是如果想要做一些改变我们应该做些什么呢？（比如：任何时候只要有日志消息都会弹出窗口，或者新的日志信息不是出现在窗口顶端而是出现在底端）
在这种情况下，你将会需要建立新的日志，然后，建立新的PopUpAppender，设置选项，并且增加到logger中：

<script type="text/javascript" src="log4javascript.js"></script>
<script type="text/javascript">
	// Create the logger
	var log = log4javascript.getLogger();

	// Create a PopUpAppender with default options
	var popUpAppender = new log4javascript.PopUpAppender();

	// Change the desired configuration options
	popUpAppender.setFocusPopUp(true);
	popUpAppender.setNewestMessageAtTop(true);

	// Add the appender to the logger
	log.addAppender(popUpAppender);

	// Test the logger
	log.debug("Hello world!");
</script>

7、发送日志信息到服务器端
对于这个问题可以使用AjaxAppender来解决，如下：

var ajaxAppender = new log4javascript.AjaxAppender(URL);
log.addAppender(ajaxAppender);

现在你的日志消息将会出现在弹出的窗口中，同时将被异步发送到你指定的URL中。

8、改变日志消息的格式
使用Layout，你可以格式化日志格式。例如：

var log = log4javascript.getLogger("mylogger");
var layout = new log4javascript.PatternLayout("[%-5p] %m");
var popUpAppender = new log4javascript.PopUpAppender(layout);

调用

log.debug("Hello world");

将会在窗口输出

[DEBUG] Hello world