包mx.logging
接口public interface ILogger extends IEventDispatcher
实现器 LogLogger

日志记录框架中的所有记录程序都必须实现此接口。

另请参见

Using the logging API

公共属性
 属性定义方
  category : String
[只读 (read-only)] 记录程序的类别值。
ILogger
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。
IEventDispatcher
  
debug(message:String, ... rest):void
使用 LogEventLevel.DEBUG 级别记录指定的数据。
ILogger
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
IEventDispatcher
  
error(message:String, ... rest):void
使用 LogEventLevel.ERROR 级别记录指定的数据。
ILogger
  
fatal(message:String, ... rest):void
使用 LogEventLevel.FATAL 级别记录指定的数据。
ILogger
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
IEventDispatcher
  
info(message:String, ... rest):void
使用 LogEvent.INFO 级别记录指定的数据。
ILogger
  
log(level:int, message:String, ... rest):void
在给定级别记录指定数据。
ILogger
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
IEventDispatcher
  
warn(message:String, ... rest):void
使用 LogEventLevel.WARN 级别记录指定的数据。
ILogger
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
IEventDispatcher
属性详细信息
category属性
category:String  [只读 (read-only)]

记录程序的类别值。



实现
    public function get category():String
方法详细信息
debug()方法
public function debug(message:String, ... rest):void

使用 LogEventLevel.DEBUG 级别记录指定的数据。LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。

为日志记录指定的字符串可以包含使用括号括起来的索引，用于指示在记录字符串之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

message:String — 要记录的信息。此字符串可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.debug("here is some channel info {0} and {1}", 15.4, true);
           // This will log the following String:
      //   "here is some channel info 15.4 and true"
error()方法 
public function error(message:String, ... rest):void

使用 LogEventLevel.ERROR 级别记录指定的数据。LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。

为日志记录指定的字符串可以包含使用括号括起来的索引，用于指示在记录字符串之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.error("here is some channel info {0} and {1}", 15.4, true);
           // This will log the following String:
      //   "here is some channel info 15.4 and true"
fatal()方法 
public function fatal(message:String, ... rest):void

使用 LogEventLevel.FATAL 级别记录指定的数据。LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件

为日志记录指定的字符串可以包含使用括号括起来的索引，用于指示在记录字符串之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.fatal("here is some channel info {0} and {1}", 15.4, true);
           // This will log the following String:
      //   "here is some channel info 15.4 and true"
info()方法 
public function info(message:String, ... rest):void

使用 LogEvent.INFO 级别记录指定的数据。LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。

为日志记录指定的字符串可以包含使用括号括起来的索引，用于指示在记录字符串之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.info("here is some channel info {0} and {1}", 15.4, true);
           // This will log the following String:
      //   "here is some channel info 15.4 and true"
log()方法 
public function log(level:int, message:String, ... rest):void

在给定级别记录指定数据。

为日志记录指定的 String 可以包含使用括号括起来的索引，用于指示在记录 String 之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

level:int — 此信息应使用的记录级别。有效值为 到:
  • LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
  • LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
  • LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
  • LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
  • LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。
  • LogEventLevel.ALL，旨在强制目标处理所有消息。
 
message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.log(LogEventLevel.DEBUG, "here is some channel info {0} and {1}", LogEventLevel.DEBUG, 15.4, true);
           // This will log the following String as a DEBUG log message:
      //   "here is some channel info 15.4 and true"
warn()方法 
public function warn(message:String, ... rest):void

使用 LogEventLevel.WARN 级别记录指定的数据。LogEventLevel.WARN，指示会对应用程序运行造成损害的事件。

为日志记录指定的字符串可以包含使用括号括起来的索引，用于指示在记录字符串之前应该插入哪个附加参数。例如，当使用 10 和 15 作为参数进行调用时，“第一个附加参数是 {0}，第二个附加参数是 {1}”将转化为“第一个附加参数是 10，第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用示例 
// Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.warn("here is some channel info {0} and {1}", 15.4, true);
           // This will log the following String:
      //   "here is some channel info 15.4 and true"



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00