log4js模块应用
安装1
npm install log4js
- 配置说明
1 | { |
pattern可以使用的占位符说明，不属于下列占位符格式，均会原样输出为文件名（注：不支持单个M、d、h、m）：
yy 两位年份
yyyy 四位年份
MM 两位月份
dd 两位日期
hh 两位的小时数，按24小时制
mm 两位的分数数
ss 两位的秒数
SSS 三位的毫秒数
O 时区，大写字母O，占位符输出结果为+0800
- 输出日志代码
首先请把上面的配置代码保存为log4js.json文件，用于代码从文件加载配置（配置独立也便于修改和发布）：
注意：json文件不支持任何形式的注释// 或 /**/，因此上面的配置代码里的注释要全部移除，不然会编译出错的1
2
3
4
5
6var log4js = require('log4js');
// 注：配置里的日志目录要先创建，才能加载配置，不然会出异常
log4js.configure("./log4js.json");
var logInfo = log4js.getLogger('logInfo');
logInfo.info("测试日志信息");
上述配置和代码，比较简单，重新封装log4js，定义了一个logHelper.js
1、log4js.json配置文件内容（定义了4个日志记录器，分别写入到不同的日志目录；并自定义了2个属性，把一些公共属性提取到自定义属性中）：1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17{
"customBaseDir" :"e:/weblogs/logs/",
"customDefaultAtt" :{
"type": "dateFile",
"absolute": true,
"alwaysIncludePattern": true
},
"appenders": [
{"type": "console", "category": "console"},
{"pattern": "debug/yyyyMMddhh.txt", "category": "logDebug"},
{"pattern": "info/yyyyMMddhh.txt", "category": "logInfo"},
{"pattern": "warn/yyyyMMddhh.txt", "category": "logWarn"},
{"pattern": "err/yyyyMMddhh.txt", "category": "logErr"}
],
"replaceConsole": true,
"levels":{ "logDebug": "DEBUG", "logInfo": "DEBUG", "logWarn": "DEBUG", "logErr": "DEBUG"}
}
2、logHelper.js封装的文件内容1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111var helper = {};
exports.helper = helper;
var log4js = require('log4js');
var fs = require("fs");
var path = require("path");
// 加载配置文件
var objConfig = JSON.parse(fs.readFileSync("log4js.json", "utf8"));
// 检查配置文件所需的目录是否存在，不存在时创建
if(objConfig.appenders){
var baseDir = objConfig["customBaseDir"];
var defaultAtt = objConfig["customDefaultAtt"];
for(var i= 0, j=objConfig.appenders.length; i<j; i++){
var item = objConfig.appenders[i];
if(item["type"] == "console")
continue;
if(defaultAtt != null){
for(var att in defaultAtt){
if(item[att] == null)
item[att] = defaultAtt[att];
}
}
if(baseDir != null){
if(item["filename"] == null)
item["filename"] = baseDir;
else
item["filename"] = baseDir + item["filename"];
}
var fileName = item["filename"];
if(fileName == null)
continue;
var pattern = item["pattern"];
if(pattern != null){
fileName += pattern;
}
var category = item["category"];
if(!isAbsoluteDir(fileName))//path.isAbsolute(fileName))
throw new Error("配置节" + category + "的路径不是绝对路径:" + fileName);
var dir = path.dirname(fileName);
checkAndCreateDir(dir);
}
}
// 目录创建完毕，才加载配置，不然会出异常
log4js.configure(objConfig);
var logDebug = log4js.getLogger('logDebug');
var logInfo = log4js.getLogger('logInfo');
var logWarn = log4js.getLogger('logWarn');
var logErr = log4js.getLogger('logErr');
helper.writeDebug = function(msg){
if(msg == null)
msg = "";
logDebug.debug(msg);
};
helper.writeInfo = function(msg){
if(msg == null)
msg = "";
logInfo.info(msg);
};
helper.writeWarn = function(msg){
if(msg == null)
msg = "";
logWarn.warn(msg);
};
helper.writeErr = function(msg, exp){
if(msg == null)
msg = "";
if(exp != null)
msg += "\r\n" + exp;
logErr.error(msg);
};
// 配合express用的方法
exports.use = function(app) {
//页面请求日志, level用auto时,默认级别是WARN
app.use(log4js.connectLogger(logInfo, {level:'debug', format:':method :url'}));
}
// 判断日志目录是否存在，不存在时创建日志目录
function checkAndCreateDir(dir){
if(!fs.existsSync(dir)){
fs.mkdirSync(dir);
}
}
// 指定的字符串是否绝对路径
function isAbsoluteDir(path){
if(path == null)
return false;
var len = path.length;
var isWindows = process.platform === 'win32';
if(isWindows){
if(len <= 1)
return false;
return path[1] == ":";
}else{
if(len <= 0)
return false;
return path[0] == "/";
}
}
3、代码调用1
2
3var logger = require("./logHelper").helper;
logger.writeInfo("哈哈1开始记录日志");
logger.writeErr("出错了，你怎么搞的");
4、跟express集成，可以输出客户端GET 或 POST的url（如果没用，或者不需要记录url，这段代码忽略）：1
2
3
4//在app.js中添加以下代码, 以便在日志中输出url请求，由于加载顺序的原因，放在其他app.use前面
var app = express();
var log = require('./logHelper');
log.use(app);