前面老周给大伙伴们介绍了把跟踪信息写入日志文件的方法,今天咱们换个类似的话题来扯一下,对了,咱们就说说怎么把WCF的往来消息log下来吧。
尽管在现实生活中,我们不主张偷窥他人信息,不过,偷窥程序信息是一件很快乐的事。
在很多情况下,WCF是用SOAP来完成数据交换的,SOAP是啥,网上搜一搜叫知道了,不要太在意概念,不懂的概念就网上搜,搜到后大致看一下即可。
要是能把WCF服务的每轮通信的SOAP消息记录下来,除了有助于管理服务外,其实还可以帮助我们了解WCF的调用过程(可以看到它与客户端的往来信息)。
好,F话不多说,理论知识老周也不想讲太多,因为这方面是资料可查的。直接上方法吧。
先看服务器的实现。
[ServiceContract(Namespace = "http://cat.org",Name = "_cat")] interface ITest { [OperationContract(Name = "say_to_cat")] string SayHelloToCat([MessageParameter(Name = "pcat")]string catName); } public class MyService : ITest { public string SayHelloToCat(string catName) { return $"{catName} 是一只X猫,从来没抓过老鼠。"; } }
先定义服务协定,然后实现服务类,这个相信大家都会,很Easy,哦,对了,啥是服务协定呢,就是服务器和客户端们签订了一份劳动合同,服务器定义好协定接口后,要应用 ServiceContractAttribute 特性,干吗用的呢,就是指定命名空间和名称,通常这两个参数比较重要,当然,如果不指定,默认的命名空间为http://tempuri.org,默认的名称就是接口的名字。
比如本例,如果不指定名称,那默认就是 ITest,因为接口叫这个名字。
但本例中,已明确指定了命名空间和名称,并且,在操作方法上,也用 OperationContract 特性指名了服务操作的名称,对于方法参数,用 MessageParameter 特性指定了参数名字叫pcat。
服务协定的好处在于,客户端可以重新声明这个接口,但接口名字,方法名字,参数名字可以与服务器的按口不同,只要协定的命名空间,名字等对应即可。
比如,我的客户端可以这样重定义服务协定。
[ServiceContract( Namespace = "http://cat.org", Name = "_cat")] interface IService { [OperationContract(Name = "say_to_cat")] string DoWork([MessageParameter(Name = "pcat")]string cat); }
虽然接口的名字和成员方法的名字不同,但可以与上面的服务协定做同一协定认定,因为它所附加的特性指明了相同的参数,并且操作方法的参数类型和返回值类型也与服务器端相同。
注意,服务协定的接口可以对客户端公开,但服务实现类不需要对外公开,因为它只在服务器上执行,你可以告诉别人银行卡号,但不要连密码也告诉别人。
好,现在用配置文件配置一下服务器,写配置文件的好处是方便修改。
<system.serviceModel> <services> <service name="fuckServer.MyService"> <endpoint address="http://127.0.0.1:950/catsv" binding="basicHttpBinding" contract="fuckServer.ITest"/> </service> </services> </system.serviceModel>
服务器基本完成,那么如何让它可以记录通信消息呢。依然是在配置文件中操作。
a、在configuration节点下写上system.diagnostics节点,这个与配置日志文件差不多。随后配置日志的source为 System.ServiceModel.MessageLogging,具体如下:
<system.diagnostics> <sources> <source name="System.ServiceModel.MessageLogging"> <listeners> <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="wcfLog.svclog"/> </listeners> </source> </sources> </system.diagnostics>
Listeners是配置监听器,和上次我们配置日志文件一样。
b、在 system.serviceModel节点下,声明 diagnostics 节点,然后是 messageLogging 元素,并设置相关属性。
<system.serviceModel> <diagnostics> <messageLogging logEntireMessage="true" logMalformedMessages="false" logMessagesAtServiceLevel="true" logMessagesAtTransportLevel="false" maxMessagesToLog="1000" /> </diagnostics> …… </system.serviceModel>
logEntireMessage 值一定要为 true,这样记录器才能进入到消息内部,才能把整条消息记录下来,否则只会记录外面的空壳。
logMalformedMessages属性表示如果消息的格式不正确,是否也一起记录,可以为false,logMessagesAtServiceLevel表示是否记录服务层面的消息,这个得开启,不然一条消息都捕捉不到;logMessagesAtTransportLevel属性表示是否记录传输层的消息。
如果logMessagesAtServiceLevel开启,那么logMessagesAtTransportLevel可以为false,因为它们都会记录SOAP消息,只是层级不同罢了,当然两个都开启也无所谓。
maxMessagesToLog 表示最大条数,我设为1000,如果记录满1000条,就不再记录了。还可以指定 maxSizeOfMessageToLog 值,单位是字节,它表示日志文件的最大容量,当到达这个容量就不再记录。如果磁盘空间不够,可以指定这个值。
在配置监听器时,使用的类型为 XmlWriterTraceListener ,因为WCF日志是以XML格式存放的,指定文件名时,后缀名用.svclog,为什么呢,因为有专门的工具可以查看日志信息。
配置完成后,运行一次,就可以在Debug目录下看到日志文件了,因为我上面配置时用的是相对路径。然后我们双击日志文件,就会以 Microsoft Service Trace Viewer 程序来打开,这个程序叫 SvcTraceViewer.exe ,在C:Program Files (x86)Microsoft SDKsWindowsxxxxinNETFX xxx Tools 目录下。
打开后就可以看到记录的SOAP消息了。
我只在服务器端配置了记录选项,如果你希望客户端也能记录消息,用同样的方法修改客户端的配置文件就可以了。
好了,今天的F话讲完了,但愿对大伙有0.00003%的帮助。