mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
0980fd48b5
- 为ConsoleLogger添加完整的XML文档注释 - 实现GodotLogger中缺失的日志级别方法 - 统一Fatal方法签名，支持异常参数传递 - 为NullLogger添加完整的方法注释 - 修复LoggerFactory中的文件路径处理逻辑 - 移除日志示例中对架构阶段的直接访问 - 添加全局日志记录器创建功能
73 lines
2.4 KiB
C#
73 lines
2.4 KiB
C#
namespace GFramework.Core.logging;
|
||
|
||
/// <summary>
|
||
/// 定义日志记录接口，提供日志记录和级别检查功能
|
||
/// </summary>
|
||
public interface ILog
|
||
{
|
||
/// <summary>
|
||
/// 记录指定级别的日志消息
|
||
/// </summary>
|
||
/// <param name="level">日志级别</param>
|
||
/// <param name="message">日志消息内容</param>
|
||
/// <param name="exception">可选的异常对象，默认为null</param>
|
||
/// <param name="context">可选的上下文对象，默认为null</param>
|
||
void Log(
|
||
LogLevel level,
|
||
string message,
|
||
Exception? exception = null,
|
||
object? context = null
|
||
);
|
||
|
||
/// <summary>
|
||
/// 检查指定日志级别是否启用
|
||
/// </summary>
|
||
/// <param name="level">要检查的日志级别</param>
|
||
/// <returns>如果指定级别已启用则返回true，否则返回false</returns>
|
||
bool IsEnabled(LogLevel level);
|
||
|
||
/// <summary>
|
||
/// 记录信息级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Info(string msg, object? ctx = null);
|
||
|
||
/// <summary>
|
||
/// 记录错误级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ex">相关异常对象（可选）</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Error(string msg, Exception? ex = null, object? ctx = null);
|
||
|
||
/// <summary>
|
||
/// 记录调试级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Debug(string msg, object? ctx = null);
|
||
|
||
/// <summary>
|
||
/// 记录跟踪级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Trace(string msg, object? ctx = null);
|
||
|
||
/// <summary>
|
||
/// 记录警告级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Warn(string msg, object? ctx = null);
|
||
|
||
/// <summary>
|
||
/// 记录致命错误级别日志
|
||
/// </summary>
|
||
/// <param name="msg">日志消息</param>
|
||
/// <param name="ex">相关异常对象（可选）</param>
|
||
/// <param name="ctx">日志上下文信息（可选）</param>
|
||
void Fatal(string msg, Exception? ex = null,object? ctx = null);
|
||
}
|