這里以日志組件XLog作為開頭，不再以專門的概要或者目錄說明開始，體現新生命開發團隊組件體系的基本思想——追求實用，一切從簡！

    我寫文檔資料向來行文自如，沒有統一的格式。基本上標題是粗體二號居中，正文是小四，段落首行縮進2字符，行間距1.5倍。我比較喜歡上彩色的代碼，因為那樣閱讀起來非常舒服，有時候干脆直接用代碼截圖替代。

    就讓我們從日志組件XLog開始吧！

    XLog是組件體系里面最最簡單的一個組件，簡單到只有“一個類一個方法”，也就是經常見到的XTrace.WriteLine。顧名思義，它的用途就是向日志文件輸出一行日志！

    可千萬別小看這個功能，它有著非常重要的地位，基本上每一個基礎組件都依賴于它。而它從來不參與業務（寫日志文件跟業務實在扯不上關系），也就是說即使把它的調用代碼從各個組件中移去，也不會影響組件的工作。

    基本上，我們可以把XLog視為系統守護神，原因有如下幾點：

    1，在組件和應用系統程序中拋出日志，記錄系統運行狀況。由于ASP.Net、WinForm、Service和組件等程序的多樣性，導致了沒有統一的向界面展現運行狀況的功能（廢話，Service和組件根本就沒有UI），而寫日志文件，則是通用的。

    2，在設計中，我喜歡多留幾手。比如在ASP.Net中，建議實現Global.asa的OnError，把那些未處理異常信息通過XLog寫入到本地日志中。經常，客戶說報錯的時候，作為開發人員，基本上不可能到第一現場觀察錯誤提示，這也導致了異常定位非常的困難，大大增加了維護的成本。使用日志后，一旦某個頁面出錯，即使客戶沒有反饋，系統也能記錄下來，為管理員修正錯誤以及優化系統提供足夠豐富的信息。

    3，XTrace有兩個WriteLine方法，可別因為它們跟String.Format一樣。而實際上也差不多，只不過支持格式化的WriteLine對時間類型的參數做了一些特殊處理。

    4，XTrace的Debug屬性就對應著AppConfig配置項的Debug項，本身沒有任何用途，只是為其它程序提供是否工作在調試狀態下做準備。

    5，XTrace的DebugStack主要用于控件開發的事件中，輸出當前方法調用樹。

    6，XTrace的OnWriteLog事件可以改變寫日志的行為。XLog默認把日志寫到文本文件中，當掛接OnWriteLog事件后，就變為有外部決定。最常用的就是控制臺程序把日志重定向到控制臺，WinForm程序把日志重定向到日志窗口。

    7，當然，XLog還有WriteLogEventArgs類，用于定義寫日志事件。

寫日志還有一個關鍵問題，就是多線程并發問題。如果多個線程都寫日志，怎么辦？寫日志畢竟是IO操作，會不會因為寫日志而影響上層代碼的執行效率？這些都是XLog所經歷過，并且已經解決了的問題。

    XLog作為其它組件的根基，僅僅是提供了寫日志的簡單功能，方便開發調試、運行檢查、錯誤記錄等情況，如果想記錄操作日志，實在不是最佳選擇。

    一個組件，如果單獨出來看技術，那就沒有啥意思了。它還需要有合適的使用方案，才能發揮最大的功效，好馬還需要伯樂呀。后面其它組件的講解，大家將可以看到XLog的重要性！

/Files/nnhy/XLog_20100912113511.rar

大石頭

新生命開發團隊

2010-08-19 01:49