mx.logging.AbstractTarget (ActionScript 3.0)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		filters : Array 除了 level 设置外，滤镜还可用于提供伪层次结构映射，以便仅处理那些给定类别的事件。	AbstractTarget
		id : String [] 提供对此目标的 ID 的访问。	AbstractTarget
		level : int 提供对此目标的当前设置级别的访问。	AbstractTarget
		prototype : Object [] 对类或函数对象的原型对象的引用。	Object

	方法	定义方
		AbstractTarget() 构造函数。	AbstractTarget
		addLogger(logger:ILogger):void 使用指定的记录程序设置此目标。	AbstractTarget
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 在创建了实现对象、并分配了标签上指定的所有属性后调用。	AbstractTarget
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		logEvent(event:LogEvent):void 此方法处理相关记录程序中的 LogEvent。	AbstractTarget
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeLogger(logger:ILogger):void 阻止此目标接收来自指定记录程序的事件。	AbstractTarget
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

filters

属性

filters:Array []

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

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

实现
public function get filters():Array
public function set filters(value:Array):void

示例
如何使用示例

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

属性

id:String []

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

实现
public function get id():String

level

属性

level:int []

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

LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。
LogEventLevel.ALL，旨在强制目标处理所有消息。

实现
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。

包	mx.logging
Class	public class AbstractTarget
继承	AbstractTarget Object
Implements	ILoggingTarget, IMXMLObject
Subclasses	LineFormattedTarget