学习 WCF (4)--学会使用配置文件

   无论是Web应用程序还是Win应用程序，我们都会经常用到配置文件。WCF作为分布式开发的基础框架，在定义服务以及定义消费服务的客户端时，都使用了配置文件的方法。配置文件的重要性和实用性是大家所熟知的，它可以给我们WCF开发的灵活性上带来很大的提高。下面说说我学习使用配置文件的所得。

   WCF的配置使用.NET Framework的System.Configuration配置系统。在Visual Studio中配置一个WCF服务时，如果是自托管宿主或Windows Services宿主
，则配置文件为App.confing，如果是IIS宿主，则配置文件为Web.config。

   先来看看简单的system.ServiceModel结构

<system.ServiceModel>

   <services>
      <service>
         <endpoint/>
      </service>
   </services>

   <bindings>
   <!—定义一个或多个系统提供的binding元素，例如<basicHttpBinding> --> 
   <!—也可以是自定义的binding元素，如<customBinding>. -->
      <binding>
      <!—例如<BasicHttpBinding>元素. -->
      </binding>
   </bindings>

   <behaviors>
   <!—一个或多个系统提供的behavior元素. -->
      <behavior>
      <!—例如<throttling>元素. -->
      </behavior>
   </behaviors>

</system.ServiceModel>

(1)<services>

服务是在配置文件的 services 节中定义的。每个服务都有自己的 service 配置节。在Service中定义特定服务的address，binding，contract（也就是传说中重要的ABC）。

        <services>
            <service name="WCFStudent.WCFStudentText" behaviorConfiguration="ServiceBehavior">
                <endpoint address="" binding="wsHttpBinding" contract="WCFStudent.IStuServiceContract"></endpoint>
                <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
            </service>
        </services>

<!--一个Service中可以有多个endpoint，这样就可以同时定制多个服务。如果address值为空，那么endpoint的地址就是默认的基地址（Base Address）。那么则需要在host中声明Base Address-->

(2)<bindings>

此节包含标准绑定和自定义绑定的集合。每一项都是一个可由其唯一 name 进行标识的 binding 元素。服务通过用 name 与绑定进行链接来使用绑定。

个人感觉比较常用的是<basicHttpBinding>,<basicHttpBinding>等。由于属性比较多，在这里就不一一说明了。

<bindings>
      <basicHttpBinding>
        <binding name="IStuServiceContract" closeTimeout="00:01:00"
                    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
                    bypassProxyOnLocal="false" transactionFlow="false" hostNameComparisonMode="StrongWildcard"
                    maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
                    messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true"
                    allowCookies="false">
      </basicHttpBinding>
    </bindings>
<!--相应属性的设置大家可以参看MSDN.
http://msdn.microsoft.com/zh-cn/library/ms731361.aspx-->

(3)<behaviors>

此元素定义名为 endpointBehaviors 和 serviceBehaviors 的两个子集合。每个集合分别定义终结点和服务所使用的行为元素。每个行为元素由其唯一的 name 属性标识。如果需要指定服务在执行方面的相关特性时，就必须定义服务的behavior。在WCF中，定义behavior就可以设置服务的运行时属性，甚至于通过自定义behavior插入一些自定义类型。

<behaviors>
            <serviceBehaviors>
                <behavior name="ServiceBehavior">
                    <!-- 为避免泄漏元数据信息，请在部署前将以下值设置为 false 并删除上面的元数据终结点  -->
                    <serviceMetadata httpGetEnabled="true"/>
                    <!-- 要接收故障异常详细信息以进行调试，请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息-->
                    <serviceDebug includeExceptionDetailInFaults="false"/>
                </behavior>
            </serviceBehaviors>
        </behaviors>

(4)<client>

 有的时候我们还需要定义<client>节点，主要定义客户端可以连接的终结点的列表。

<client>
            <endpoint address="http://localhost:39113/WCFServiceText/WCFStudentText.svc"
                binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_IStuServiceContract"
                contract="ServiceReference1.IStuServiceContract" name="WSHttpBinding_IStuServiceContract">
                <identity>
                    <dns value="localhost" />
                </identity>
            </endpoint>
        </client>

<!--如果宿主是IIS，WIN应用程序调用WCF时，会自动在App.config中生成<client>节的设置-->

 

三种宿主形式的配置文件的声明基本上一样。如果使用svcutil.exe生成客户程序，会在svcutil.exe的根目录中生成一个配置文件，值得大家一看：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <bindings>
            <wsHttpBinding>
                <binding name="WSHttpBinding_IStuServiceContract" closeTimeout="00:01:00"
                    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
                    bypassProxyOnLocal="false" transactionFlow="false" hostNameComparisonMode="StrongWildcard"
                    maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
                    messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true"
                    allowCookies="false">
                    <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
                        maxBytesPerRead="4096" maxNameTableCharCount="16384" />
                    <reliableSession ordered="true" inactivityTimeout="00:10:00"
                        enabled="false" />
                    <security mode="Message">
                        <transport clientCredentialType="Windows" proxyCredentialType="None"
                            realm="" />
                        <message clientCredentialType="Windows" negotiateServiceCredential="true"
                            algorithmSuite="Default" establishSecurityContext="true" />
                    </security>
                </binding>
            </wsHttpBinding>
        </bindings>
        <client>
            <endpoint address="http://localhost:39113/WCFServiceText/WCFStudentText.svc"
                binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_IStuServiceContract"
                contract="IStuServiceContract" name="WSHttpBinding_IStuServiceContract">
                <identity>
                    <dns value="localhost" />
                </identity>
            </endpoint>
        </client>
    </system.serviceModel>
</configuration>