@i11cn/logger NPM

Logger

暂时仅用于Client端的日志输出库

This library was generated with Angular CLI version 7.2.0.

Install

npm install @i11cn/logger --save

Usage

获取/创建一个Logger: let log = Loggers.getLogger("Sample");，其中的Logger用名称来区分是否相同，如果不存在指定名称的Logger，则会创建新Logger
配置Logger: log.setLevel(...).addAppender(...)...
使用: log.trace("输出字符串");

Sample

import { Loggers, Logger, LogLevel, Console } from '@i11cn/logger';

class Sample {

    constructor() {
        this.logger = Loggers.getLogger("sample");
        let con = new Console("%T %N %L: %M");
        this.logger.setName("SAMPLE").setLevel(LogLevel.ALL).addAppender(con);
    }

    ...

    foo() {
        this.logger.debug("测试日志");
        this.logger.debug("aa", "bb", "cc");
    }
    ...
}

另一个例子(Angular中实现LoggerService)

import { Injectable } from '@angular/core';
import { LoggerWrapper, Logger, LogLevel, Console } from '@i11cn/logger';

@Injectable({
    providedIn: 'root'
})
export class LoggerService extends LoggerWrapper {

    constructor() {
        super("Test");
    }

    initLogger(log: Logger) {
        log.setLevel(LogLevel.ALL).addAppender(new Console("%T %N %L : %M"));
    }

}

其中用到了抽象类LoggerWrapper，该类为LoggerService增加了todo、todo、debug、info、log、warning、error、fatal的代理方法，LoggerService只需要初始化Logger即可。

Class Document

Loggers

getLogger(name: string): Logger 静态方法，获取指定名称的Logger

Logger

setName(string): Logger; 设置记录在日志中的日志名称，如果不设置，默认就是getLogger时指定的名称
on(): Logger; 打开日志，日志可以正常记录
off(): Logger; 关闭日志，无论任何Level的日志都不会被记录
setLevel(number): Logger; 设置日志允许记录的最低Level，低于Level的日志被忽略
addAppender(Appender): Logger; 添加日志输出位置
setTimeLayout(string): Logger; 设置时间戳的默认格式，如果Appender中没有设置特定格式，则会使用该默认格式。由于使用的库是date-fns，因此具体的时间戳格式字符串，参考库date-fns中的说明
setSkipCallstack(n: number): Logger; 如果要正确获取记录点的函数名，需要跳过的调用层级（考虑到有可能会有封装）
trace、debug、info、log、warning、error、fatal、todo，用来做实际的记录，参数可以接受字符串、Map<string, any>、object、()=> string、以及任意数量的any，区别在于字符串、object会直接输出，Map会组织成key=value的字符串输出，()=> string会调用该函数产生字符串后输出，任意数量的any类型会以字符串的性质连接起来输出

LoggerWrapper

封装了Logger的代理，适用于要将Logger封装一层的场合，例如Angular里的LoggerService
LoggerWrapper的构造函数有一个参数，即要封装的Logger的名称，因此在继承时，别忘记在子类的构造函数中调用 super("Logger名称")
LoggerWrapper只负责创建Logger，而对Logger的初始化要由子类负责，子类必须要实现initLogger方法

Appender

如果需要自己扩展Appender，就需要继承Appender类，实现自己的子类

output(d: LogData, obj): void Logger会调用output来输出内容，LogData是Logger传来的数据，obj是从记录点传来的数据，可以自己检查obj类型后分别处理
setLayout(layout: string): Appender 设置Appender的日志格式，没有共用的默认格式，必须要为每一个Appender设置自己的格式，默认格式为 [%T] [%N] [%L] : %M
setTimeLayout(layout: string): Appender 设置Appender所用的时间戳格式
mapToObj(obj: Map<string, any>): any 将Typescript的Map转换成JSON能够识别的object
protected buildMsg(d: LogData, m: string): string 根据Layout、LogData和日志字符串，生成最终需要记录的字符串
protected write(msg: string): void 负责将最终的字符串做实际输出的操作，如果没有特殊需求，只需要重载该方法即可，如果有特殊需求，就需要重载output（比如有一些类型需要特殊处理）