模块 ringo/logging

该模块为Ringo应用程序提供通用日志记录支持。 如果在类路径中检测到任何一个,它将使用 SLF4JApache log4j ,否则将返回到 java.util.logging。

如果传递给任何日志记录方法的第一个参数是包含任意数目的大括号对({})的字符串,则记录器将将其解释为格式字符串,并使用任何以下参数来替换大括号对。 如果参数是错误或 Java 异常对象,则记录器将为其呈现堆栈跟踪并将其追加到日志消息中。

此模块的exports对象实现 EventEmitter 接口,并使用日志级别名称作为事件类型发出记录的消息。

Example

// Get a Logger for the current module
var log = require('ringo/logging').getLogger(module.id);

log.debug('Connected to ', url, ' [GET]');
log.error('This should not occur');
log.info('Info message');
log.info('User {} accessed {}', username, resource);
log.warn('A warning');

Functions


Logger (name, impl)

记录器类。此构造函数未导出,请使用此模块的 {@link getLogger} 获取记录器实例。

Parameters

String name

the Logger name

Object impl

the logger implementation

See


Logger.prototype. debug ()


Logger.prototype. error ()


Logger.prototype. info ()


Logger.prototype. isDebugEnabled ()


Logger.prototype. isErrorEnabled ()


Logger.prototype. isInfoEnabled ()


Logger.prototype. isTraceEnabled ()


Logger.prototype. isWarnEnabled ()


Logger.prototype. trace ()


Logger.prototype. warn ()


getJavaStack (error, prefix)

从捕获的错误中获取呈现的 JavaScript 堆栈跟踪。

Parameters

Error error

an error object

String prefix

to prepend to result if available

Returns

String

the rendered JavaScript stack trace


getLogger (name)

获取给定名称的记录器。

Parameters

String name

the name of the logger

Returns

Logger

a logger instance for the given name


getScriptStack (error, prefix)

从捕获的错误中获取呈现的 JavaScript 堆栈跟踪。

Parameters

Error error

an error object

String prefix

to prepend to result if available

Returns

String

the rendered JavaScript stack trace


setConfig (resource, watchForUpdates)

使用给定的文件资源配置 log4j。

如果您计划更新配置,请确保在配置文件中将 reset 属性设置为 true。

Parameters

Resource resource

the configuration resource in XML or properties format

Boolean watchForUpdates

if true a scheduler thread is started that repeatedly checks the resource for updates.