using System;

namespace XplorePlane.Services
{
    /// <summary>
    /// 日志服务接口
    /// </summary>
    public interface ILoggerService
    {
        /// <summary>
        /// 为指定模块创建日志器（使用泛型自动推断类型名）
        /// </summary>
        ILoggerService ForModule<T>();

        /// <summary>
        /// 为指定模块创建日志器（手动指定模块名）
        /// </summary>
        ILoggerService ForModule(string moduleName);

        /// <summary>
        /// 记录调试信息
        /// </summary>
        void Debug(string message);

        /// <summary>
        /// 记录调试信息（带参数）
        /// </summary>
        void Debug(string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录一般信息
        /// </summary>
        void Info(string message);

        /// <summary>
        /// 记录一般信息（带参数）
        /// </summary>
        void Info(string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录警告信息
        /// </summary>
        void Warn(string message);

        /// <summary>
        /// 记录警告信息（带参数）
        /// </summary>
        void Warn(string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录错误信息
        /// </summary>
        void Error(string message);

        /// <summary>
        /// 记录错误信息（带参数）
        /// </summary>
        void Error(string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录错误信息（带异常）
        /// </summary>
        void Error(Exception exception, string message);

        /// <summary>
        /// 记录错误信息（带异常和参数）
        /// </summary>
        void Error(Exception exception, string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录致命错误
        /// </summary>
        void Fatal(string message);

        /// <summary>
        /// 记录致命错误（带参数）
        /// </summary>
        void Fatal(string messageTemplate, params object[] propertyValues);

        /// <summary>
        /// 记录致命错误（带异常）
        /// </summary>
        void Fatal(Exception exception, string message);

        /// <summary>
        /// 记录致命错误（带异常和参数）
        /// </summary>
        void Fatal(Exception exception, string messageTemplate, params object[] propertyValues);
    }
}