.NET 9.0 的 Blazor Web App 项目,自定义日志 TLog V2 使用备忘

一、TLog V1 使用静态数据库上下文,优点是速度快,缺点是内存占用大,参见 .NET 9.0 的 Blazor Web App 项目、Bootstrap Blazor 组件库、自定义日志 TLog 使用备忘_navigationmanager.tobaserelativepath-CSDN博客

二、 TLog V2 改为 依赖注入 方式,优点、缺点 与 V1 相反,使用方法与 V1 相同。

cs 复制代码
namespace BlazorWebAppNet9Shared.Services;

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using System.ComponentModel.DataAnnotations;

/// <summary>
/// TLog 日志服务:首次使用 自动创建 数据库和数据表。<br/><br/>
/// 使用示例,第1步:Program.cs 中,注册服务,builder.Services.AddTLog();<br/>
/// 使用示例,第2步:TLog.Page(UserName, DisplayName, NavigationManager.ToBaseRelativePath(NavigationManager.Uri));
/// </summary>
public static class TLog
{
    private static DbContextOptions<TLogDbContext>? contextOptions;

    /// <summary>
    /// 注册 TLog 服务,示例:builder.Services.AddTLog();
    /// </summary>
    /// <param name="services"></param>
    /// <param name="dbType"></param>
    /// <param name="connectionString"></param>
    /// <returns></returns>
    public static IServiceCollection AddTLog(this IServiceCollection services, TLogDbType dbType = TLogDbType.Sqlite, string connectionString = "Data Source=SQLiteFileTLog.db")
    {
        switch (dbType)
        {
            case TLogDbType.SqlServer:
                //注册 日志上下文
                services.AddDbContext<TLogDbContext>(options => options.UseSqlServer(connectionString));
                //记录 DbContextOptions 其他方法使用
                contextOptions = new DbContextOptionsBuilder<TLogDbContext>().UseSqlServer(connectionString).Options;
                break;
            default:
                services.AddDbContext<TLogDbContext>(options => options.UseSqlite(connectionString));
                contextOptions = new DbContextOptionsBuilder<TLogDbContext>().UseSqlite(connectionString).Options;
                break;
        }

        // 自动创建数据库和数据表:修改实体定义后,删除原有的数据库自动重新建立;或者根据实体定义手动修改数据库和数据表。
        using var tLogDbContext = new TLogDbContext(contextOptions);
        if (tLogDbContext.Database.EnsureCreated())
        {
            TLog.Info("初始化数据库:成功!");
            TLog.Console("初始化数据库:成功!");
        }
        return services;
    }

    /// <summary>
    /// 等价:System.Console.WriteLine($"TLog------------{输出信息}")
    /// </summary>
    /// <param name="输出信息"></param>
    public static void Console(string? 输出信息)
    {
        System.Console.WriteLine($"TLog------------{输出信息}");
    }

    /// <summary>
    /// 操作类型 = TLogOpStyle.其他信息
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    /// <param name="操作说明"></param>
    public static void Info(string 用户名, string 姓名, string 操作对象 = "", string 操作说明 = "")
    {
        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.其他信息, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象, 操作说明 = 操作说明 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.其他信息
    /// </summary>
    /// <param name="操作说明"></param>
    public static void Info(string 操作说明)
    {
        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.其他信息, 用户名 = "用户名", 姓名 = "姓名", 操作对象 = "", 操作说明 = 操作说明 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.页面访问
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    public static void Page(string 用户名, string 姓名, string 操作对象)
    {
        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.页面访问, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.新建
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    /// <param name="操作说明"></param>
    /// <param name="操作结果"></param>
    public static void Create(string 用户名, string 姓名, string 操作对象, string 操作说明 = "", bool 操作结果 = true)
    {
        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.新建, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象, 操作说明 = 操作说明, 操作结果 = 操作结果 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.删除
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    /// <param name="操作说明"></param>
    /// <param name="操作结果"></param>
    public static void Delete(string 用户名, string 姓名, string 操作对象, string 操作说明 = "", bool 操作结果 = true)
    {

        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.删除, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象, 操作说明 = 操作说明, 操作结果 = 操作结果 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();

    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.编辑
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    /// <param name="操作说明"></param>
    /// <param name="操作结果"></param>
    public static void Update(string 用户名, string 姓名, string 操作对象, string 操作说明 = "", bool 操作结果 = true)
    {

        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.编辑, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象, 操作说明 = 操作说明, 操作结果 = 操作结果 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }
    /// <summary>
    /// 操作类型 = TLogOpStyle.查询
    /// </summary>
    /// <param name="用户名"></param>
    /// <param name="姓名"></param>
    /// <param name="操作对象"></param>
    /// <param name="操作说明"></param>
    /// <param name="操作结果"></param>
    public static void Read(string 用户名, string 姓名, string 操作对象, string 操作说明 = "", bool 操作结果 = true)
    {

        using var tLogDbContext = new TLogDbContext(contextOptions!);
        tLogDbContext.Add(new TLogEntity() { 操作类型 = TLogOpStyle.查询, 用户名 = 用户名, 姓名 = 姓名, 操作对象 = 操作对象, 操作说明 = 操作说明, 操作结果 = 操作结果 });
        tLogDbContext.SaveChanges();
        tLogDbContext.Dispose();
    }

}

/// <summary>
/// 日志数据库上下文:建议使用独立数据库,与业务数据分开存放。
/// </summary>
/// <param name="options"></param>
public class TLogDbContext(DbContextOptions<TLogDbContext> options) : DbContext(options)
{
    public DbSet<TLogEntity> TLogEntitys { get; set; }
}

/// <summary>
/// 日志实体:后续可以根据需要增加,注意不要编辑、删除已有属性。
/// </summary>
[Index(nameof(Id))]
[Index(nameof(时间))]
[Index(nameof(用户名))]
[Index(nameof(姓名))]
[Index(nameof(操作类型))]
[Index(nameof(操作对象))]
[Index(nameof(操作类型), nameof(操作对象))]
public class TLogEntity
{
    [Key]
    public long Id { get; set; }
    public DateTime 时间 { get; set; } = DateTime.Now;
    public required string 用户名 { get; set; }
    public required string 姓名 { get; set; }
    public TLogOpStyle 操作类型 { get; set; } = TLogOpStyle.页面访问;
    public required string 操作对象 { get; set; }
    public string 操作说明 { get; set; } = "";
    public bool 操作结果 { get; set; } = true;
}

/// <summary>
/// 日志类型:后续可以根据需要增加,注意不要编辑、删除已有类型。
/// </summary>
public enum TLogOpStyle
{
    /// <summary>
    /// 记录页面访问日志:Page
    /// </summary>
    页面访问,
    /// <summary>
    /// 增删改查CRUD:Create
    /// </summary>
    新建,
    /// <summary>
    /// 增删改查CRUD:Read
    /// </summary>
    查询,
    /// <summary>
    /// 增删改查CRUD:Update
    /// </summary>
    编辑,
    /// <summary>
    /// 增删改查CRUD:Delete
    /// </summary>
    删除,
    /// <summary>
    /// Information:Info
    /// </summary>
    其他信息
}
/// <summary>
/// 日志使用数据库类型:默认使用 Sqlite
/// </summary>
public enum TLogDbType
{
    /// <summary>
    /// 使用 SQL Server database
    /// </summary>
    SqlServer,
    /// <summary>
    /// 使用 SQLite database
    /// </summary>
    Sqlite
}
相关推荐
睡觉的时候不会困3 小时前
Redis 主从复制详解:原理、配置与主从切换实战
数据库·redis·bootstrap
程序员的世界你不懂5 小时前
【Flask】测试平台开发,新增说明书编写和展示功能 第二十三篇
java·前端·数据库
自学也学好编程5 小时前
【数据库】Redis详解:内存数据库与缓存之王
数据库·redis
JAVA不会写5 小时前
在Mybatis plus中如何使用自定义Sql
数据库·sql
IT 小阿姨(数据库)5 小时前
PgSQL监控死元组和自动清理状态的SQL语句执行报错ERROR: division by zero原因分析和解决方法
linux·运维·数据库·sql·postgresql·centos
ChinaRainbowSea6 小时前
7. LangChain4j + 记忆缓存详细说明
java·数据库·redis·后端·缓存·langchain·ai编程
小马学嵌入式~7 小时前
嵌入式 SQLite 数据库开发笔记
linux·c语言·数据库·笔记·sql·学习·sqlite
Java小白程序员7 小时前
MyBatis基础到高级实践:全方位指南(中)
数据库·mybatis
Monly217 小时前
人大金仓:merge sql error, dbType null, druid-1.2.20
数据库·sql