はじめてのlog4js

ダウンロード

こちらからダウンロードします。
ファイル名は私の時はlog4js-1.0-RC1.zipでした。

解凍すると、libディレクトリにlog4js-lib.jsが、src/main/jsディレクトリにlog4js.jsがありますが、どちらも同じものです。 (log4js-lib.jsのほうは、ファイルサイズを抑えるために、不要なコメントやインテンドが省かれています。)

使い方

log4js.jsもしくはlog4js-lib.jsのインポート
ロガーの取得
ログレベルの設定
アペンダーの定義
ログの記述

log4jsの使い方を、log4jsTest.htmlを作成しながら説明します。

log4jsTest.html

<html>
<head>
<title>log4jsTest</title>
</head>
<body>
</body>
</html>

log4js.jsもしくはlog4js-lib.jsのインポート

まずはlog4js.jsかlogjs-lib.jsをインポートします。
ここではlog4js.jsをlog4jsTest.htmlと同じディレクトリにコピーしているものとします。

log4jsTest.html

<html>
<head>
<title>log4jsTest</title>
<script type="text/javascript" src="./log4js.js"></script>
</head>
<body>
</body>
</html>

ロガーの取得

<html>
<head>
<title>log4jsTest</title>
<script type="text/javascript" src="./log4js.js"></script>
<script type="text/javascript">
// <![CDATA[

var logger = new Log4js.getLogger('myCategory');

// ]]>
</script>
</head>
<body>
</body>
</html>

ログレベルの設定

log4jsTest.html

<html>
<head>
<title>log4jsTest</title>
<script type="text/javascript" src="./log4js.js"></script>
<script type="text/javascript">
// <![CDATA[

var logger = new Log4js.getLogger('myCategory');
logger.setLevel(Log4js.Level.INFO);

// ]]>
</script>
</head>
<body>
</body>
</html>

設定できるログレベルの次の通りです。
OFFはいずれのログも行わず、ALLはいずれのログも行います。

OFF
FATAL
ERROR
WARN
INFO
DEBUG
TRACE
ALL

アペンダーの定義

いくつかアペンダーがありますが、ここではConsoleAppenderを定義しています。

log4jsTest.html

<html>
<head>
<title>log4jsTest</title>
<script type="text/javascript" src="./log4js.js"></script>
<script type="text/javascript">
// <![CDATA[

var logger = new Log4js.getLogger('myCategory');
logger.setLevel(Log4js.Level.INFO);
logger.addAppender(new Log4js.ConsoleAppender());

// ]]>
</script>
</head>
<body>
</body>
</html>

Log4js.ConsoleAppender(boolean isInline)

ログを記述する

log4jsTest.html

<html>
<head>
<title>log4jsTest</title>
<script type="text/javascript" src="./log4js.js"></script>
<script type="text/javascript">
// <![CDATA[

var logger = new Log4js.getLogger('myCategory');
logger.setLevel(Log4js.Level.INFO);
logger.addAppender(new Log4js.ConsoleAppender());

// ]]>
</script>
</head>
<body>
<script type="text/javascript">
// <![CDATA[

logger.error('error log');
logger.warn('warning log');
logger.info('information log');
logger.debug('debugging log');
logger.trace('trace log');

// ]]>
</script>
</body>
</html>

実行結果

ログレベルがINFOなので、INFO以上のレベルのログのみ表示されています。

log4jsメモ / <戻る> / <ページ先頭> / log4js注意事項