包mx.logging
类public class Log
继承Log Inheritance Object

为伪层次结构日志记录功能提供多种格式和输出选项。日志系统包含两个主要组件：记录程序和目标。您可以使用记录程序向目标发送信息。目标负责设置日志数据的格式，以及日志数据的一般性输出。

记录程序是为特殊类别的信息创建的 singleton 实例。通常，类别是希望记录信息的组件的包名称。通过类别，用户可以指定自己感兴趣的日志信息。您可以选择多个类别并使用正则表达式将其合并。这样可以扩大或缩小获取的日志记录信息的范围。例如，您也许对“mx.messaging”和“mx.rpc”包下的所有日志信息感兴趣，并希望这些包中的内容的输出格式为 XML。要获得“mx.messaging”类别（包括子包和组件）下的所有日志信息，则需要通配符表达式，如“mx.messaging.*". 有关更多详细信息，请参阅下文中的代码示例。

目标提供记录的数据的输出机制。此机制通常包括格式设置、传输或存储，但可以是 VM 下的任何内容。提供了两个目标：MiniDebugTarget 和 TraceTarget。其中的每个写入程序都获取当前日志信息并将其“发送”到某个位置进行显示和/或存储。目标还为要输出哪些日志数据提供了规范。

另请参见

Using the logging API

公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
addTarget(target:ILoggingTarget):void
[静态] 允许指定的目标开始接收日志事件的通知。
Log
  
flush():void
[静态] 此方法将从缓存中删除当前的所有记录程序。
Log
  
getLogger(category:String):ILogger
[静态] 返回与指定类别关联的记录程序。
Log
  
hasIllegalCharacters(value:String):Boolean
[静态] 此方法检查指定的字符串值中是否存在非法字符。
Log
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
  
isDebug():Boolean
[静态] 指示日志目标是否会处理调试级别的日志事件。
Log
  
isError():Boolean
[静态] 指示日志目标是否处理错误级别的日志事件。
Log
  
isFatal():Boolean
[静态] 指示日志目标是否处理严重级别的日志事件。
Log
  
isInfo():Boolean
[静态] 指示日志目标是否处理信息级别的日志事件。
Log
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
isWarn():Boolean
[静态] 指示日志目标是否处理警告级别的日志事件。
Log
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
  
removeTarget(target:ILoggingTarget):void
[静态] 停止指定的目标接收日志事件的通知。
Log
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
方法详细信息
addTarget()方法
public static function addTarget(target:ILoggingTarget):void

允许指定的目标开始接收日志事件的通知。

参数

target:ILoggingTarget — 应该捕获日志事件的特定目标。

flush()方法 
public static function flush():void

此方法将从缓存中删除当前的所有记录程序。随后，将调用 getLogger() 方法返回记录程序的新实例，而不会返回先前的任何同类别实例。此方法仅适用于调试。

getLogger()方法 
public static function getLogger(category:String):ILogger

返回与指定类别关联的记录程序。如果给定的类别不存在，则返回新的记录程序实例，并将其与该类别关联。类别必须至少有一个字符的长度，并且可能不允许包含任何空白或下列任一字符：[]~$^&\/(){}<>+=`!#%?,:;'"@ 如果指定的类别格式错误，则此方法将引发 InvalidCategoryError。

参数

category:String — 应该返回的记录程序的类别。

返回
ILogger — 指定名称的记录程序对象的实例。如果此名称不存在，则返回使用此指定名称的新实例。
hasIllegalCharacters()方法 
public static function hasIllegalCharacters(value:String):Boolean

此方法检查指定的字符串值中是否存在非法字符。

参数

value:String — 要从中检查非法字符的 String。下列字符为非法字符：[]~$^&\/(){}<>+=`!#%?,:;'"@

返回
Boolean — 若发现任何非法字符，则为 true；否则，为 false
isDebug()方法 
public static function isDebug():Boolean

指示日志目标是否会处理调试级别的日志事件。

返回
Boolean — 如果记录调试级别的日志事件，则为 true；否则，为 false。
isError()方法 
public static function isError():Boolean

指示日志目标是否处理错误级别的日志事件。

返回
Boolean — 如果记录错误级别的日志事件，则为 true；否则，为 false。
isFatal()方法 
public static function isFatal():Boolean

指示日志目标是否处理严重级别的日志事件。

返回
Boolean — 如果记录严重级别的日志事件，则为 true；否则，为 false。
isInfo()方法 
public static function isInfo():Boolean

指示日志目标是否处理信息级别的日志事件。

返回
Boolean — 如果记录信息级别的日志事件，则为 true；否则，为 false。
isWarn()方法 
public static function isWarn():Boolean

指示日志目标是否处理警告级别的日志事件。

返回
Boolean — 如果记录警告级别的日志事件，则为 true；否则，为 false。
removeTarget()方法 
public static function removeTarget(target:ILoggingTarget):void

停止指定的目标接收日志事件的通知。

参数

target:ILoggingTarget — 应该捕获日志事件的特定目标。




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