模块 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
Instance Methods
- debug()
- error()
- info()
- isDebugEnabled()
- isErrorEnabled()
- isInfoEnabled()
- isTraceEnabled()
- isWarnEnabled()
- trace()
- warn()
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. |