RingoJS

模块 ringo/logging

该模块为Ringo应用程序提供通用日志记录支持。如果在类路径中检测到任何一个，它将使用 SLF4J 或 Apache 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

getJavaStack (error, prefix)
getLogger (name)
getScriptStack (error, prefix)
setConfig (resource, watchForUpdates)

Class Logger

Logger (name, impl)

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

Parameters

String	name	the Logger name
Object	impl	the logger implementation

See

getLogger

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.