第一讲:WCF介绍
链接:https://pan.baidu.com/s/15Al0OwVpjMX8TRbOFB7qZg 提取码:o835
软件架构的设计经历了 从面向对象程序,到面向组件程序设计,再到面向服务程序设计。
这3种方式都致力于同一个目标:封装和重用。
1.面向对象程序设计:类封装功能并提供代码重用。
2.面向组件程序设计:用以共享封装了可重用类的二进制文档。最初,这一点只是针对本机,随着COM,DCOM,和.NET Remoting的问世,才发展到分布式环境。虽然这些分布式的方法不尽相同,但是都可以实现跨进程、跨机器。 面向组件程序设计有很多局限性,但是最明显的局限是与一些特定技术的耦合过深。JAVA客户端如何调用COM组件,.NET如何调用EJB,这些局限的产生均是协议和通信格式的问题。( 解释 技术的耦合过深: 例如我们的客户端是个Net技术开发的程序,服务端是一个EJB的技术,那么就不能进行通信的。 再例如,我们的客户端是一个Java技术开发的程序,那么就无法与服务端的COM组件进行通信。 这些都是因为相互之间的协议以及通信方式的不同所导致的)
3.面向服务程序设计:解决了不同客户之间的通信,也就是不必担心彼此采用了不同的技术。(面向服务程序设计解决了面向组件的弊端,不管是什么样的客户端都可以去访问服务端的程序 )
例如下图 [ 1-01 ]
不同的客户端以及应用程序都可以访问服务端A,B,C。
当然还有其它的理解,可以通过上网去查一些资料。
宿(Service Hosting)
1.自我寄宿(self-Hosting)
2.IIS寄宿(寄宿进程为IIS的工作进程W3wp.exe)
我们来看一个Demo ,在这个例子中,我们将实现一个简单的计算服务。客户端和服务通过运行在同一台机器上不同进程模拟。(和传统的分布式通信框架一样,WCF本质上提供一个跨进程、跨机器以致网路的服务调用)
这个例子可以看到 寄宿的 第一种情况 自我寄宿
第一步
先看构建的整个解决方案(说了这是只是先去看不去搭建):
1: Contracts:一个类库项目,定义服务契约(Service Contract)
2: Services:一个类库项目,提供对WCF服务的实现
3: Hosting:一个控制台应用,实现对定义在 Services项目中的服务的寄宿
4: Client:一个控制台应用模拟服务的客户端
通过VS创建一个空白的解决方案,添加4个项目。项目的类型,承载的功能和相互引用的关系如下,整个项目的结构如下:
1:Contracts:一个类库项目,定义服务契约(Service Contract), 引用System.ServiceMode程序集(WCF框架的绝大部分实现和API定义在该程序集中)
2:Services:一个类库项目,提供对WCF服务的实现。定义在该项目中的所有WCF服务实现了定义在Contracts中相应的服务契约,所以Services具有对Contracts项目的引用。
3:Hosting:一个控制台应用,实现对定义在Services项目中的服务的寄宿,该项目需要同时应用Contracts和Services两个项目和System.ServiceMode程序集。
4:Client:一个控制台应用模拟服务的客户端,该项目引用System.ServiceMode程序集。
[ 1-07 ]
第二步
从功能上讲,服务契约抽象了服务提供的所有操作,而站在消息交换的角度来看,服务契约则定义了基于服务调用的消息交换过程
一般地,我们通过接口的形式定义服务契约。WCF广泛采用基于自定义特性的声明编程模式,我们通过在接口上应用System.ServiceModel.ServiceContractAttribute特性将一个接口定义成服务契约。在应用ServiceContractAttribute特性的同时,还可以指定服务契约的名称和命名空间。通过应用ServiceContractAttribute特性将接口定义成服务契约之后,接口的方法成员并不能自动成为服务的操作。在此方面,WCF采用的是显示选择的策略:我们须要在相应的操作方法上面显示地应用OperationContractAttribute特性。
(上面的两句话什么意思呢?我们这里看一遍理解个大概不去深究,将整个Demo看完之后回来再看一遍上面的两句话就理解了,也不去管服务契约(契约 分 服务契约、数据契约、消息契约、错误契约),因为后面我们会说到,这里就把契约它看成程序中定义的接口就成了)
1 using System; 2 using System.Collections.Generic; 3 using System.Linq; 4 using System.ServiceModel; 5 using System.Text; 6 using System.Threading.Tasks; 7 8 namespace Contracts 9 { 10 11 [ServiceContract] 12 public interface ICalculator 13 { 14 [OperationContract] 15 double Add(double x, double y); 16 } 17 }
第三步
创建服务 Services
当服务契约创建成功时,我们需要通过实现服务契约来创建具体的WCF服务。WCF服务CalculatorService定义在Services项目中,实现了服务契约接口ICalculator,实现了所有的服务操作.
1 using System; 2 using System.Collections.Generic; 3 using System.Linq; 4 using System.Text; 5 using System.Threading.Tasks; 6 using Contracts; 7 8 namespace Services 9 { 10 public class CalculatorService : ICalculator 11 { 12 public double Add(double x, double y) 13 { 14 return x + y; 15 } 16 } 17 }
WCF服务需要依存一个运行着的进程(宿主),服务寄宿就是为服务指定一个宿主的过程。WCF是一个基于消息的通信框架,采用基于终结点(Endpoint)的通信手段。
1:地址(Address):地址决定了服务的位置,服务寻址的问题。
2:绑定(Binding):实现了通信的所有的细节,包括网络传输,消息编码等。
3:契约(Contract):契约是对服务操作的抽象,也是对消息交换模式以及消息结构的定义。
Endpoint=ABC ( Address 、Binding、Contract) 后面说的 EndPoint 就是指配置 A,B,C
服务寄宿的目的就是开启一个进程,为WCF服务提供一个运行的环境
1 using System; 2 using System.Collections.Generic; 3 using System.Linq; 4 using System.ServiceModel; 5 using System.ServiceModel.Description; 6 using System.Text; 7 using System.Threading.Tasks; 8 using Contracts; 9 using Services; 10 11 namespace Hosting 12 { 13 class Program 14 { 15 static void Main(string[] args) 16 { 17 //首先提供一个主机进程,实际上就是完成寄宿的主机( CalculatorService 完成了对契约的实现,所以我们这里就寄宿就寄宿它了 ) 18 using (var host = new ServiceHost(typeof(CalculatorService))) 19 { 20 /* 21 然后 当我们把寄宿后,就要完成我们的EndPoint(终结点) 了,之前提过EndPoint=A,B,C 那么这里就要绑定了 22 之前的图片 [ 1-05 ] 已经展示 过这个 EndPoint 23 这里的 WSHttpBinding 就是 指定 HTTP 协议 当然还有很多种,后面说到 24 添加终结点 首先 C,然后 B 最后 A 25 */ 26 host.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), "http://127.0.0.1:6666/calculatorservice"); 27 28 //这里检测 元数据 为不为空 这里的元数据也不管是什么东西,下面我们说到 29 if (host.Description.Behaviors.Find<ServiceMetadataBehavior>() == null) 30 { 31 //也就是说这里我们是以元数据的形式发布出去进行客户端与服务器的交互 32 //控制服务元数据和相关信息的发布 33 ServiceMetadataBehavior behavior = new ServiceMetadataBehavior(); 34 behavior.HttpGetEnabled = true;//是否可以通过 HTTP Get 形式 去访问 35 // 元数据的地址,可以通过这个地址 在 浏览器中 进行访问 36 behavior.HttpGetUrl = new Uri("http://127.0.0.1:6666/calculatorservice/metadata"); 37 //添加到元数据中去 38 host.Description.Behaviors.Add(behavior); 39 } 40 //指定一个事件,当服务启动之后 需要做什么,这里指定一个委托,在 Open 成功后,就执行这里的事件 41 host.Opened += (sender, eventArgs) => Console.WriteLine("服务已经启动,按任何按钮停止"); 42 //开启服务 43 host.Open(); 44 Console.Read(); 45 } 46 } 47 } 48 }
到这里 我们服务器 部分 就完成了
接下来我们调试一下:
[ 1-08 ]
图片上传不成功,博客园不允许上传10M以上的图片。这么多年,博客园都没有好好更新下,我觉得挺让人窝火的。
好,非常成功。
我们直接在 浏览器中去访问: http://127.0.0.1:6666/calculatorservice/metadata
呈现出来的
1 <?xml version="1.0" encoding="UTF-8"?> 2 <wsdl:definitions xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:wsa10="http://www.w3.org/2005/08/addressing" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:msc="http://schemas.microsoft.com/ws/2005/12/wsdl/contract" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:wsap="http://schemas.xmlsoap.org/ws/2004/08/addressing/policy" xmlns:wsx="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:tns="http://tempuri.org/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://tempuri.org/" name="CalculatorService"> 3 <wsp:Policy wsu:Id="WSHttpBinding_ICalculator_policy"> 4 <wsp:ExactlyOne> 5 <wsp:All> 6 <sp:SymmetricBinding xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 7 <wsp:Policy> 8 <sp:ProtectionToken> 9 <wsp:Policy> 10 <sp:SecureConversationToken sp:IncludeToken="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient"> 11 <wsp:Policy> 12 <sp:RequireDerivedKeys/> 13 <sp:BootstrapPolicy> 14 <wsp:Policy> 15 <sp:SignedParts> 16 <sp:Body/> 17 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="To"/> 18 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="From"/> 19 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="FaultTo"/> 20 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="ReplyTo"/> 21 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="MessageID"/> 22 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="RelatesTo"/> 23 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="Action"/> 24 </sp:SignedParts> 25 <sp:EncryptedParts> 26 <sp:Body/> 27 </sp:EncryptedParts> 28 <sp:SymmetricBinding> 29 <wsp:Policy> 30 <sp:ProtectionToken> 31 <wsp:Policy> 32 <sp:SpnegoContextToken sp:IncludeToken="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient"> 33 <wsp:Policy> 34 <sp:RequireDerivedKeys/> 35 </wsp:Policy> 36 </sp:SpnegoContextToken> 37 </wsp:Policy> 38 </sp:ProtectionToken> 39 <sp:AlgorithmSuite> 40 <wsp:Policy> 41 <sp:Basic256/> 42 </wsp:Policy> 43 </sp:AlgorithmSuite> 44 <sp:Layout> 45 <wsp:Policy> 46 <sp:Strict/> 47 </wsp:Policy> 48 </sp:Layout> 49 <sp:IncludeTimestamp/> 50 <sp:EncryptSignature/> 51 <sp:OnlySignEntireHeadersAndBody/> 52 </wsp:Policy> 53 </sp:SymmetricBinding> 54 <sp:Wss11> 55 <wsp:Policy/> 56 </sp:Wss11> 57 <sp:Trust10> 58 <wsp:Policy> 59 <sp:MustSupportIssuedTokens/> 60 <sp:RequireClientEntropy/> 61 <sp:RequireServerEntropy/> 62 </wsp:Policy> 63 </sp:Trust10> 64 </wsp:Policy> 65 </sp:BootstrapPolicy> 66 </wsp:Policy> 67 </sp:SecureConversationToken> 68 </wsp:Policy> 69 </sp:ProtectionToken> 70 <sp:AlgorithmSuite> 71 <wsp:Policy> 72 <sp:Basic256/> 73 </wsp:Policy> 74 </sp:AlgorithmSuite> 75 <sp:Layout> 76 <wsp:Policy> 77 <sp:Strict/> 78 </wsp:Policy> 79 </sp:Layout> 80 <sp:IncludeTimestamp/> 81 <sp:EncryptSignature/> 82 <sp:OnlySignEntireHeadersAndBody/> 83 </wsp:Policy> 84 </sp:SymmetricBinding> 85 <sp:Wss11 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 86 <wsp:Policy/> 87 </sp:Wss11> 88 <sp:Trust10 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 89 <wsp:Policy> 90 <sp:MustSupportIssuedTokens/> 91 <sp:RequireClientEntropy/> 92 <sp:RequireServerEntropy/> 93 </wsp:Policy> 94 </sp:Trust10> 95 <wsaw:UsingAddressing/> 96 </wsp:All> 97 </wsp:ExactlyOne> 98 </wsp:Policy> 99 <wsp:Policy wsu:Id="WSHttpBinding_ICalculator_Add_Input_policy"> 100 <wsp:ExactlyOne> 101 <wsp:All> 102 <sp:SignedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 103 <sp:Body/> 104 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="To"/> 105 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="From"/> 106 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="FaultTo"/> 107 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="ReplyTo"/> 108 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="MessageID"/> 109 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="RelatesTo"/> 110 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="Action"/> 111 </sp:SignedParts> 112 <sp:EncryptedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 113 <sp:Body/> 114 </sp:EncryptedParts> 115 </wsp:All> 116 </wsp:ExactlyOne> 117 </wsp:Policy> 118 <wsp:Policy wsu:Id="WSHttpBinding_ICalculator_Add_output_policy"> 119 <wsp:ExactlyOne> 120 <wsp:All> 121 <sp:SignedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 122 <sp:Body/> 123 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="To"/> 124 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="From"/> 125 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="FaultTo"/> 126 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="ReplyTo"/> 127 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="MessageID"/> 128 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="RelatesTo"/> 129 <sp:Header Namespace="http://www.w3.org/2005/08/addressing" Name="Action"/> 130 </sp:SignedParts> 131 <sp:EncryptedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"> 132 <sp:Body/> 133 </sp:EncryptedParts> 134 </wsp:All> 135 </wsp:ExactlyOne> 136 </wsp:Policy> 137 <wsdl:types> 138 <xsd:schema targetNamespace="http://tempuri.org/Imports"> 139 <xsd:import namespace="http://tempuri.org/" schemaLocation="http://127.0.0.1:6666/calculatorservice/metadata?xsd=xsd0"/> 140 <xsd:import namespace="http://schemas.microsoft.com/2003/10/Serialization/" schemaLocation="http://127.0.0.1:6666/calculatorservice/metadata?xsd=xsd1"/> 141 </xsd:schema> 142 </wsdl:types> 143 <wsdl:message name="ICalculator_Add_InputMessage"> 144 <wsdl:part name="parameters" element="tns:Add"/> 145 </wsdl:message> 146 <wsdl:message name="ICalculator_Add_OutputMessage"> 147 <wsdl:part name="parameters" element="tns:AddResponse"/> 148 </wsdl:message> 149 <wsdl:portType name="ICalculator"> 150 <wsdl:operation name="Add"> 151 <wsdl:input message="tns:ICalculator_Add_InputMessage" wsaw:Action="http://tempuri.org/ICalculator/Add"/> 152 <wsdl:output message="tns:ICalculator_Add_OutputMessage" wsaw:Action="http://tempuri.org/ICalculator/AddResponse"/> 153 </wsdl:operation> 154 </wsdl:portType> 155 <wsdl:binding name="WSHttpBinding_ICalculator" type="tns:ICalculator"> 156 <wsp:PolicyReference URI="#WSHttpBinding_ICalculator_policy"/> 157 <soap12:binding transport="http://schemas.xmlsoap.org/soap/http"/> 158 <wsdl:operation name="Add"> 159 <soap12:operation style="document" soapAction="http://tempuri.org/ICalculator/Add"/> 160 <wsdl:input> 161 <wsp:PolicyReference URI="#WSHttpBinding_ICalculator_Add_Input_policy"/> 162 <soap12:body use="literal"/> 163 </wsdl:input> 164 <wsdl:output> 165 <wsp:PolicyReference URI="#WSHttpBinding_ICalculator_Add_output_policy"/> 166 <soap12:body use="literal"/> 167 </wsdl:output> 168 </wsdl:operation> 169 </wsdl:binding> 170 <wsdl:service name="CalculatorService"> 171 <wsdl:port name="WSHttpBinding_ICalculator" binding="tns:WSHttpBinding_ICalculator"> 172 <soap12:address location="http://127.0.0.1:6666/calculatorservice"/> 173 <wsa10:EndpointReference> 174 <wsa10:Address>http://127.0.0.1:6666/calculatorservice</wsa10:Address> 175 <Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"> 176 <Upn>DESKTOP-K3KFPAM\xujunheng</Upn> 177 </Identity> 178 </wsa10:EndpointReference> 179 </wsdl:port> 180 </wsdl:service> 181 </wsdl:definitions>
其实就是 WSDL 元数据