ILogNet 接口

public interface ILogNet : IDisposable

Public Interface ILogNet
	Inherits IDisposable

public interface class ILogNet : IDisposable

type ILogNet =  
    interface
        interface IDisposable
    end

// 实例化一个日志后，就可以使用了
ILogNet logNet = new LogNetSingle( "D:\\123.txt" );

// 实例化一个日志后，路径是D的一个文件夹，大小为2M
ILogNet logNet = new LogNetFileSize( "D:\\Logs", 2 * 1024 * 1024 );

// 实例化一个日志后，路径是D的一个文件夹，按照每天的规律来存储
ILogNet logNet = new LogNetDateTime( "D:\\Logs", GenerateMode.ByEveryDay );

// 然后我们的代码就可以调用下面的方法来存储日志了，支持下面的5个等级的
logNet.WriteDebug( "Debug log test" );
logNet.WriteInfo( "Info log test" );
logNet.WriteWarn( "Warn log test" );
logNet.WriteError( "Error log test" );
logNet.WriteFatal( "Fatal log test" );

// 还有下面的几种额外的情况
logNet.WriteNewLine( );                       // 追加一行空行
logNet.WriteDescrition( "test" );             // 写入额外的注释的信息
logNet.WriteAnyString( "any string" );        // 写任意的数据，不受格式化影响

// 此处的5个等级有高低之分 debug < info < warn < error < fatal < all
// 如果我们需要屏蔽debug等级的话
logNet.SetMessageDegree( HslMessageDegree.INFO );

// 如果我们需要屏蔽debug及info等级的
logNet.SetMessageDegree( HslMessageDegree.WARN );

// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += (object sender, HslEventArgs e) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );
};

// 带关键字的功能
logNet.WriteDebug( "A","Debug log test" );
logNet.WriteInfo( "B", "Info log test" );
logNet.WriteWarn( "C", "Warn log test" );
logNet.WriteError( "A", "Error log test" );
logNet.WriteFatal( "B", "Fatal log test" );

// 有了关键字之后，我们就可以根据关键字过滤了
logNet.FiltrateKeyword( "B" ); // 我们不需要B的关键字的日志
logNet.RemoveFiltrate( "B" );  // 重新需要B的关键字的日志

// 日志记录时默认获取当前系统的时间，如果需要在记录日志时，所有的时间往后加8小时，则可以这么设置（如果往前，就是负数）
logNet.HourDeviation = 8;

// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );

    // 我们接下来举个例子，所有的日志都不存储文件
    e.HslMessage.Cancel = true;
};

// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );

    // 我们接下来举个例子，只有错误(ERROR)的等级才存储文件
    if (e.HslMessage.Degree != HslMessageDegree.ERROR)
    {
        // 这样的操作就导致，不是ERROR等级，全部不存储。但是不影响触发控制台输出
        e.HslMessage.Cancel = true;
    }
};

// 实例化一个日志后，如果不指定路径，那就不会存储文件，但仍然会触发BeforeSaveToFile事件
ILogNet logNet = new LogNetSingle( "" );

// 所有的日志在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );
};

private void FormLogNet_Load( object sender, EventArgs e )
{
    logNet = new LogNetSingle( "log.txt" ); 
    // logNet = new LogNetDateTime( Path.Combine( AppDomain.CurrentDomain.BaseDirectory, "Logs" ), GenerateMode.ByEveryDay, 10 );
    comboBox1.DataSource = HslCommunication.BasicFramework.SoftBasic.GetEnumValues<HslMessageDegree>( );
    comboBox1.SelectedItem = HslMessageDegree.DEBUG;
    comboBox2.DataSource = HslCommunication.BasicFramework.SoftBasic.GetEnumValues<HslMessageDegree>( );
    comboBox2.SelectedItem = HslMessageDegree.DEBUG;
    comboBox2.SelectedIndexChanged += ComboBox2_SelectedIndexChanged;

    logNet.FiltrateKeyword( "123" );  // 过滤关键字123的存储
    logNet.BeforeSaveToFile += LogNet_BeforeSaveToFile;
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;

    if (Program.Language == 2)
    {
        label1.Text = "Log Degree:";
        label6.Text = "Save Degree:";
        label2.Text = "Time Offset:";
        button_hour_offset.Text = "Set";
        label3.Text = "KeyWord:";
        checkBox1.Text = "Cancel Save?";
        label4.Text = "Message:";
        button3.Text = "Load File";
        button4.Text = "Clear File";
        button8.Text = "LogViewer";
        label5.Text = "Content:";
        label9.Text = "Code:";

        button1.Text = "w-Message";
        button5.Text = "w-NewLine";
        button6.Text = "w-Description";
        button7.Text = "w-Exception";
        button9.Text = "Raise Exception";
    }

    textBox_code.Text = $"ILogNet logNet = new LogNetSingle( \"log.txt\" );  // 如果传入 string.Empty 则不存文件";
}

private void CurrentDomain_UnhandledException( object sender, UnhandledExceptionEventArgs e )
{
    if(e.ExceptionObject is Exception ex)
    {
        logNet?.WriteException( "UnhandledException", ex );
    }
}

private void LogNet_BeforeSaveToFile( object sender, HslEventArgs e )
{
    e.HslMessage.Cancel = checkBox1.Checked;
}

private void ComboBox2_SelectedIndexChanged( object sender, EventArgs e )
{
    HslMessageDegree degree = (HslMessageDegree)comboBox2.SelectedItem;
    logNet.SetMessageDegree( degree );
}

private ILogNet logNet;               // 日志

private void button1_Click( object sender, EventArgs e )
{
    // 写日志
    HslMessageDegree degree = (HslMessageDegree)comboBox1.SelectedItem;

    // 两种方法，第一种
    logNet.RecordMessage( degree, textBox1.Text, textBox2.Text );

    // 第二种
    //if(degree == HslMessageDegree.DEBUG)
    //{
    //    logNet.WriteDebug( textBox1.Text, textBox2.Text );
    //}
    //else if(degree == HslMessageDegree.INFO)
    //{
    //    logNet.WriteInfo( textBox1.Text, textBox2.Text );
    //}
    //else if(degree == HslMessageDegree.WARN)
    //{
    //    logNet.WriteWarn( textBox1.Text, textBox2.Text );
    //}
    //else if (degree == HslMessageDegree.ERROR)
    //{
    //    logNet.WriteError( textBox1.Text, textBox2.Text );
    //}
    //else if (degree == HslMessageDegree.FATAL)
    //{
    //    logNet.WriteFatal( textBox1.Text, textBox2.Text );
    //}

    textBox_code.Text = $"logNet.RecordMessage( HslMessageDegree.{degree}, \"{textBox1.Text}\", \"{textBox2.Text}\" );";
}

private void button5_Click( object sender, EventArgs e )
{
    logNet.WriteNewLine( );

    textBox_code.Text = "logNet.WriteNewLine( );";
}

private void button6_Click( object sender, EventArgs e )
{
    logNet.WriteDescrition( textBox2.Text );

    textBox_code.Text = $"logNet.WriteDescrition( \"{textBox2.Text}\" );";
}

private void button7_Click( object sender, EventArgs e )
{
    try
    {
        int i = 0;
        int j = 100 / i;
    }
    catch(Exception ex)
    {
        logNet.WriteException( textBox1.Text, ex );

        textBox_code.Text = $"logNet.WriteException( \"{textBox1.Text}\", ex );";
    }
}

private int threadCount = 3;
private void button2_Click( object sender, EventArgs e )
{
    threadCount = 3;
    // 100万条日志写入测试
    for (int i = 0; i < threadCount; i++)
    {
        new System.Threading.Thread( new System.Threading.ThreadStart( ThreadLogTest ) )
        {
            IsBackground = true,
        }.Start( );
    }

    button2.Enabled = false;
}

private void ThreadLogTest()
{
    DateTime start = DateTime.Now;
    for (int i = 0; i < 330000; i++)
    {
        logNet.WriteInfo( "key", "这是一条测试日志" );
    }

    TimeSpan ts = DateTime.Now - start;

    if (Interlocked.Decrement(ref threadCount) == 0)
    {
        Invoke( new Action( ( ) =>
        {
            MessageBox.Show( "完成！耗时：" + ts.TotalMilliseconds.ToString( "F3" ) + " 毫秒" );
            button2.Enabled = true;
        } ) );
    }
}

private void button3_Click( object sender, EventArgs e )
{
    if (System.IO.File.Exists( "log.txt" ))
    {
        // 显示日志信息
        using (System.IO.StreamReader sr = new System.IO.StreamReader( "log.txt", Encoding.UTF8 ))
        {
            textBox3.Text = sr.ReadToEnd( );
        }
    }
    else
    {
        MessageBox.Show( StringResources.Language.FileNotExist );
    }

    textBox_code.Text = $"string content = File.ReadAllText( \"log.txt\", Encoding.UTF8 );";
}