初步完成Log的增删改查

This commit is contained in:
2025-09-07 19:01:58 +08:00
parent 1f9c0a1111
commit 0e4a306fa7
12 changed files with 596 additions and 34 deletions

View File

@@ -0,0 +1,88 @@
using SqlSugar;
namespace DMS.Infrastructure.Entities;
/// <summary>
/// NLog日志实体类对应数据库中的 nlog 表。
/// </summary>
[SugarTable("nlog")]
public class DbNlog
{
/// <summary>
/// 日志ID主键且自增。
/// </summary>
[SugarColumn(IsPrimaryKey = true, IsIdentity = true, ColumnName = "ID")]
public int Id { get; set; }
/// <summary>
/// 日志记录时间。
/// </summary>
[SugarColumn(ColumnName = "LogTime")]
public DateTime LogTime { get; set; }
/// <summary>
/// 日志级别 (如 INFO, ERROR 等)。
/// </summary>
[SugarColumn(ColumnName = "Level")]
public string Level { get; set; }
/// <summary>
/// 线程ID。
/// </summary>
[SugarColumn(ColumnName = "ThreadID")]
public int ThreadId { get; set; }
/// <summary>
/// 线程名称。
/// </summary>
[SugarColumn(ColumnName = "ThreadName", IsNullable = true)]
public string ThreadName { get; set; }
/// <summary>
/// 调用点(通常是记录日志的方法名)。
/// </summary>
[SugarColumn(ColumnName = "Callsite", IsNullable = true)]
public string Callsite { get; set; }
/// <summary>
/// 调用点所在的行号。
/// </summary>
[SugarColumn(ColumnName = "CallsiteLineNumber")]
public int CallsiteLineNumber { get; set; }
/// <summary>
/// 日志消息内容。
/// </summary>
[SugarColumn(ColumnName = "Message")]
public string Message { get; set; }
/// <summary>
/// 记录日志的记录器名称。
/// </summary>
[SugarColumn(ColumnName = "Logger")]
public string Logger { get; set; }
/// <summary>
/// 异常信息(如果有的话)。
/// </summary>
[SugarColumn(ColumnName = "Exception", IsNullable = true)]
public string Exception { get; set; }
/// <summary>
/// 调用方文件路径。
/// </summary>
[SugarColumn(ColumnName = "CallerFilePath", IsNullable = true)]
public string CallerFilePath { get; set; }
/// <summary>
/// 调用方行号。
/// </summary>
[SugarColumn(ColumnName = "CallerLineNumber")]
public int CallerLineNumber { get; set; }
/// <summary>
/// 调用方成员(方法名)。
/// </summary>
[SugarColumn(ColumnName = "CallerMember", IsNullable = true)]
public string CallerMember { get; set; }
}

View File

@@ -0,0 +1,130 @@
using AutoMapper;
using DMS.Core.Interfaces.Repositories;
using DMS.Core.Models;
using DMS.Infrastructure.Data;
using DMS.Infrastructure.Entities;
using Microsoft.Extensions.Logging;
namespace DMS.Infrastructure.Repositories;
/// <summary>
/// Nlog日志仓储实现类负责Nlog日志数据的持久化操作。
/// 继承自 <see cref="BaseRepository{DbNlog}"/> 并实现 <see cref="INlogRepository"/> 接口。
/// </summary>
public class NlogRepository : BaseRepository<DbNlog>, INlogRepository
{
private readonly IMapper _mapper;
/// <summary>
/// 构造函数,注入 AutoMapper 和 SqlSugarDbContext。
/// </summary>
/// <param name="mapper">AutoMapper 实例,用于实体模型和数据库模型之间的映射。</param>
/// <param name="dbContext">SqlSugar 数据库上下文,用于数据库操作。</param>
/// <param name="logger">日志记录器实例。</param>
public NlogRepository(IMapper mapper, SqlSugarDbContext dbContext, ILogger<NlogRepository> logger)
: base(dbContext, logger)
{
_mapper = mapper;
}
// Nlog 通常是只读或追加的日志,因此像 AddAsync, UpdateAsync, DeleteAsync 这样的修改方法
// 可能不需要在仓储接口中暴露,或者可以省略具体实现或抛出 NotSupportedException。
// 但为了保持与基类一致性并满足接口要求,这里显式实现它们。
/// <summary>
/// 异步获取所有Nlog日志条目。
/// </summary>
/// <returns>包含所有Nlog日志实体的列表。</returns>
public new async Task<List<Core.Models.Nlog>> GetAllAsync()
{
var dbList = await base.GetAllAsync();
return _mapper.Map<List<Core.Models.Nlog>>(dbList);
}
/// <summary>
/// 异步根据ID获取单个Nlog日志条目。
/// </summary>
/// <param name="id">日志条目的唯一标识符。</param>
/// <returns>对应的Nlog日志实体如果不存在则为null。</returns>
public new async Task<Core.Models.Nlog> GetByIdAsync(int id)
{
var dbNlog = await base.GetByIdAsync(id);
return _mapper.Map<Core.Models.Nlog>(dbNlog);
}
/// <summary>
/// 异步添加一个新Nlog日志条目。
/// 注意直接写入数据库日志表通常不推荐NLog本身负责写入。
/// 此方法主要用于满足接口契约,实际使用应谨慎。
/// </summary>
/// <param name="entity">要添加的Nlog日志实体。</param>
/// <returns>添加后的Nlog日志实体包含ID等信息。</returns>
public new async Task<Core.Models.Nlog> AddAsync(Core.Models.Nlog entity)
{
var dbEntity = _mapper.Map<DbNlog>(entity);
var addedDbEntity = await base.AddAsync(dbEntity);
return _mapper.Map(addedDbEntity, entity);
}
/// <summary>
/// 异步更新一个Nlog日志条目。
/// 注意:直接更新数据库日志表通常不推荐,日志应视为不可变。
/// 此方法主要用于满足接口契约,实际使用应谨慎。
/// </summary>
/// <param name="entity">要更新的Nlog日志实体。</param>
/// <returns>受影响的行数。</returns>
public new async Task<int> UpdateAsync(Core.Models.Nlog entity)
{
var dbEntity = _mapper.Map<DbNlog>(entity);
return await base.UpdateAsync(dbEntity);
}
/// <summary>
/// 异步删除一个Nlog日志条目。
/// 注意:直接删除数据库日志表记录通常不推荐,除非是清理过期日志。
/// 此方法主要用于满足接口契约,实际使用应谨慎。
/// </summary>
/// <param name="entity">要删除的Nlog日志实体。</param>
/// <returns>受影响的行数。</returns>
public new async Task<int> DeleteAsync(Core.Models.Nlog entity)
{
var dbEntity = _mapper.Map<DbNlog>(entity);
return await base.DeleteAsync(dbEntity);
}
/// <summary>
/// 异步根据ID删除一个Nlog日志条目。
/// 注意:直接删除数据库日志表记录通常不推荐,除非是清理过期日志。
/// 此方法主要用于满足接口契约,实际使用应谨慎。
/// </summary>
/// <param name="id">要删除的Nlog日志条目的ID。</param>
/// <returns>受影响的行数。</returns>
public new async Task<int> DeleteByIdAsync(int id)
{
return await base.DeleteByIdsAsync(new List<int>(){id});
}
/// <summary>
/// 异步获取指定数量的Nlog日志条目。
/// </summary>
/// <param name="number">要获取的条目数量。</param>
/// <returns>包含指定数量Nlog日志实体的列表。</returns>
public new async Task<List<Core.Models.Nlog>> TakeAsync(int number)
{
var dbList = await base.TakeAsync(number);
return _mapper.Map<List<Core.Models.Nlog>>(dbList);
}
/// <summary>
/// 异步批量添加Nlog日志条目。
/// 注意直接批量写入数据库日志表通常不推荐NLog本身负责写入。
/// 此方法主要用于满足接口契约,实际使用应谨慎。
/// </summary>
/// <param name="entities">要添加的Nlog日志实体列表。</param>
/// <returns>操作是否成功。</returns>
public new async Task<bool> AddBatchAsync(List<Core.Models.Nlog> entities)
{
var dbEntities = _mapper.Map<List<DbNlog>>(entities);
return await base.AddBatchAsync(dbEntities);
}
}

View File

@@ -27,6 +27,7 @@ public class RepositoryManager : IRepositoryManager
/// <param name="menus">菜单仓储实例。</param>
/// <param name="variableHistories">变量历史仓储实例。</param>
/// <param name="users">用户仓储实例。</param>
/// <param name="nlogs">Nlog日志仓储实例。</param>
public RepositoryManager( SqlSugarDbContext dbContext,
IInitializeRepository initializeRepository,
IDeviceRepository devices,
@@ -36,7 +37,8 @@ public class RepositoryManager : IRepositoryManager
IVariableMqttAliasRepository variableMqttAliases,
IMenuRepository menus,
IVariableHistoryRepository variableHistories,
IUserRepository users)
IUserRepository users,
INlogRepository nlogs)
{
_dbContext = dbContext;
InitializeRepository = initializeRepository;
@@ -48,6 +50,7 @@ public class RepositoryManager : IRepositoryManager
Menus = menus;
VariableHistories = variableHistories;
Users = users;
Nlogs = nlogs;
_db = dbContext.GetInstance();
}
@@ -93,6 +96,10 @@ public class RepositoryManager : IRepositoryManager
/// </summary>
public IUserRepository Users { get; set; }
/// <summary>
/// 获取Nlog日志仓储实例。
/// </summary>
public INlogRepository Nlogs { get; set; }
/// <summary>
/// 获取初始化仓储实例。
/// </summary>
public IInitializeRepository InitializeRepository { get; set; }