mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
- 将 AbstractLogger 实现从 ILogger 扩展为 IStructuredLogger 接口 - 添加通用日志方法 Log(LogLevel, string, params object[]) 支持格式化参数 - 实现结构化日志方法支持属性键值对记录 - 添加 ConsoleAppender、FileAppender 和 AsyncLogAppender 日志输出器 - 实现 CompositeFilter 过滤器和 DefaultLogFormatter、JsonLogFormatter 格式化器 - 在 ConsoleLogger 和 GodotLogger 中使用预缓存的日志级别字符串提升性能 - 使用 ANSI 颜色代码替代 ConsoleColor 实现跨平台日志着色 - 在 ConsoleLoggerFactoryProvider 和 GodotLoggerFactoryProvider 中添加日志工厂缓存 - 优化 FileStorage 中目录遍历使用 OfType<string>() 类型转换 - 添加 LogContext 支持异步流中的结构化属性传递
74 lines
2.6 KiB
C#
74 lines
2.6 KiB
C#
using GFramework.Core.Abstractions.logging;
|
|
using GFramework.Core.logging;
|
|
using Godot;
|
|
|
|
namespace GFramework.Godot.logging;
|
|
|
|
/// <summary>
|
|
/// Godot平台的日志记录器实现。
|
|
/// 该类继承自 <see cref="AbstractLogger"/>,用于在 Godot 引擎中输出日志信息。
|
|
/// 支持不同日志级别的输出,并根据级别调用 Godot 的相应方法。
|
|
/// </summary>
|
|
/// <param name="name">日志记录器的名称,默认为根日志记录器名称。</param>
|
|
/// <param name="minLevel">最低日志级别,默认为 <see cref="LogLevel.Info"/>。</param>
|
|
public sealed class GodotLogger(
|
|
string? name = null,
|
|
LogLevel minLevel = LogLevel.Info) : AbstractLogger(name ?? RootLoggerName, minLevel)
|
|
{
|
|
// 静态缓存日志级别字符串,避免重复格式化
|
|
private static readonly string[] LevelStrings =
|
|
[
|
|
"TRACE ",
|
|
"DEBUG ",
|
|
"INFO ",
|
|
"WARNING",
|
|
"ERROR ",
|
|
"FATAL "
|
|
];
|
|
|
|
/// <summary>
|
|
/// 写入日志的核心方法。
|
|
/// 格式化日志消息并根据日志级别调用 Godot 的输出方法。
|
|
/// </summary>
|
|
/// <param name="level">日志级别。</param>
|
|
/// <param name="message">日志消息内容。</param>
|
|
/// <param name="exception">可选的异常信息。</param>
|
|
protected override void Write(LogLevel level, string message, Exception? exception)
|
|
{
|
|
// 构造时间戳和日志前缀
|
|
var timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff");
|
|
var levelStr = LevelStrings[(int)level];
|
|
var logPrefix = $"[{timestamp}] {levelStr} [{Name()}]";
|
|
|
|
// 添加异常信息到日志消息中
|
|
if (exception != null) message += "\n" + exception;
|
|
|
|
var logMessage = $"{logPrefix} {message}";
|
|
|
|
// 根据日志级别选择 Godot 输出方法
|
|
switch (level)
|
|
{
|
|
case LogLevel.Fatal:
|
|
GD.PushError(logMessage);
|
|
break;
|
|
case LogLevel.Error:
|
|
GD.PrintErr(logMessage);
|
|
break;
|
|
case LogLevel.Warning:
|
|
GD.PushWarning(logMessage);
|
|
break;
|
|
case LogLevel.Trace:
|
|
GD.PrintRich($"[color=gray]{logMessage}[/color]");
|
|
break;
|
|
case LogLevel.Debug:
|
|
GD.PrintRich($"[color=cyan]{logMessage}[/color]");
|
|
break;
|
|
case LogLevel.Info:
|
|
GD.Print(logMessage);
|
|
break;
|
|
default:
|
|
GD.Print(logMessage);
|
|
break;
|
|
}
|
|
}
|
|
} |