nanoFramework.Logging 1.1.108

欢迎使用 .NET nanoFramework nanoFramework.Logging 库存储库

构建状态

组件	构建状态	NuGet 包
nanoFramework.Logging
nanoFramework.Logging.Serial
nanoFramework.Logging.Stream
nanoFramework.Logging.Syslog

反馈和文档

有关文档、提供反馈、问题以及了解如何贡献，请参阅此存储库的首页。

加入我们的 Discord 社区这里。

鸣谢

该项目贡献者列表可在CONTRIBUTORS中找到。

许可证

nanoFramework 类库受MIT 许可证的许可。

使用方法

在您的类中，确保您有一个全局 ILogger 声明，并在您的构造函数中调用 _logger = this.GetCurrentClassLogger();

using Microsoft.Extensions.Logging;
using nanoFramework.Logging;
using System;

namespace UnitTestDebugLogging
{
    internal class MyTestComponent
    {
        private ILogger _logger;

        public MyTestComponent()
        {
            _logger = this.GetCurrentClassLogger();
        }

        public void DoSomeLogging()
        {
            _logger.LogInformation("An informative message");
            _logger.LogError("An error situation");
            _logger.LogWarning(new Exception("Something is not supported"), "With exception context");
        }
    }
}

在您的主代码中，您需要创建一个记录器

LogDispatcher.LoggerFactory = new DebugLoggerFactory();
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

您可以有三种不同的记录器类型：调试、串行和流。

调试记录器

如前所述，您可以使用 Factory 模式

LogDispatcher.LoggerFactory = new DebugLoggerFactory();
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

您同样可以直接创建一个 DebugLogger

DebugLogger _logger;
_logger = new DebugLogger("test");
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

串行日志记录器

您可以使用工厂模式

LogDispatcher.LoggerFactory = new SerialLoggerFactory("COM6");
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

注意，您可以根据需要调整波特率和所有其他元素。

或直接使用SerialLogger

SerialPort _serial;
_serial = new SerialPort("COM6", 115200);
SerialLogger _logger = new SerialLogger(ref _serial);
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

重要：请确保参考您板子的文档来了解如何正确设置串行端口。测试中包含了ESP32的示例。

流日志记录器

与之前的类似，您可以使用FileStream或LoggerFactory中的Stream

MemoryStream memoryStream = new MemoryStream();
LogDispatcher.LoggerFactory = new StreamLoggerFactory(memoryStream);
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

你同样可以直接使用它

var _stream = new FileStream("D:\\mylog.txt", FileMode.Open, FileAccess.ReadWrite);
StreamLogger _logger = new StreamLogger(_stream);
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

重要：请在尝试设置日志记录器之前，参考USB和SD卡读卡器的文档，确保它们已正确设置。

创建自定义日志记录器

您可以使用ILogger和ILoggerFactory接口创建自己的日志记录器。DebugLogger是最简单的一种。

日志扩展

提供了不同的日志扩展以帮助您以所需的方式记录。您可以简单地记录一个字符串，也可以有参数以及异常和EventId

_logger.LogTrace("TRACE {0} {1}", new object[] { "param 1", 42 });
_logger.LogDebug("DEBUG {0} {1}", new object[] { "param 1", 42 });
_logger.LogInformation("INFORMATION and nothing else");
_logger.LogWarning("WARNING {0} {1}", new object[] { "param 1", 42 });
_logger.LogError(new Exception("Big problem"), "ERROR {0} {1}", new object[] { "param 1", 42 });
_logger.LogCritical(42, new Exception("Insane problem"), "CRITICAL {0} {1}", new object[] { "param 1", 42 });

请注意，所有日志级别扩展都至少有字符串日志记录，直到EventId、字符串、参数和异常。参数存在时，您负责正确地格式化字符串。

日志级别

您可以在预定义的日志记录器中调整日志级别。例如

DebugLogger _logger;
_logger = new DebugLogger("test");
_logger.MinLogLevel = LogLevel.Trace;
_logger.LogTrace("This will be displayed");
_logger.LogCritical("Critical message will be displayed");
_logger.MinLogLevel = LogLevel.Critical;
_logger.LogTrace("This won't be displayed, only critical will be");
_logger.LogCritical("Critical message will be displayed");

创建自定义格式化

您可以使用自定义格式化程序，这将提供日志记录器的名称、日志级别、事件ID、消息本身以及潜在的异常。函数定义应遵循以下模式

public interface IMessageFormatter
{     
    string MessageFormatter(string className, LogLevel logLevel, EventId eventId, string state, Exception exception);
}

重要：此函数将直接调用，而无需创建它所属的类的实例。因此，请确保该函数是静态的，或者它是使用日志记录器类的一部分。静态选项总是可行的。该接口提供方便并给出格式。

要设置格式化，请使用以下行。包含函数的类的类型和函数的准确名称是必需的。

LoggerExtensions.MessageFormatter = typeof(MyFormatter).GetType().GetMethod("MessageFormatterStatic");

public class MyFormatter
{        
    public string MessageFormatterStatic(string className, LogLevel logLevel, EventId eventId, string state, Exception exception)
    {
        string logstr = string.Empty;
        switch (logLevel)
        {
            case LogLevel.Trace:
                logstr = "TRACE: ";
                break;
            case LogLevel.Debug:
                logstr = "I love debug: ";
                break;
            case LogLevel.Warning:
                logstr = "WARNING: ";
                break;
            case LogLevel.Error:
                logstr = "ERROR: ";
                break;
            case LogLevel.Critical:
                logstr = "CRITICAL:";
                break;
            case LogLevel.None:
            case LogLevel.Information:
            default:
                break;
        }

        string eventstr = eventId.Id != 0 ? $" Event ID: {eventId}, " : string.Empty;
        string msg = $"[{className}] {eventstr}{logstr} {state}";
        if (exception != null)
        {
            msg += $" {exception}";
        }

        return msg;
    }
}

您可以使用任何内容，并按照您的喜好格式化消息。

注意：在末尾添加\r\n是不必要的，每个日志记录器都会完成这项工作。

行为准则

本项目已采用由贡献者公约定义的行为准则，以明确我们社区中的预期行为。有关更多信息，请参阅.NET Foundation 行为准则。

.NET Foundation

本项目由.NET Foundation 支持。