AbstractTarget

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

filters

属性

filters:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

除了 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 [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get id():String

level

属性

level:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

LogEventLevel.FATAL (1000)，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR (8)，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN (6)，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO (4)，指示粗略地介绍应用程序进度的说明性消息。
LogEventLevel.DEBUG (2)，指示对调试应用程序大有帮助的精细说明性消息。
LogEventLevel.ALL (0)，旨在强制目标处理所有消息。

实现
public function get level():int
public function set level(value:int):void

构造函数详细信息

()

构造函数

public function AbstractTarget()

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

方法详细信息

addLogger

()

方法

public function addLogger(logger:ILogger):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

initialized

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

	`document:Object` — 创建此对象的 MXML 文档。

	`id:String` — 文档用于引用此对象。如果该对象是文档上的深层属性，则 id 为 null。

logEvent

()

方法

public function logEvent(event:LogEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

参数

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

removeLogger

()

方法

public function removeLogger(logger:ILogger):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

法律声明 | 在线隐私策略

AbstractTarget - AS3 Flex

类 x

filters

id

level

AbstractTarget

addLogger

initialized

logEvent

removeLogger