Logger

INFO

用于输出日志，继承了AbstractLogger

方法

Logger具有以下方法

registerLogListener(listener): this 1.3.0-rc.1 +

• listener (level: Level, content: string) => void

注册一个监听器，当有日志被记录时调用，支持链式调用

getHistoryOfAppender(predicates) 1.1.0 +

• predicates string | AppenderTypeEnum - 可以是Appender名称或类型，返回第一个符合条件的Appender

获取本次应用启动至被调用时期间生成的日志

getAllHistoryOfAppender(predicates) 1.1.0 +

• predicates string - 用于搜索具名FileAppender

获取包括缓存在内的所有日志内容

setLevel(level): this

• level Level - 要设置的日志级别

设置新日志级别，该方法会返回实例本身，支持链式调用

withMarker(marker): this

• marker Marker - 要添加的标签，通过MarkerManager.getMarker获取

为下一条要写出的日志添加一个标签，该标签将随附在日志内容尾部，支持链式调用

addAppender(appender)

• appender T extends AbstractAppender - 追加器

将appender绑定至该Logger。appender可以是log4a内置的任何追加器，也可以由开发者自行实现。

addFileAppender(path, name, level?, options?)

• path string - 要写出的文件路径
• name string - 该FileAppender的名称，用于作为删除索引
• level Level - 最高输出日志级别，高于该级别的日志将被忽略
• options
  • useWorker boolean - 是否启用多线程
  • maxFileSize number - 最大日志文件占用，以KB为单位
  • maxCacheCount number - 最大日志缓存数量
  • encryptor (level: Level, originalLog: string | ArrayBuffer) => string | ArrayBuffer - 加密函数

向Logger添加一个新的FileAppender，支持链式调用

addConsoleAppender(level?): this

• level - 输出的最高日志等级，默认Level.ALL

设置该Logger的日志输出级别，高于此级别的日志将被忽略，过滤优先度高于Appender，支持链式调用

clearAppender(): this

删除该Logger所有绑定的Appender，支持链式调用

removeTypedAppender(type): this

• type AppenderTypeEnum - 要移除的Appender类型

删除所有类型为type的Appender，支持链式调用

removeNamedAppender(name): this

• name string - 要移除的Appender名称

删除名称为name的FileAppender，支持链式调用

debug(format, ...args)

• format string - 输出格式
• args any - 输出变量

输出一条Level为DEBUG的日志

error(format, ...args)

• format string - 输出格式
• args any - 输出变量

输出一条Level为ERROR的日志

info(format, ...args)

• format string - 输出格式
• args any - 输出变量

输出一条Level为INFO的日志

fatal(format, ...args)

• format string - 输出格式
• args any - 输出变量

输出一条Level为FATAL的日志

trace(format, ...args)

• format string - 输出格式
• args any - 输出变量

输出一条Level为TRACE的日志

terminate()

终止所有Appender，并结束该Logger的运行