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