上位機軟件開發---基於Log4Net實現日誌信息存儲至數據庫

1、引言

      在上位機開發中,日誌記錄是必不可少的,我們可以通過日誌記錄做日誌分析及錯誤追蹤。初學者會採用txt文本寫入來實現日誌保存,但是文本寫入不是線程安全,當存在多個線程同時寫入日誌時,就會出現一些問題。Log4net庫是.Net下一個非常優秀的開源日誌記錄組件,是一個幫助開發者將日誌信息輸出到各種目標(控制檯、文件、數據庫等)的工具。本節主要採用開源組件Log4Net來實現錯誤ERROR信息文本存儲,並結合SQLite數據庫,將日誌INFO信息存儲到數據庫中,便於後續的查詢。

2、開發準備

  • 首先新建一個Windows窗體應用,取名爲thinger.cn.Log4NetSQLitePro,UI界面設計如下所示:

 

 

  • 通過Nuget添加Log4Net開源組件,如下所示:

 

 

  • 通過Nuget添加SQLite組件,如下所示:

 

 

3、文本存儲

一般情況下,我們可以將一些錯誤及異常信息存儲在文本中,便於隨時打開文件進行查詢,文本存儲將自動以天爲單位,每天對應一個文件,步驟如下:

  • 添加一個應用程序配置文件

    項目右擊添加新建項,項目類型選擇應用程序配置文件,名稱爲log4net.config,如下所示:

 

 

  • 配置文件編寫

    日誌配置文件增加相關節點,如下所示:

 

 配置文件規定了日誌信息的相關屬性、存儲方式、日誌內容格式等,配置信息如下所示:

 

 其中,較爲重要的是日誌信息的格式,對應上面文件中的ConversionPattern,值爲"[%d]%n%m%n%n",每個佔位符有對應的含義,如下所示:

 

 

  • 配置文件屬性中的複製到輸出目錄,設置爲始終複製或如果較新則複製,如下圖所示:

 

 

  • 項目的AssemblyInfo.cs類中添加一行代碼,如下所示:

 

 

  • 添加一個LogHelper類,編寫2個Error的方法,如下所示:

 

 

  • 在ini文本存儲按鈕事件下,調用錯誤日誌寫入,如下所示:

 

 執行完成後,在項目目錄,Log\Error目錄下,產生一條當天日誌命名的文件,打開如下所示

 

 

4、SQLite存儲

 

日誌信息存儲到數據庫的好處在於便於用戶通過界面進行查詢,這裏採用開源免費數據庫SQLite,其他關係型數據庫,如SQLServer、mysql,原理都是一樣的,具體步驟如下所示:

  • 創建數據庫及數據表

    通過SQLiteStudio軟件創建一個數據庫,取名爲Log4NetSQLite,執行以下腳本創建一個Log數據表:

 

 

  • 將數據庫文件複製到項目根目錄下的DataBase文件夾中

  • 修改log4net.config文件,增加數據庫存儲相關配置,如下所示:

 

 

bufferSize:日誌緩存寫入條數 設置爲0時只要有一條就立刻寫到數據庫

connectionString:SQLite指向的是數據庫文件的絕對路徑

  • LogHelper類中增加一個Info方法,如下所示:

 

  • 在SQLite存儲按鈕事件下,調用Info日誌寫入,如下所示:

 

 

  • 執行完成後,打開數據庫,查看是否有相關記錄:

 

 

5、實際應用

     通過上面一系列的描述,相信大家對Log4Net的應用有了一些瞭解,Log4Net構建的日誌系統是很多項目必備的一個功能,對項目開發、調試及後續維護都有着至關重要的作用。實際使用時,我們還可以將Log4Ne作爲一個簡單的數據存儲工具,甚至可以使用Log4Net做多表多庫存儲。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章