Log4net入门（WCF篇）

2018-06-18 04:23:29来源：未知阅读 ()

　　在上一篇Log4net入门（ASP.NET MVC 5篇）中，我们讲述了如何在ASP.NET MVC 5项目中使用log4net。在这一篇中，我们将讲述如何在WCF应用中使用log4net，为了讲述这个过程，我们将创建三个项目：WCF服务库项目、WCF服务应用程序和客户端应用程序。WCF服务库项目主要用于编写我们的WCF契约及服务，WCF服务应用程序主要用于将我们的WCF服务库托管到IIS上，客户端应用程序主要目的就是调用我们托管到IIS上的WCF服务。

一、项目创建

1、空白解决方案的创建：启动VS2015，依次点击【文件】-【新建】-【项目】，在“新建项目”对话框中，展开“其他项目类型”节点，选中“Visual Studio”解决方案，我们创建一个名为“Log4netWCF”的空白解决方案。

2、WCF服务库项目的创建：右击在第一步创建的“Log4netWCF”解决方案，依次点击【添加】-【新建】项目，在“添加新项目”对话框中，我们选中“WCF”节点，在右侧我们选择“WCF服务库”项目，将该项目命名为“Log4netWCFServiceLibrary”，然后点击“确定”按钮，这样一个最简单的WCF服务就创建好了，里面的IService1.cs是服务契约，Service1是该契约的实现，这个是微软自带的演示代码，为了简单起见，我们不做任何改动，直接使用这个最简单的服务。

3、WCF服务应用程序的创建：右击在第一步创建的“Log4netWCF”解决方案，依次点击【添加】-【新建】项目，在“新建项目”对话框中，我们选中“WCF”节点，在右侧我们选择“WCF服务应用程序”项目，将该项目命名为“Log4netWCFService”，然后点击“确定”按钮，完成WCF服务应用程序的创建。

4、在新创建的“Log4netWCFService”项目中，我们右击“IService1.cs”文件，选择将其删除。然后展开Service1.svc，右击“Service1.svc.cs”，选择将其删除。

5、右击“Log4netWCFService”项目的“引用”节点，选择【添加引用】选项，在弹出的“引用管理器”对话框中，展开“项目”节点，选中“解决方案”节点，在右侧勾选“Log4netWCFServiceLibrary”，然后点击“确定”按钮。这样我们就在“Log4netWCFService”服务应用程序项目中添加了对“Log4netWCFServiceLibrary”服务库的引用。

6、双击打开“Log4netWCFService”项目中的Service1.svc文件，将其中的代码修改为以下代码：

1 <%@ ServiceHost Language="C#" Debug="true" Service="Log4netWCFServiceLibrary.Service1" CodeBehind="Service1.cs" %>

7、右击“Log4netWCF”解决方案，点击【生成解决方案】选项，编译整个解决方案，如果没有错误，继续下面的操作。

8、右击“Log4netWCFService”项目，点击【发布】选项，弹出“发布Web”对话框，如下所示：

9、选择“自定义”选项，然后输入配置文件名称为“Log4netWCF”，这个名称可以随便取，好记即可。然后点击“确定”按钮，进入下一步，如下图所示：

10、在“Publish method：”中选择“File System”，入下图所示：

11、点击“Target location：”后面的“...”按钮，弹出“目标位置”对话框，在该对话框中点击“本地IIS”按钮，如下图所示：

12、在上图中，点击“IIS网站”下面的“Default Web Site”，然后点击右上角的“创建新Web应用程序”按钮，如下图所示：

13、输入应用程序名称为“Log4netWCF”，如下图所示：

14、点击“打开”按钮，返回到“发布Web”对话框，然后点击“下一步”按钮。在“设置”标签页中，展开“File Publish Options”，然后勾选“Delete all existing files prior to publish”和“Precompile during publishing”，如下图所示：

15、点击“下一步”按钮，然后再点击“发布”按钮，等待发布成功提示信息即可。

16、打开控制面板，依次点击【系统和安全】-【管理工具】，然后以管理员身份运行“Internet信息服务(IIS)管理器”，在打开的“Internet信息服务(IIS)管理器”窗口中展开“Default Web Site”节点，然后选择“Log4netWCF”应用程序，在右侧下方点击“内容视图”，然后右键单击“Service1.svc”文件，选择【浏览】选项，如果WCF服务没有错误，则会出现如下页面：

　　注意：上图中的服务地址：http://localhost/Log4netWCF/Service1.svc，我们会在客户端程序中添加服务引用的时候用到。

17、客户端应用程序的创建：为方便起见，我们将客户端应用程序创建为一个控制台应用程序，右击第一步创建的“Log4netWCF”解决方案，依次点击【添加】-【新建项目】选项，在弹出的“添加新项目”对话框中选择“控制台应用程序”，并将其命名为Client，然后点击“确定”按钮。

18、在新创建的“Client”项目中，右击“引用”节点，然后点击【添加服务引用】选项，在弹出的“添加服务引用”对话框中的地址栏中，输入在第16步生成的服务地址：http://localhost/Log4netWCF/Service1.svc，然后点击“转到”按钮，修改命名空间为“Log4netWCF”，如下图所示：

19、点击“确定”按钮，完成对WCF服务的引用。

20、双击打开“Client”项目中的“Program.cs”文件，修改代码如下所示：

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 using System.Threading.Tasks;
 6 
 7 namespace Client
 8 {
 9     class Program
10     {
11         static void Main(string[] args)
12         {
13             Log4netWCF.Service1Client proxy = new Log4netWCF.Service1Client();
14             proxy.Open();
15             string returnString = proxy.GetData(7);
16             proxy.Close();
17 
18             Console.WriteLine(returnString);
19             Console.ReadKey();
20         }
21     }
22 }

21、将“Client”项目设置为启动项目，然后运行程序，如果没有任何错误，会出现如下结果页面：

　　到这为止，我们的WCF应用程序全部创建完毕，下一步我们将在WCF应用程序中添加对log4net的使用。

二、在WCF应用程序中配置log4net

1、点击VS工具栏中的【工具】-【NuGet包管理器】-【管理解决方案的NuGet程序包】，在打开的“NuGet - 解决方案”标签页中，点击“浏览”标签，然后在搜索框中输入“log4net”，选择搜索结果中的“log4net”，然后勾选右侧的“Log4netWCFServiceLibrary”，选择最新稳定版本，然后点击“安装按钮”，如下图所示：

2、安装log4net之后，点击“Log4netWCFServiceLibrary”项目中的Properties节点，然后双击打开“AssemblyInfo.cs”文件，在该文件最后添加以下一行代码：

1 [assembly: log4net.Config.XmlConfigurator(ConfigFile = "Log4Net.config", Watch = true)]

3、双击打开“Log4netWCFServiceLibrary”项目中的“Service1.cs”，修改代码如下所示：

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Runtime.Serialization;
 5 using System.ServiceModel;
 6 using System.Text;
 7 
 8 namespace Log4netWCFServiceLibrary
 9 {
10     // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的类名“Service1”。
11     public class Service1 : IService1
12     {
13         private static log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
14 
15         public string GetData(int value)
16         {
17             log.Debug("debug!");
18             log.Info("info!");
19             log.Warn("warn!");
20             log.Error("error!");
21             log.Fatal("fatal!");
22 
23             return string.Format("You entered: {0}", value);
24         }
25 
26         public CompositeType GetDataUsingDataContract(CompositeType composite)
27         {
28             if (composite == null)
29             {
30                 throw new ArgumentNullException("composite");
31             }
32             if (composite.BoolValue)
33             {
34                 composite.StringValue += "Suffix";
35             }
36             return composite;
37         }
38     }
39 }

4、在“Log4netWCFService”项目中添加一个名为“Log4net.config”的配置文件，我们在其中配置按日期切分日志文件，并且将日期作为日志文件名称的一部分，具体配置文件如下所示：

 1 <?xml version="1.0" encoding="utf-8"?>
 2 <configuration>
 3   <configSections>
 4     <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
 5   </configSections>
 6 
 7   <system.web>
 8     <compilation debug="true" targetFramework="4.5.2" />
 9     <httpRuntime targetFramework="4.5.2" />
10   </system.web>
11 
12   <log4net>
13     <!-- 将日志以回滚文件的形式写到文件中 -->
14     <!-- 按日期切分日志文件，并将日期作为日志文件的名字 -->
15     <appender name="RollingFileAppenderNameByDate" type="log4net.Appender.RollingFileAppender">
16       <!-- 日志文件存放位置，可以为绝对路径也可以为相对路径 -->
17       <file value="C:\Logs\" />
18       <!-- 将日志信息追加到已有的日志文件中-->
19       <appendToFile value="true" />
20       <!-- 最小锁定模式，以允许多个进程可以写入同一个文件 -->
21       <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
22       <!-- 指定按日期切分日志文件 -->
23       <rollingStyle value="Date" />
24       <!-- 日志文件的命名规则 -->
25       <datePattern value="&quot;WCFLogs_&quot;yyyyMMdd&quot;.log&quot;" />
26       <!-- 当将日期作为日志文件的名字时，必须将staticLogFileName的值设置为false -->
27       <staticLogFileName value="false" />
28 
29       <layout type="log4net.Layout.PatternLayout">
30         <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
31       </layout>
32     </appender>
33 
34     <root>
35       <!-- 控制级别，由低到高：ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF -->
36       <!-- 比如定义级别为INFO，则INFO级别向下的级别，比如DEBUG日志将不会被记录 -->
37       <!-- 如果没有定义LEVEL的值，则缺省为DEBUG -->
38       <level value="ALL" />
39       <!-- 按日期切分日志文件，并将日期作为日志文件的名字 -->
40       <appender-ref ref="RollingFileAppenderNameByDate" />
41     </root>
42   </log4net>
43 </configuration>