企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
通常我们去大保健的时候,都会找姑娘问一下这里能提供什么服务,什么价格,这时候可能姑娘会跟你口述一些服务或者提供一份服务清单,这样的话大 家就可以做到童嫂无欺,这样一份活生生的例子,在wcf中同样是一个道理,只有client了解service能提供哪些功能,client才可以根据server提供的功能进行 消费,那问题来了,service怎么把功能提供给client进行选择呢???这个就是我这一篇要聊的wsdl(web service description language)。。。 ## 一:wsdl    现在你已经知道了,wsdl就是server提供给client的清单,那下面问题就来了。server是如何提供的呢???你要是比较仔细的话,可能会知道我在上一 篇提到的一个endpoint,如下截图。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d0f31e3.png) 在上面这幅图中,你可以看到,Homeservice提供了两个端点,一个是“服务端点“,一个是“元数据端点”。并且你也看到了,元数据的端点地址是 http://192.168.16.16:19200/mex,当client通过svcutil访问这个地址的时候,就拿到了server能提供的功能清单,然后client就可以根据这些功能生成一 个代理文件,然后的然后,就是你懂得,各种啪啪啪,XXXClient。 ## 二:眼见为实 1.见证wsdl  要想看见wsdl,你只需要通过http://localhost:19200打开服务地址、如下图: ![](https://box.kancloud.cn/2015-08-04_55c0b0d128506.png) 然后点击:http://localhost:19200/?singleWsdl ![](https://box.kancloud.cn/2015-08-04_55c0b0d1769dd.png) 现在你看到的就是server功能清单,太tmd的重量级了,已经完完全全果体在世人前了,下一小节我们再详细的分析下。 2\. 见证client端的XXXclient   刚才我也说了,当你用vs做“服务引用”的时候,svcutil会根据http://localhost:19200/mex的地址来查看wsdl,然后生成代理,下面我们具体来看一下。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d1909fe.png) 点击确定之后,我们就可以看到在 Service References 文件夹下面生成了一个Reference.cs 文件。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d20a31b.png) 然后我们打开Reference.cs,就可以看到一个继承于ClientBase的HomeServiceClient。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d22e176.png) ## 三:详细分析wsdl文件   学wcf,你一定要像svcutil一样能够看得懂wsdl。 1\. 首先看下server提供了一个Update操作,参数是一个id,一个Student这个自定义的复杂类型,同时返回也是Student这个     复杂类型。 ~~~ namespace MyService { [ServiceContract] public interface IHomeService { [OperationContract] Student Update(int id, Student stu); } } ~~~  2\. wsdl这个xml文件,刚才你也看到了,下面我们一个个节点看看   portType 和 operation节点   当你看到下面的截图后,我想你也能猜的出来,portType就是契约(IHomeService),operation就是契约方法(Update),不过有点意思的是,在operation 下面你看到了一个input,一个output,这个就是所谓的 ”输入消息“,”输出消息”,那是什么意思呢??? 也就是说client到server的消息叫做“输入消息”,server到 client端叫做“输出消息”,到这里你应该似乎明白了,我C#中的Update方法是有入参和出参的,然而这映射到wsdl中就是两条消息,input和output,这个也就是经典 的“请求-响应“模式。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d793dbb.png) 好了,继续往下看,在wsdl:input和wsdl:output中分别有一个Action属性,这个非常有意思,wcf的底层就是通过这个地址来找到对应的方法,比如我们看到的代理 类中的Update方法上面就有这么一段。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d7a8510.png)   message 和 types节点   继续往下看的话,你会发现input和output中还有一个message属性,对应的为IHomeService_Update_InputMessage和IHomeService_Update_OutputMessage, 这个正好是message节点的引用,如下图: ![](https://box.kancloud.cn/2015-08-04_55c0b0d9124e4.png) 从这个图中,你可以看到input和output下面都有一个wsdl:part节点,这个就是表明input和output中需要携带的参数,比如element="tns:Update",就引用了 element中Name=Update的节点,如下图: ![](https://box.kancloud.cn/2015-08-04_55c0b0d927774.png) 好了,最后我再截一张图,可以看到,传输协议为soap,服务地址等等。。。然后就没什么好说的了。 ![](https://box.kancloud.cn/2015-08-04_55c0b0d94079b.png)