WorldWind源码剖析系列：日志类Log

Utility工程中的日志类Log主要用来输出Debug状态下的调试信息。该类的类图如下：

日志类Log中使用到的类和内嵌结构体类型主要有以下这些：

public class LogEventArgs : EventArgs//日志事件参数

{

public int level;

public string category;

public string message;

public LogEventArgs(int _l, string _c, string _m)

{

level = _l;

category = _c;

message = _m;

}

}

public struct Levels//调试日志等级

{

public static readonly int Error = 0;

public static readonly int Warning = 2;

public static readonly int Debug = 5;

public static readonly int Verbose = 7;

};

日志类Log中主要的字段、属性和方法有：

static StreamWriter logWriter;//日志写盘的流式写入器

static string logPath;//日志路径，默认为“C:\Documents and Settings\Administrator\Application Data\NASA\World Wind\1.4.0.0”

static string logFilePath;//日志文件路径，为logPath+ “WorldWind.log”

public static int Level;//调试日志等级

其中的方法都很简单，不再详细赘述。只简单的说明其中三个常用的日志写出函数：

public static void Write( Exception caught )静态函数在程序中任何不活异常的地方被调用，用来将异常信息以“年月日时分秒.txt”为名称输出到文本文件中，默认的异常日志输出路径为“C:\Documents and Settings\Administrator\Application Data\NASA\World Wind\1.4.0.0”。

public static void DebugWrite( Exception caught ) 静态函数与public static void Write( Exception caught )静态函数功能一样，只不过是党程序处于Debug状态时才写出异常信息。

public static void Write(int level, string category, string message) 静态函数只将日志等级<= Log.Level(4或6)的日志写入到WorldWind.log文件中去。

下图是日志类Log在调试状态下向Output控制台输出日志信息的截屏。