第4章 配置集成第3方log4net日志中间件
在上一章中虽然已经把第3方log4net日志中间件定义到了当前程序中，但是并没有把第3方log4net日志中间件的功能配置并集到当前程序中，即当前程序还不能通过第3方log4net日志中间件把日志数据信息持久化到指定的文件或表中，本章即将实现当前程序对第3方log4net日志中间件的配置集成
1 日志实例的文件持久化集成
1.1 重构appsettings.json
"AppSettings": {
//"RedisCachingAOP": {
// "Enabled": false
//},
//"MemoryCachingAOP": {
// "Enabled": true
//},
"LogAOP": {
"Enabled": "true",
"LogToFile": {
"Enabled": true
},
"LogToDB": {
"Enabled": true
}
},
"TranAOP": {
"Enabled": true
},
"SqlAOP": {
"Enabled": true,
"LogToFile": {
"Enabled": true
},
"LogToDB": {
"Enabled": true
},
"LogToConsole": {
"Enabled": true
}
},
//"Date": "2018-08-28",
"SeedDBEnabled": true, //只生成表结构
"SeedDBDataEnabled": true, //生成表,并初始化数据
//"Author": "Blog.Core",
// "SvcName": "", // /svc/blog
///"UseLoadTest": false
},
1.2 重构 Extensions.ServiceExtensions.SqlsugarSetup.AddSqlsugarSetup方法
if (AppSettings.app(new string[] { "AppSettings", "SqlAOP", "Enabled" }).ObjToBool())
{
if (AppSettings.app(new string[] { "AppSettings", "SqlAOP", "LogToFile", "Enabled" }).ObjToBool())
按F5执行程序后，会自动把日志实例持久化到启动项中的指定文件中，但是因为没有定义log4net日志中间件过滤配置，所以该文件中的信息非常的多且不必要，如下图所示：
1.3 实例化第3方“log4net”日志中间件
//通过设定的持久化过滤规则及其配置文件(Log4net.config)中的数据实例，实例化第3方“log4net”日志中间件，最后把第3方“log4net”日志中间件依赖注入到内置容器中。
//注意：原示例代码是把把第3方“log4net”日志中间件依赖注入到内置依赖注入第3方“Autofac”容器中。
builder.Services.AddLogging(loging => {
//第3方“log4net”日志中间件持久化过滤规则：在持久化时，过滤掉带有"System"命名空间的日志信息实例。
loging.AddFilter("System", LogLevel.Error);
//第3方“log4net”日志中间件持久化过滤规则：在持久化时，过滤掉带"Microsoft"命名空间的日志信息实例。
loging.AddFilter("Microsoft", LogLevel.Error);
loging.SetMinimumLevel(LogLevel.Error);
});
注意：
- 上面的定义并不包含配置文件(Log4net.config)，因为配置文件(Log4net.config)主要是针对于数据库中的日志表，所以本人会在下面的日志实例的表持久化集成中进重构。
- 通过第3方“log4net”日志中间件把日志实例的持久化到日志文件中只依赖于中间件：log4net，被直接引用在“Common”项目中。
在实例化了带有持久化过滤规则定义的“log4net”日志中间件实例后，log4net日志中间件就会对日志实例中的数据进行过滤，那么日志文件中的持久化数据就会明显的减少，如下图所示：
2 日志实例的表持久化集成
由于不能通过示例中的配置文件实现通过“log4net”日志中间件把日志实例持久化到指定的表中，本人对“Log4net.config”配置文件进行了重新的定义其定义如下
2.1 重新的定义“Log4net.config”配置文件
2.2 重构实例化第3方“log4net”日志中间件的定义
//通过设定的持久化过滤规则及其配置文件(Log4net.config)中的数据实例，实例化第3方“log4net”日志中间件，最后把第3方“log4net”日志中间件依赖注入到内置容器中。
//注意：原示例代码是把把第3方“log4net”日志中间件依赖注入到内置依赖注入第3方“Autofac”容器中。
builder.Services.AddLogging(loging => {
//第3方“log4net”日志中间件持久化过滤规则：在持久化时，过滤掉带有"System"命名空间的日志信息实例。
loging.AddFilter("System", LogLevel.Error);
//第3方“log4net”日志中间件持久化过滤规则：在持久化时，过滤掉带"Microsoft"命名空间的日志信息实例。
loging.AddFilter("Microsoft", LogLevel.Error);
loging.SetMinimumLevel(LogLevel.Error);
loging.AddLog4Net("Log4net.config");
});
2.3 定义对日志实例进行持久化支撑的实体：GblLogAudit
008 GblLogAudit
GblLogAudit：继承了RootEntityTkey
注意：
该实体类所对应的表是在“Code-First”模式下，由“SqlSugar”中间件自动生成；但插入操作通过“log4net”日志中间件，即“SqlSugar”中间件只能读取“[Blog].[GblLogAudit]”表，而不能对该表进行增/修/删等操作。
按F5执行程序后会自动把当前程序中的日志实例持久化到“[Blog].[GblLogAudit]”表中，如下图所示：
注意：
- 通过第3方“log4net”日志中间件把日志实例的持久化到表中只依赖于2个中间件：
(1)、“Microsoft.Extensions.Logging.Log4Net.AspNetCore”，被直接引用在“Extensions”项目中。
(2)、“System.Data.SqlClient”，被直接引用在启动项目中。
(3)、在原示例程序中并没有“System.Data.SqlClient”的直接引用。
2、配置文件中的数据库提供程序的连接字符不要带版本和公共密钥信息，否则会导致不能被持久化到表中。
正确示例：
错误示例：
3、对于日志实例的持久化解决方案本人的看法：
第3方log4net日志中间件<第3方Nlog日志中间件<完全自定义，第3方Nlog日志中间件虽然在配置上可能相比第3方log4net日志中间件麻烦，但功能和可读性上比第3方log4net日志中间件安强的多；而完全自定义则可以保证实体类的定义实现的一致性，只获取自己需要被持久化的数据，强化了开发者对整个人程序的控制力。
4、Bug：由于“[Blog].[GblLogAudit]”表是在“Code-First”模式自动生成，所以在第1次执行程序时“[Blog].[GblLogAudit]”表中是无任何数据的，只有再次执行程序表中才有数据。
对以上功能更为具体实现和注释见：221123_04Blog(配置集成第3方log4net日志中间件)。
下一篇：关于哑巴的词语