264 lines
10 KiB
VB.net
264 lines
10 KiB
VB.net
#Region "Microsoft.VisualBasic::99634e02bd3bb723482cefb5aa8536d9, Microsoft.VisualBasic.Core\ApplicationServices\Debugger\Logging\LogFile\LogFile.vb"
|
||
|
||
' Author:
|
||
'
|
||
' asuka (amethyst.asuka@gcmodeller.org)
|
||
' xie (genetics@smrucc.org)
|
||
' xieguigang (xie.guigang@live.com)
|
||
'
|
||
' Copyright (c) 2018 GPL3 Licensed
|
||
'
|
||
'
|
||
' GNU GENERAL PUBLIC LICENSE (GPL3)
|
||
'
|
||
'
|
||
' This program is free software: you can redistribute it and/or modify
|
||
' it under the terms of the GNU General Public License as published by
|
||
' the Free Software Foundation, either version 3 of the License, or
|
||
' (at your option) any later version.
|
||
'
|
||
' This program is distributed in the hope that it will be useful,
|
||
' but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
' MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
' GNU General Public License for more details.
|
||
'
|
||
' You should have received a copy of the GNU General Public License
|
||
' along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
|
||
|
||
' /********************************************************************************/
|
||
|
||
' Summaries:
|
||
|
||
' Class LogFile
|
||
'
|
||
' Properties: FileName, FilePath, NowTimeNormalizedString
|
||
'
|
||
' Constructor: (+1 Overloads) Sub New
|
||
'
|
||
' Function: Read, ReadLine, (+3 Overloads) Save, SaveLog, SystemInfo
|
||
' ToString
|
||
'
|
||
' Sub: (+2 Overloads) Dispose, (+2 Overloads) LogException, (+4 Overloads) WriteLine
|
||
'
|
||
'
|
||
' /********************************************************************************/
|
||
|
||
#End Region
|
||
|
||
Imports System.IO
|
||
Imports System.Runtime.CompilerServices
|
||
Imports System.Text
|
||
Imports Microsoft.VisualBasic.ComponentModel
|
||
Imports Microsoft.VisualBasic.Language
|
||
Imports Microsoft.VisualBasic.Parallel
|
||
Imports Microsoft.VisualBasic.Terminal.STDIO__
|
||
Imports Microsoft.VisualBasic.Text
|
||
|
||
Namespace ApplicationServices.Debugging.Logging
|
||
|
||
''' <summary>
|
||
''' 日志文件记录模块。因为在Linux平台上面，Windows的日志记录API可能不会正常工作，
|
||
''' 所以需要这个日志模块来接替Windows的日志模块的工作
|
||
''' </summary>
|
||
''' <remarks>
|
||
''' 这个类模块将输入的信息格式化保存到文本文件之中，记录的信息包括信息头，消息文本，以及消息等级
|
||
''' </remarks>
|
||
Public Class LogFile : Implements IFileReference
|
||
Implements ISaveHandle
|
||
Implements IDisposable
|
||
Implements I_ConsoleDeviceHandle
|
||
|
||
Dim buffer As TextWriter
|
||
Dim counts&
|
||
|
||
''' <summary>
|
||
''' 没有路径名称和拓展名，仅包含有单独的文件名
|
||
''' </summary>
|
||
''' <value></value>
|
||
''' <returns></returns>
|
||
''' <remarks></remarks>
|
||
Public ReadOnly Property FileName As String
|
||
Get
|
||
Return FilePath.BaseName
|
||
End Get
|
||
End Property
|
||
|
||
''' <summary>
|
||
''' 将时间字符串里面的":"符号去除之后，剩余的字符串可以用于作为路径来使用
|
||
''' </summary>
|
||
''' <value></value>
|
||
''' <returns></returns>
|
||
''' <remarks></remarks>
|
||
Public Shared ReadOnly Property NowTimeNormalizedString As String
|
||
Get
|
||
Return $"{Format(Now.Month, "00")}{ Format(Now.Day, "00")}{Format(Now.Hour, "00")}{Format(Now.Minute, "00")}{Format(Now.Second, "00")}"
|
||
End Get
|
||
End Property
|
||
|
||
Public Property FilePath As String Implements IFileReference.FilePath
|
||
|
||
''' <summary>
|
||
'''
|
||
''' </summary>
|
||
''' <param name="Path">This logfile will saved to.</param>
|
||
''' <remarks></remarks>
|
||
''' <param name="bufferSize">当日志的记录数目达到这个数目的时候就会将日志数据写入到文件之中</param>
|
||
Public Sub New(Path As String, Optional AutoFlush As Boolean = True, Optional bufferSize As Integer = 1024)
|
||
Dim file As New FileStream(Path, FileMode.Append)
|
||
|
||
buffer = New StreamWriter(file, Encoding.UTF8, bufferSize) With {
|
||
.AutoFlush = AutoFlush
|
||
}
|
||
buffer.WriteLine($"//{vbTab}[{Now.ToString}]{vbTab}{New String("=", 25)} START WRITE LOGGING SECTION {New String("=", 25)}" & vbCrLf)
|
||
FilePath = FileIO.FileSystem.GetFileInfo(Path).FullName
|
||
End Sub
|
||
|
||
Public Sub LogException(Msg As String, <CallerMemberName> Optional Object$ = Nothing)
|
||
Call WriteLine(Msg, [Object], Type:=MSG_TYPES.ERR)
|
||
End Sub
|
||
|
||
Public Sub LogException(ex As Exception)
|
||
Call WriteLine(ex.ToString, "", Type:=MSG_TYPES.ERR)
|
||
End Sub
|
||
|
||
''' <summary>
|
||
''' 向日志文件之中写入数据
|
||
''' </summary>
|
||
''' <param name="Msg"></param>
|
||
''' <param name="[Object]"></param>
|
||
''' <param name="Type"></param>
|
||
Public Sub WriteLine(Msg As String, [Object] As String, Optional Type As MSG_TYPES = MSG_TYPES.INF)
|
||
Dim LogEntry As New LogEntry With {
|
||
.Msg = Msg,
|
||
.Object = [Object],
|
||
.Time = Now,
|
||
.Type = Type
|
||
}
|
||
|
||
buffer.WriteLine(LogEntry.ToString)
|
||
counts += 1
|
||
End Sub
|
||
|
||
''' <summary>
|
||
''' 会自动拓展已经存在的日志数据
|
||
''' </summary>
|
||
''' <remarks></remarks>
|
||
Private Function SaveLog() As Boolean
|
||
Call buffer.WriteLine(vbCrLf & $"//{vbTab}{New String("=", 25)} END OF LOG FILE {New String("=", 25)}")
|
||
Call buffer.WriteLine(vbCrLf)
|
||
Call buffer.Flush()
|
||
|
||
Return True
|
||
End Function
|
||
|
||
Public Overrides Function ToString() As String
|
||
Return $"[{counts} records]'{FilePath.ToFileURL}'"
|
||
End Function
|
||
|
||
Public Function ReadLine() As String Implements I_ConsoleDeviceHandle.ReadLine
|
||
Return ""
|
||
End Function
|
||
|
||
Public Sub WriteLine(Optional s As String = "") Implements I_ConsoleDeviceHandle.WriteLine
|
||
Call WriteLine(s, Type:=MSG_TYPES.INF, [Object]:="")
|
||
End Sub
|
||
|
||
Public Sub WriteLine(s As String())
|
||
Dim str As String = String.Join(vbCrLf, s)
|
||
Call WriteLine(str, Type:=MSG_TYPES.INF, [Object]:="")
|
||
End Sub
|
||
|
||
''' <summary>
|
||
'''
|
||
''' </summary>
|
||
''' <param name="s"></param>
|
||
''' <param name="args">{[Object] As String, Optional Type As MsgType = MsgType.INF, Optional WriteToScreen As Boolean = True}</param>
|
||
''' <remarks></remarks>
|
||
Public Sub WriteLine(s As String, ParamArray args() As String) Implements I_ConsoleDeviceHandle.WriteLine
|
||
Dim [Object] As String = IIf(String.IsNullOrEmpty(args(0)), "", args(0))
|
||
Call WriteLine(s, Type:=MSG_TYPES.INF, [Object]:=[Object])
|
||
End Sub
|
||
|
||
Public Overloads Function Read() As Integer Implements I_ConsoleDeviceHandle.Read
|
||
Return -1
|
||
End Function
|
||
|
||
''' <summary>
|
||
''' 日志文件在保存的时候默认是追加的方式
|
||
''' </summary>
|
||
''' <param name="FilePath"></param>
|
||
''' <param name="Encoding"></param>
|
||
''' <returns></returns>
|
||
''' <remarks></remarks>
|
||
Public Function Save(FilePath$, Encoding As Encoding) As Boolean Implements ISaveHandle.Save
|
||
FilePath = FilePath Or Me.FilePath.When(FilePath.StringEmpty)
|
||
Return SaveLog()
|
||
End Function
|
||
|
||
''' <summary>
|
||
''' 给出用于调试的系统的信息摘要
|
||
''' </summary>
|
||
''' <returns></returns>
|
||
Public Shared Function SystemInfo() As String
|
||
Dim sBuilder As New StringBuilder(1024)
|
||
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.BuildVersion)}:={OSVersionInfo.BuildVersion}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.Edition)}:={OSVersionInfo.Edition}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.MajorVersion)}:={OSVersionInfo.MajorVersion}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.MinorVersion)}:={OSVersionInfo.MinorVersion}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.WindowsName)}:={OSVersionInfo.WindowsName}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.OSBits)}:={OSVersionInfo.OSBits}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.ProcessorBits)}:={OSVersionInfo.ProcessorBits}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.ProgramBits)}:={OSVersionInfo.ProgramBits}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.RevisionVersion)}:={OSVersionInfo.RevisionVersion}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.ServicePack)}:={OSVersionInfo.ServicePack}")
|
||
Call sBuilder.AppendLine($"{NameOf(OSVersionInfo.Version)}:={OSVersionInfo.Version.ToString}")
|
||
|
||
Return sBuilder.ToString
|
||
End Function
|
||
|
||
Public Function Save(path As String, Optional encoding As Encodings = Encodings.UTF8) As Boolean Implements ISaveHandle.Save
|
||
Return Save(path, encoding.CodePage)
|
||
End Function
|
||
|
||
Public Function Save() As Boolean
|
||
Return Save(FilePath)
|
||
End Function
|
||
|
||
#Region "IDisposable Support"
|
||
Private disposedValue As Boolean ' To detect redundant calls
|
||
|
||
' IDisposable
|
||
Protected Overridable Sub Dispose(disposing As Boolean)
|
||
If Not disposedValue Then
|
||
If disposing Then
|
||
' TODO: dispose managed state (managed objects).
|
||
Call SaveLog()
|
||
End If
|
||
|
||
' TODO: free unmanaged resources (unmanaged objects) and override Finalize() below.
|
||
' TODO: set large fields to null.
|
||
End If
|
||
disposedValue = True
|
||
End Sub
|
||
|
||
' TODO: override Finalize() only if Dispose(disposing As Boolean) above has code to free unmanaged resources.
|
||
'Protected Overrides Sub Finalize()
|
||
' ' Do not change this code. Put cleanup code in Dispose(disposing As Boolean) above.
|
||
' Dispose(False)
|
||
' MyBase.Finalize()
|
||
'End Sub
|
||
|
||
' This code added by Visual Basic to correctly implement the disposable pattern.
|
||
Public Sub Dispose() Implements IDisposable.Dispose
|
||
' Do not change this code. Put cleanup code in Dispose(disposing As Boolean) above.
|
||
Dispose(True)
|
||
' TODO: uncomment the following line if Finalize() is overridden above.
|
||
' GC.SuppressFinalize(Me)
|
||
End Sub
|
||
#End Region
|
||
End Class
|
||
End Namespace
|