mx.logging
public class AbstractTarget
继承AbstractTarget Inheritance Object
实现 ILoggingTarget, IMXMLObject
子类 LineFormattedTarget

该类提供目标实现的日志记录框架所需的基本功能。它处理滤镜表达式验证,并提供默认级别属性。未提供 logEvent() 方法的实现。



公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  filters : Array
除了 level 设置外,滤镜还可用于提供伪层次结构映射,以便仅处理那些给定类别的事件。
AbstractTarget
  id : String
[只读 (read-only)] 提供对此目标的 ID 的访问。
AbstractTarget
  level : int
提供对此目标的当前设置级别的访问。
AbstractTarget
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
构造函数。
AbstractTarget
  
使用指定的记录程序设置此目标。
AbstractTarget
 Inherited
指示对象是否已经定义了指定的属性。
Object
  
在创建了实现对象、并分配了标签上指定的所有属性后调用。
AbstractTarget
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
此方法处理相关记录程序中的 LogEvent。
AbstractTarget
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
  
阻止此目标接收来自指定记录程序的事件。
AbstractTarget
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
filters属性
filters:Array  [读写]

除了 level 设置外,滤镜还可用于提供伪层次结构映射,以便仅处理那些给定类别的事件。

每个记录程序都属于一个类别。一般而言,这些类别将映射到使用记录程序的 fully-qualified 类名称。例如,记录 mx.rpc.soap.WebService 类的消息的记录程序使用“mx.rpc.soap.WebService”作为 Log.getLogger() 方法调用的参数。当发送此类别的消息时,只有拥有与该类别匹配的滤镜的那些目标才能接收这些事件的通知。滤镜表达式可以包括通配符,用星号表示。通配符必须是表达式中最右端的字符。例如:rpc*、mx.*, 或者 *. 如果指定的表达式无效,将引发 InvalidFilterError。如果指定了 null 或 [],则滤镜将设置为默认值 ["*"]。

例如:

var traceLogger:ILoggingTarget = new TraceTarget();
               traceLogger.filters = ["mx.rpc.*", "mx.messaging.*"];
               Log.addTarget(traceLogger);



实现
    public function get filters():Array
    public function set filters(value:Array):void
id属性 
id:String  [只读 (read-only)]

提供对此目标的 ID 的访问。如果将 ID 用作 mxml 标签,则会在运行时由 mxml 编译器分配;如果在脚本块中使用,则在内部分配。



实现
    public function get id():String
level属性 
level:int  [读写]

提供对此目标的当前设置级别的访问。有效值包括:



实现
    public function get level():int
    public function set level(value:int):void
构造函数详细信息
AbstractTarget()构造函数
public function AbstractTarget()

构造函数。

方法详细信息
addLogger()方法
public function addLogger(logger:ILogger):void

使用指定的记录程序设置此目标。这样,此目标就可以接收来自指定记录程序的日志事件。

参数

logger:ILogger — 此目标应该侦听的 ILogger。

initialized()方法 
public function initialized(document:Object, id:String):void

在创建了实现对象、并分配了标签上指定的所有属性后调用。

参数

document:Object — 创建此对象的 MXML 文档。
 
id:String — 文档用于引用此对象。如果该对象是文档上的深层属性,则 id 为 null。

logEvent()方法 
public function logEvent(event:LogEvent):void

此方法处理相关记录程序中的 LogEvent。目标使用此方法将事件转换为相应格式以便进行传输、存储或显示。仅当事件的级别在目标的级别范围内时才调用此方法。

注意:后代必须覆盖此方法才能使其发挥作用。

参数

event:LogEvent — 相关记录程序中的事件。

removeLogger()方法 
public function removeLogger(logger:ILogger):void

阻止此目标接收来自指定记录程序的事件。

参数

logger:ILogger — 此目标应该忽略的 ILogger。