WCF学习笔记 (一)
2010-09-10 by 嘉瑜, Category: 码农日记, Tags: C#, WCF No Comments 92次浏览
客户突然需要我将之前做的AutoCompleteWebCtrl的Service Custom Control与WCF结合起来，good, I’d like to take challenges, esp., the new tech, though WCF exists for 4 years already.
WCF – Windows Communication Foundation，包含Web Service, MSMQ等，本文涵盖的重点知识为，
1. ABC (Address, Binding, Contract) ，MSDN参考，Binding与Contract来决定endpoint，
2. web.config配置，MSDN这篇讲得很清楚
3. 各种Contract(契约)与实现方法
4. svc文件与IIS Host
选择Binding的依据流程（还有一种webHttpBinding没包含进去）：
(图片选自 《Programming WCF Services》)
1. 几个参考站点：
Windows Communication Foundation is.. (微软开发中心)
Security in Windows Communication Foundation
Extending WCF with Custom Behaviors (微软MSDN杂志文)
我的WCF之旅 by Artecth
Essential WCF by Addison Wesley
2. 定义WCF六件事 （MSDN链接）：
1) 创建/定义服务契约（Service Contract）- 设计它
2) 实现服务契约
3) Host & Consume WCF服务
4) 创建WCF服务客户端
5) 配置
6) 使用WCF服务客户端
一、ABC
1. System-built Bindings类型 – 参考见：
<service behaviorConfiguration=”MyServiceBehavior” name=”MyService”>
<endpoint address=”” （可以预先设置endpoint地址，可一般不会这么设置，简化配置）
binding=”basicHttpBinding” （绑定协议）
contract=”ICalculator” （对应的Service Contract Interface, namespace.methodname）
bindingConfiguration=”MyBindingConfig” />（对应下列绑定配置，一般用于CustomBinding类型）
<endpoint address=”mex”
binding=”mexHttpBinding”(元数据绑定协议，如何使用配置文件发布WCF元数据？| 用户安全元数据endpoint）
contract=”IMetadataExchange”/>
</service>
<protocolMapping>
<add scheme=”http” binding=”basicHttpBinding” bindingConfiguration=”MyBindingConfiguration”/>
<add scheme=”net.tcp” binding=”netTcpBinding”/>
<add scheme=”net.pipe” binding=”netNamedPipeBinding”/>
<add scheme=”net.msmq” binding=”netMSMQBinding”/>
</protocolMapping>
i) BasicHttpBinding — WS-I基本绑定，不实现任何高级使用SOAP协议的WS-*规则，所给出的安全选项较少。
ii) WSHttpBinding — 实现高级WS-*规则，包括WS-Addressing (WS-寻址), WS-Security，使得Message可用，但同时减少了服务和客户 (customers) 的到达量。它是基于SOAP1.2和WS-寻址规则，WS-Trust and WS Secure conversation.
iii) WebHttpBinding — 使用HTTP requests而非SOAP messages来指定endpoints. 一般用于jQuery的ajax (如autocomplete)，HTTP requests使用的是”plain Old XML” (POX),与WebHttpBinding相匹配的behavior为WebHttpBehavior，需要在[OperationContract]中使用WebGet/WebInvoke来配置Http传输属性（如ResponseType,BodyStyle）- 这个是现在的重点学习内容之一。
iv) NetTcpBinding — A secure, reliable binding suitable for cross-machine communication.
自定义绑定 (Custom Bindings)，参考资源：
如果将endpoint的绑定类型设置为CustomBinding，如
<endpoint addres=""
binding="customBinding(自定义绑定类型)"
bindingConfiguration="自定义绑定的设置名" />
则须配置自定义绑定如下：
<bindings>
<customBinding>
<binding name = "自定义绑定的设置名">
（如下绑定元素binding element按顺序设置，不必每个出现）
【事务流, Trasaction flow】
【（会话）可靠性（有序性）, (Session) Reliability】
【安全性, Security】
【传输, Transport】
【编码, Encoding】
</binding>
<customBinding>
</bindings>
二、Web.Config配置
1. 在这儿了解endpoint配置指南
2. endpoint格式: scheme://machine:port/path
三、Implementation
一个WCF Service需要几种contract,
1. [ServiceContract]
2. [OperationContract]
3. [DataContract]
四、svc文件与IIS Host
1. 使用svcutil工具，
五、总结：
设定ServiceContract属性的NameSpace参数。这一点非常重要。客户端用于调用WCF服务的代理的名字空间就是从这里拿的。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.ServiceModel>
<!-- services 元素包含应用中驻留的所有service的配置要求 -->
<services>
<!-- 每个服务的配置
属性说明:
name - 指定这个service配置是针对的那个服务,为一个实现了某些Contract的服务类的完全限定名
(名称空间.类型名),ServiceHost载入一个服务后，会到配置文件中的<services>下找有没有
name属性跟服务匹配的<service>的配置
behaviorConfiguration - 指定在<serviceBehaviors>下的一个<behavior>的name,这个特定<behavior>
给这个service制定了一些行为,比如服务是否允许身份模拟-->
<service name="名称空间.类型名" behaviorConfiguration="behavior名">
<host>
<baseAddresses>
<!-- 在此可以定义每种传输协议的baseAddress，用于跟使用同样传输协议Endpoint定义的相对地
址组成完整的地址，但是每种传输协议只能定义一个baseAddress。HTTP的baseAddress同时是service
对外发布服务说明页面的URL-->
<add baseAddress="http://address" />
</baseAddresses>
<timeouts></timeouts>
</host>
<!-- 每个服务可以有多个Endpoint，下面<endpoint>元素对每个Endpoint分别进行配置
属性说明:
address - 指定这个Endpoint对外的URI,这个URI可以是个绝对地址，也可以是个相对于baseAddress的
相对地址。如果此属性为空，则这个Endpoint的地址就是baseAddress
binding - 指定这个Endpoint使用的binding，这个banding可以是系统预定义的9个binding之一，
比如是basicHttpBinding，也可以是自定义的customBinding。binding决定了通讯的类型、
安全、如何编码、是否基于session、是否基于事务等等
contract - 指定这个Endpoint对应的Contract的全限定名(名称空间.类型名)，这个Contract应该被
service元素的name指定的那个service实现
bindingConfiguration - 指定一个binding的配置名称，跟<bindings>下面同类<binding>的name匹配
behaviorConfiguration - 指定这个endpoint的behavior，指向<behaviors>下的同样配置名称的<endpointBehaviors>
name - Endpoint的名称，可选属性，每个Contract都可以有多个Endpoint，但是每个Contract对应的
多个Endpoint名必须是唯一的-->
<endpoint address="URI" binding="basicHttpBinding" contract="Contract全限定名" bindingConfiguration="binding名" behaviorConfiguration="String" name="">
<!-- 用户定义的xml元素集合，一般用作SOAP的header内容-->
<headers>
<!-- 任何xml内容 -->
</headers>
</endpoint>
</service>
</services>
<bindings>
<!-- 指定一个或多个系统预定义的binding，比如<basicHttpBinding>，当然也可以指定自定义的customBinding，
然后在某个指定的binding下建立一个或多个配置，以便被Endpoint来使用这些配置 -->
<basicHttpBinding>
<!-- 某一类的binding的下面可能有多个配置，binding元素的name属性标识某个binding-->
<binding name="binding名">
</binding>
</basicHttpBinding>
</bindings>
<!-- 定义service和Endpiont行为-->
<behaviors>
<!-- 定义service的行为-->
<serviceBehaviors>
<!-- 一个或多个系统提供的或定制的behavior元素
属性说明：
name - 一个behavior唯一标识,<service>元素下<endpoint>的behaviorConfiguration属性指向这个name-->
<behavior. name="此Behavior名称">
<!-- 指定service元数据发布和相关信息
属性说明：
httpGetEnabled - bool类型的值，表示是否允许通过HTTP的get方法获取sevice的WSDL元数据
httpGetUrl - 如果httpGetEnabled为true，这个属性指示使用哪个URL地址发布服务的WSDL，
如果这个属性没有设置，则使用服务的HTTP类型的baseAddress后面加上?WSDL-->
<serviceMetadata httpGetEnabled="true" httpGetUrl="http://URI:port/address" />
<!--指定验证服务端的凭据-->
<serviceCredentials>
<!--指定服务端的证书
属性说明：
storeName - 证书的存储区，可能值为：AddressBook，AuthRoot，CertificateAuthority
Disallowed，My，Root，TrustedPeople，TrustedPublisher
storeLocation - 证书存储位置，可能值为：CurrentUser，LocalMachine
x509FindType - 查找证书的方式，可能的值：FindBySubjectName，FindByThumbPrint，FindByIssuerName......
findValue - 对应查找方式的要查找证书的值 -->
<serviceCertificate storeName="存储区" storeLocation="存储位置" x509FindType="FindBySubjectName" findValue="server1" />
</serviceCredentials>
</behavior>
</serviceBehaviors>
<!-- 定义Endpiont的行为-->
<endpointBehaviors>
<!-- 一个或多个系统提供的或定制的behavior元素
属性说明：
name - 一个behavior唯一标识,<client>元素下<endpoint>的behaviorConfiguration属性指向这个name-->
<behavior. name="此Behavior名称">
<!--指定客户端的凭据-->
<clientCredentials>
<!--指定客户端的证书
属性说明：
storeName - 证书的存储区，可能值为：AddressBook，AuthRoot，CertificateAuthority
Disallowed，My，Root，TrustedPeople，TrustedPublisher
storeLocation - 证书存储位置，可能值为：CurrentUser，LocalMachine
x509FindType - 查找证书的方式，可能的值：FindBySubjectName，FindByThumbPrint，FindByIssuerName......
findValue - 对应查找方式的要查找证书的值 -->
<clientCertificate storeName="存储区" storeLocation="存储位置" x509FindType="FindBySubjectName" findValue="Client1" />
<serviceCertificate>
<authentication certificateValidationMode="None" />
</serviceCertificate>
</clientCredentials>
</behavior>
</endpointBehaviors>
</behaviors>
<!-- 包含客户端跟服务端连接使用到的Endpoint的配置 -->
<client>
<!-- 每个客户端Endpoint设置
属性说明：
address - 对应到服务端这个Endpoint的address
binding - 指定这个Endpoint使用的binding，这个banding可以是系统预定义的9个binding之一，
比如是basicHttpBinding
contract - 指定这个Endpoint对应的Contract的全限定名(名称空间.类型名)
name - Endpoint的配置名，客户端代理类的构造方法中的endpointConfigurationName对应到这个name
bindingConfiguration - 指定客户端binding的具体设置，指向<bindings>元素下同类型binding的name
behaviorConfiguration - 指定这个endpoint的behavior，指向<behaviors>下的同样配置名称的<endpointBehaviors>-->
<endpoint address="URI" binding="basicHttpBinding" bindingConfiguration="binding名" behaviorConfiguration="String" contract="Contract全限定名" name="endpoint配置名" >
<!-- 用于客户端验证服务端身份,可选以下一种方式验证服务端-->
<identity>
<userPrincipalName></userPrincipalName>
<servicePrincipalName></servicePrincipalName>
<!--如果客户端验证是windows,这里指定DNS名;如果是Certificate，这里指定证书subject name-->
<dns></dns>
<rsa></rsa>
<!--指定服务端证书的公钥
属性说明：
encodedValue - 服务端证书的公钥的base64编码，用于加密用户名和密码-->
<certificate encodedValue=""></certificate>
<!-- 用户指定在客户端证书存储区内的服务端证书
属性说明：
storeName - 证书的存储区，可能值为：AddressBook，AuthRoot，CertificateAuthority
Disallowed，My，Root，TrustedPeople，TrustedPublisher
storeLocation - 证书存储位置，可能值为：CurrentUser，LocalMachine
x509FindType - 查找证书的方式，可能的值：FindBySubjectName，FindByThumbPrint，FindByIssuerName......
findValue - 对应查找方式的要查找证书的值 -->
<certificateReference storeName="存储区" storeLocation="存储位置" x509FindType="FindBySubjectName" findValue="Client1" />
</identity>
</endpoint>
</client>
</system.ServiceModel>
</configuration>
