在上一篇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文件,将其中的代码修改为以下代码:
<%@ 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”文件,修改代码如下所示:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks; namespace Client
{
class Program
{
static void Main(string[] args)
{
Log4netWCF.Service1Client proxy = new Log4netWCF.Service1Client();
proxy.Open();
string returnString = proxy.GetData();
proxy.Close();
Console.WriteLine(returnString);
Console.ReadKey();
}
}
}
21、将“Client”项目设置为启动项目,然后运行程序,如果没有任何错误,会出现如下结果页面:
到这为止,我们的WCF应用程序全部创建完毕,下一步我们将在WCF应用程序中添加对log4net的使用。
二、在WCF应用程序中配置log4net
1、点击VS工具栏中的【工具】-【NuGet包管理器】-【管理解决方案的NuGet程序包】,在打开的“NuGet - 解决方案”标签页中,点击“浏览”标签,然后在搜索框中输入“log4net”,选择搜索结果中的“log4net”,然后勾选右侧的“Log4netWCFServiceLibrary”,选择最新稳定版本,然后点击“安装按钮”,如下图所示:
2、安装log4net之后,点击“Log4netWCFServiceLibrary”项目中的Properties节点,然后双击打开“AssemblyInfo.cs”文件,在该文件最后添加以下一行代码:
[assembly: log4net.Config.XmlConfigurator(ConfigFile = "Log4Net.config", Watch = true)]
3、双击打开“Log4netWCFServiceLibrary”项目中的“Service1.cs”,修改代码如下所示:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text; namespace Log4netWCFServiceLibrary
{
// 注意: 使用“重构”菜单上的“重命名”命令,可以同时更改代码和配置文件中的类名“Service1”。
public class Service1 : IService1
{
private static log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
public string GetData(int value)
{
log.Debug("debug!");
log.Info("info!");
log.Warn("warn!");
log.Error("error!");
log.Fatal("fatal!");
return string.Format("You entered: {0}", value);
} public CompositeType GetDataUsingDataContract(CompositeType composite)
{
if (composite == null)
{
throw new ArgumentNullException("composite");
}
if (composite.BoolValue)
{
composite.StringValue += "Suffix";
}
return composite;
}
}
}
4、在“Log4netWCFService”项目中添加一个名为“Log4net.config”的配置文件,我们在其中配置按日期切分日志文件,并且将日期作为日志文件名称的一部分,具体配置文件如下所示:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
</configSections> <system.web>
<compilation debug="true" targetFramework="4.5.2" />
<httpRuntime targetFramework="4.5.2" />
</system.web> <log4net>
<!-- 将日志以回滚文件的形式写到文件中 -->
<!-- 按日期切分日志文件,并将日期作为日志文件的名字 -->
<appender name="RollingFileAppenderNameByDate" type="log4net.Appender.RollingFileAppender">
<!-- 日志文件存放位置,可以为绝对路径也可以为相对路径 -->
<file value="C:\Logs\" />
<!-- 将日志信息追加到已有的日志文件中-->
<appendToFile value="true" />
<!-- 最小锁定模式,以允许多个进程可以写入同一个文件 -->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!-- 指定按日期切分日志文件 -->
<rollingStyle value="Date" />
<!-- 日志文件的命名规则 -->
<datePattern value=""WCFLogs_"yyyyMMdd".log"" />
<!-- 当将日期作为日志文件的名字时,必须将staticLogFileName的值设置为false -->
<staticLogFileName value="false" /> <layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
</layout>
</appender> <root>
<!-- 控制级别,由低到高:ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF -->
<!-- 比如定义级别为INFO,则INFO级别向下的级别,比如DEBUG日志将不会被记录 -->
<!-- 如果没有定义LEVEL的值,则缺省为DEBUG -->
<level value="ALL" />
<!-- 按日期切分日志文件,并将日期作为日志文件的名字 -->
<appender-ref ref="RollingFileAppenderNameByDate" />
</root>
</log4net>
</configuration>
5、重新发布“Log4netWCFService”项目到IIS上,重新发布时只需点击【发布】菜单,然后点击“发布”按钮即可。
6、运行“Client”控制台应用程序,运行完毕后,我们就可以在C:\Logs\目录下看到名为“WCFLogs_20161215.log”的日志文件,有可能日期不一样。
至此,如何在WCF应用中使用log4net就讲到这儿,祝大家顺利实现!