第一节:框架前期准备篇之Log4Net日志详解

内容预览:
  • 2.  <root></root> 节点主要用来: 配置日志的的...~
  •  A:分享一下数据库的表结构,详细配置见下面的代码分享,需要注意字段...~
  • 不要使用小数,否则会一直写入当前日志, 36 超出大小后在所有文件名后自...~

一. Log4Net简介

  Log4net是从Java中的Log4j迁移过来的一个.Net版的开源日志框架,它的功能很强大,可以将日志分为不同的等级,以不同的格式输出到不同的存储介质中,比如:数据库、txt文件、内存缓冲区、邮件、控制台、ANSI终端、远程接收端等等,我们这里主要介绍最常用的两种:txt文件和数据库。

(PS:其它的存储介质详见 http://logging.apache.org/log4net/release/config-examples.html)

  Log4net将日志分为五个级别,分别是: FATAL(致命错误) > ERROR(一般错误) > WARN(警告) > INFO(一般信息) > DEBUG(调试信息),每个级别都对应着一组重载方法进行调用。

  官网地址:http://logging.apache.org/log4net/index.html

  Nuget地址:https://www.nuget.org/packages/log4net/

  Nuget安装:Install-Package log4net

  最新版本:2.0.8 (2018-08-09)

   本节主要围绕两个主要的存储介质:【txt文件】和【SQLServer数据库】展开,涵盖的知识点有:

    ①. 基本的使用步骤。

    ②. 初始化关联配置文件的几种形式。

    ③. 代码调用详解。

    ④. 配置文件详解。

    ⑤. 简单的封装和在MVC框架中的调用。 

二. 基本使用步骤

   我们先以控制台程序为例,简单介绍Log4net存储日志到txt文本文档中,后面在做代码的详解。

1. 新建01-SimpleDemo控制台程序,通过指令 【Install-Package log4net】安装相应程序集。

2.  在默认配置文件中App.config(B/S程序则为web.config)中进行配置,主要分两块:

  A. 在<configuration></configuration>节点下新增节点下新增(要在其最顶部):

    <configSections>
      <section name = “log4net” type=”log4net.Config.Log4NetConfigurationSectionHandler,log4net” />
    </configSections>
  B. 在<configuration></configuration>根节点下,配置log4net的核心配置代码, 主要节点如下:
    <log4net> <appender> </appender> <root></root> </log4net>

详细代码如下:


 1 <?xml version="1.0" encoding="utf-8" ?>

2 <configuration>
3 <!-- 1. 添加log4net的节点声明配置代码-->
4 <configSections>
5 <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
6 </configSections>
7 <!--2. log4net的核心配置代码-->
8 <log4net>
9 <!--把日志信息输出到以日期命名的文件里-->
10 <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
11 <!--文件夹的位置-->
12 <file value="D:MyLog1" />
13 <appendToFile value="true" />
14 <!--动态生成文件名-->
15 <param name="StaticLogFileName" value="false" />
16 <!--以日期命名-->
17 <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;" />
18 <rollingStyle value="Date" />
19 <!--日志在日志文件中的布局方式-->
20 <layout type="log4net.Layout.PatternLayout">
21 <conversionPattern value="%newline %n记录时间:%date %n线程ID:[%thread] %n日志级别: %-5level %n出错类:%logger property: [%property] - %n错误描述:%message%newline %n"/>
22 </layout>
23 <!--使用最小锁定模型(minimal locking model),以允许多个进程可以写入同一个文件 -->
24 <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
25 </appender>
26 <root>
27 <level value="ALL"></level>
28 <appender-ref ref="RollingFileAppender"></appender-ref>
29 </root>
30 </log4net>
31 <startup>
32 <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" />
33 </startup>
34 </configuration>

View Code

3. 代码调用

1 log4net.Config.XmlConfigurator.Configure();

2 ILog log = LogManager.GetLogger("test");
3 log.Debug("调试信息");

4. 运行结果

截止此处,日志保存成功。

 

三. 初始化配置文件

  前面提到在默认配置文件中App.config(B/S程序则为web.config)中进行配置,可以通过代码  log4net.Config.XmlConfigurator.Configure(); 来初始化配置,或者还可以通过 [assembly: log4net.Config.XmlConfigurator()]  反射的形式进行初始化配置,二者可以达到同样的效果,代表了两种初始化配置文件的形式。

  PS: [assembly: log4net.Config.XmlConfigurator()]  可以加在 当前使用文件的 namespace上作用于当前文件,或者加在Properties/AssemblyInfo.cs中,则该项目全局都无须再初始化了。

 

  在实际项目中,默认的配置文件里可能包含很多框架的信息,这个时候把 log4net的配置代码再放入进去,就会显得有点杂乱,或者有些“奇葩”的人把默认配置文件改名了,这个时候使用上述默认的两种方式就不好用了,那么这种情况怎么处理呢?

  这里重点介绍 通过 log4net.Config.XmlConfigurator.Configure(); 来关联配置文件。

情况一: 使用默认配置文件的情况

  1. 代码配置:log4net.Config.XmlConfigurator.Configure();

  2. 反射配置:[assembly: log4net.Config.XmlConfigurator()] 

 

情况二:修改默认配置文件的名称为:App1.config (这里只是举例,很少有修改默认配置文件名称的)

  1. 代码配置: 首先将App1.config文件的属性中的“生成操作”改为“ 嵌入的资源”,然后通过以下代码进行配置。

1 Assembly assembly = Assembly.GetExecutingAssembly();

2 var xml = assembly.GetManifestResourceStream("_01_SimpleDemo.App1.config");
3 log4net.Config.XmlConfigurator.Configure(xml);

  注:代码中的 _01_SimpleDemo 为命名空间名。

 

情况三:新建单独xml文件,进行log4net的配置 (推荐采用这种方式,和原配置文件区分开,单独配置方便,处理方式和情况二是一致的)

  1. 代码配置:首先将log4net.xml文件的属性中的“生成操作”改为“ 嵌入的资源”,然后通过以下代码进行配置。

1 Assembly assembly = Assembly.GetExecutingAssembly();

2 var xml = assembly.GetManifestResourceStream("_01_SimpleDemo.log4net.xml");
3 log4net.Config.XmlConfigurator.Configure(xml);

  注:代码中的 _01_SimpleDemo 为命名空间名。

 

情况四:无论是修改默认配置文件的名称为 或者 新建单独的xml作为配置文件 → 可以通过绝对路径的方式进行处理 【不推荐这种方式】

  1. 直接写绝对路径 (注意这种方式【不需要】配置文件属性为 “嵌入的资源”)

1 log4net.Config.XmlConfigurator.Configure(new FileInfo(@"D:
0 条回复 A 作者 M 管理员
    所有的伟大,都源于一个勇敢的开始!
欢迎您,新朋友,感谢参与互动!欢迎您 {{author}},您在本站有{{commentsCount}}条评论