Flex日志详解


原文：http://yunzhongxia.iteye.com/blog/1150218

log4j对于java开发者最熟悉不过了，log4j不仅可以控制日志输出的目的地，还可以控制日志输出级别，便于调试和发布，一个好的产品需要记录很多日志便于日后的维护，尤其是产品上线之后。

在Flex中也提供了这样的一个框架，Logging API就是最基本的日志控制框架，只不过大部分的人都在用最简单的trace()函数罢了，类似于js开发常用的alert。

Logging API不仅提供了最基本的trace功能，还提供了log target，也就是输出的方式，还提供了destination目的地的配置功能。我们可以根据日志范围过滤掉一些信息。除此之外还可以进行自定义log target，对框架进行扩展，例如我们可以把log信息输出到服务器端或者Alcon等。


下面先来看下Logging API主要类的UML关系图。





LogLogger： 提供了发送log到一个特定target，它实现了ILogger接口。










AbstractTarget：定义了日志的输出地。TraceTarget就是将log输出到trace()函数输出的文件中，也就是flashlog.txt文件中，很多时候我们需要扩展日志输出地满足架构的需求，因为flashlog文件有大小限制，而且输出的日志会覆盖上次的日志。







LogEventLevel：定义了当前系统可输出的日志级别。

如下表所示。如果现在的level是ALL，那么系统中所有的日志都会被输出。如果是INFO，那么高于INFO的DEBUG信息就不会被输出。一般开发测试的时候级别为DEBUG或者INFO，上线之后调整为ERROR。另外，注意一点FATAL的值为1000，很符合扩展性的需求。这种设计理念在实际项目中经常会用到。









log target 过滤filters

logTarget.filters=["mx.rpc.*","mx.messaging.*"];

这个例子中就是指定了我们要输出日志的类和包。只有在mx.rpc和mx.messaging包下的类才能输出log，忽略其他的。也可以是mxml形式：





Java代码


<mx:TraceTarget id="logTarget" includeDate="true" includeTime="true"
includeCategory="true" includeLevel="true">
<mx:filters>
<mx:Array>
<mx:String>mx.rpc.*</mx:String>
<mx:String>mx.messaging.*</mx:String>
</mx:Array>
</mx:filters>
<!-- 0 is represents the LogEventLevel.ALL constant. -->
<mx:level>0</mx:level>
</mx:TraceTarget>



参数介绍

includeDate="true",输出的log带日期

includeTime="true", 输出的log带时间

includeCategory="true",输出的log带分类信息，也就是哪个类或者控件输出的log

includeLevel="true"，输出的log是否带level信息，如[INFO],[DEBUG]等。



Flex提供的log功能如此强大，你是不是想跃跃欲试呢？但是flash并不是那么“完美”，需要完美做以下工作才可以进行log实战。

Flex的日志可以分为前端日志和后端日志，我们先来了解下前端日志。



logging日志文件。



首先要配置mm.cfg文件，如果没有可以自己创建一个，该文件根据操作系统的不同位置也会不同，详见下表格






在mm.cfg文件中写入：



Java代码


ErrorReportingEnable=1
TraceOutputFileEnable=1
MaxWarnings=0



ErrorReportingEnable

如果值为1，则在导出文件中写入错误报告。默认值为0

MaxWarnings

写入到log文件中的最大的错误条数。如果希望不限制错误条数，将其值设置为0即可

TraceOutputFileEnable

值为1则将trace内容导出到log文件

TraceOutputFileName

导出的log文件的路径和文件名，如果不定义，则会将log内容写入到mm.cfg文件相同目录下的flashlog.txt





配置完mm.cfg文件后，会自动根据TraceOutputFileName生成一个日志文件，默认路径详见下表格：










日志文件配置完毕，我们就可以测试了，但是我们先来了解下几种记录日志的方法。

(1) Flex Trace
我们可以直接在代码中使用Trace方法向FlashLog.txt文件输出log消息。但Trace只能在Flash Debug Player中执行，客户的电脑上一般不是Debug版本，因此最好少用甚至不用Flex Trace来记录日志为好。

(2) FlashTracer Firefox Plugin
这是一个相当好用的Firefox插件，可以在Firefox浏览器中实时跟踪log输出，非常利于调试。缺点就是必须用火狐浏览器进行测试，与浏览器耦合性比较大。

(3) Flex Logging API
Flex 提供了一套非常好用的Logging API， 分别在SDK包mx.logging, mx.logging.target和mx.logging.error下。有兴趣的朋友可以去Adobe LiveDoc了解一下其详细用法。



下面是一个简单的测试例子：



Java代码


<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" creationComplete="init()"
xmlns:mx="library://ns.adobe.com/flex/mx" minWidth="955" minHeight="600">
<fx:Declarations>
<!-- 将非可视元素（例如服务、值对象）放在此处 -->

</fx:Declarations>
<fx:Script>
<![CDATA[
import mx.logging.LogLogger;
import mx.logging.ILogger;
import mx.logging.Log;
import mx.logging.LogEventLevel;
import mx.logging.targets.TraceTarget;
private var logger:ILogger;
private function init():void{
var logTarget:TraceTarget = new TraceTarget();
logger = new LogLogger("testlog");
logTarget.filters = ["*"];
logTarget.level = LogEventLevel.ALL;
logTarget.includeCategory = true;
logTarget.includeDate = true;
logTarget.includeLevel = true;
logTarget.includeTime = true;
logTarget.addLogger(logger);
Log.addTarget(logTarget);
//trace("create complete");
}
private function clickBtn():void{
logger.debug("It's the debug");
logger.info("It's the info");
logger.warn("It's the warn");
logger.error("It's the error");
logger.fatal("It's the fatal");

trace("ceshi dasdasd我来侧四下");
//trace("It's the first click on btn");
}

]]>
</fx:Script>
<mx:Button id="btn" label="OK" click="clickBtn()"/>
</s:Application>





输入结果如下：