zoukankan      html  css  js  c++  java
  • 化零为整WCF(19) WCF 4.0 新特性

    [索引页]
    [源码下载]


    化零为整WCF(19) - WCF 4.0 新特性


    作者:webabcd


    介绍
    WCF(Windows Communication Foundation) - WCF 4.0 新特性
    • 简化配置(Simplified configuration) - 根据 baseAddresses 生成默认 endpoint;在应用程序的级别上指定默认的 Binding 配置和 Behavior 配置
    • 不需要 .svc 的物理文件,而直接在 IIS 上托管 WCF 服务
    • 标准终结点(Standard Endpoint) - 内置了 8 个已经定义好相关配置的标准终结点(分别为 mexEndpoint, announcementEndpoint, discoveryEndpoint, udpAnnouncementEndpoint, udpDiscoveryEndpoint, workflowControlEndpoint, webHttpEndpoint, webScriptEndpoint)
    • 通过标准终结点中的 webScriptEndpoint 来提供 ajax 服务 
    • 对 REST 服务支持的增强 
    • 对路由服务,工作流服务,字节流编码,非破坏性队列接收,服务发现的支持 


    示例
    1、概述
    Index.aspx
    代码
    <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Index.aspx.cs" Inherits="WebClient.Index" %>

    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head runat="server">
        
    <title></title>
    </head>
    <body>
        
    <form id="form1" runat="server">
        
    <div>
            
    <p>
                1、简化配置(Simplified configuration) - 根据 baseAddresses 生成默认 endpoint;在应用程序的级别上指定默认的 Binding 配置和 Behavior 配置
                
    <br />
                相关代码位置:host 端在 WinHost 项目,client 端在 WebClient 项目中的 SimplifiedConfiguration.aspx 页面
            
    </p>
            
    <p>
                2、不需要 .svc 的物理文件,而直接在 IIS 上托管 WCF 服务
                
    <br />
                相关代码位置:host 端在 WebHost 项目中的 web.config 文件,client 端在 WebClient 项目中的 IIS_Hosting_Without_SVC_File.aspx 页面
            
    </p>
            
    <p>
                3、标准终结点(Standard Endpoint) - 内置了 8 个已经定义好相关配置的标准终结点(分别为 mexEndpoint, announcementEndpoint, discoveryEndpoint, udpAnnouncementEndpoint, udpDiscoveryEndpoint, workflowControlEndpoint, webHttpEndpoint, webScriptEndpoint)
                
    <br />
                指定标准终结点的方法见 WebHost 项目中的 web.config 文件
            
    </p>
            
    <p>
                4、通过标准终结点中的 webScriptEndpoint 来提供 ajax 服务
                
    <br />
                相关代码位置:host 端在 WebHost 项目中的 web.config 文件,client 端在 WebHost 项目中的 WebScriptEndpointDemo.aspx 页面
            
    </p>
            
    <p>
                5、对 REST 服务支持的增强
                
    <ul>
                    
    <li>
                        通过标准终结点 webHttpEndpoint 来简化配置(详见:WebHost 项目中的 web.config 文件)
                    
    </li>
                    
    <li>
                        通过对 behavior 的配置来为 REST 服务增加 help 页面,在服务地址上加“/help”即可进入 REST 服务的帮助页面(详见:WebHost 项目中的 web.config 文件)
                        
    <br />
                        本例的 REST 服务的帮助页面为 http://localhost:14802/RestDemo.svc/help
                    
    </li>
                    
    <li>
                        为 REST 增加 HTTP 缓存配置(详见:WebHost 项目中的 web.config 文件,ServiceLib 项目的 RestDemo.cs 文件)
                    
    </li>
                
    </ul>
            
    </p>
            
    <p>
                6、路由服务(Routing Service) - WCF 对 Web Services Addressing (WS-Addressing) 规范的实现
            
    </p>
            
    <p>
                7、工作流服务(Workflow Service) - WCF 对 WF (Workflow Foundation) 的支持
            
    </p>
            
    <p>
                8、字节流编码(ByteStream) - 增加了对 ByteStream 的支持。原来只支持 Text, Binary, MTOM
            
    </p>
            
    <p>
                9、非破坏性队列接收(Non-destructive queue receive) - 改进了原有的对 MSMQ(消息队列) 的支持
            
    </p>
            
    <p>
                10、服务发现(WS-Discovery) - 对 WS-Discovery 协议的支持
            
    </p>
        
    </div>
        
    </form>
    </body>
    </html>


    2、简化配置(Simplified configuration)的 Demo
    服务端:Demo.cs
    代码
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;

    using System.ServiceModel;

    namespace ServiceLib
    {
        [ServiceContract]
        
    public interface IDemo
        {
            [OperationContract]
            
    string Hello(string name);
        }

        
    public class Demo : IDemo
        {
            
    public string Hello(string name)
            {
                
    return "Hello: " + name;
            }
        }
    }

    宿主:App.config
    代码
    <?xml version="1.0"?>
    <configuration>
        
    <system.serviceModel>

            
    <!--
                1、如果没有显示配置 endpoint,那么 WCF 会根据 baseAddresses 生成一个默认 endpoint
                2、如果显示配置了 endpoint,那么 WCF 在默认情况下不会根据 baseAddresses 生成默认 endpoint
                3、如果需要强制为每个 baseAddresses 生成默认 endpoint,那么只要调用 ServiceHost.AddDefaultEndpoints() 方法即可(即使显示地指定 endpoint 也会生成默认的 endpoint)
                
                本例生成的默认 endpoint 的配置如下:
                A: http://localhost:1122/
                B: basicHttpBinding
                C: ServiceLib.IDemo
            
    -->
            
    <services>
                
    <service name="ServiceLib.Demo">
                    
    <host>
                        
    <baseAddresses>
                            
    <add baseAddress="http://localhost:1122/"/>
                        
    </baseAddresses>
                    
    </host>
                
    </service>
            
    </services>

            
    <!--
                根据协议类型,指定其所对应的默认 Binding
            
    -->
            
    <protocolMapping>
                
    <add scheme="http" binding="basicHttpBinding"/>
                
    <add scheme="net.tcp" binding="netTcpBinding"/>
                
    <add scheme="net.pipe" binding="netNamedPipeBinding"/>
                
    <add scheme="net.msmq" binding="netMsmqBinding"/>
            
    </protocolMapping>

            
    <!--
                WCF 应用程序的默认 Behavior 配置
            
    -->
            
    <behaviors>
                
    <serviceBehaviors>
                    
    <behavior>
                        
    <serviceMetadata httpGetEnabled="true"/>
                        
    <serviceDebug includeExceptionDetailInFaults="true"/>
                    
    </behavior>
                
    </serviceBehaviors>
            
    </behaviors>

            
    <!--
                WCF 应用程序的默认 Binding 配置
            
    -->
            
    <bindings>
                
    <basicHttpBinding></basicHttpBinding>
                
    <webHttpBinding></webHttpBinding>
                
    <wsHttpBinding>
                    
    <binding>
                        
    <security mode="Message">
                            
    <transport clientCredentialType="None"></transport>
                        
    </security>
                    
    </binding>
                
    </wsHttpBinding>
            
    </bindings>
        
    </system.serviceModel>
        
    <startup>
            
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
        
    </startup>
    </configuration>

    宿主:Form1.cs
    代码
    using System;
    using System.Collections.Generic;
    using System.ComponentModel;
    using System.Data;
    using System.Drawing;
    using System.Linq;
    using System.Text;
    using System.Windows.Forms;

    using System.ServiceModel;
    using System.ServiceModel.Description;

    namespace WinHost
    {
        
    public partial class Form1 : Form
        {
            
    public Form1()
            {
                InitializeComponent();

                
    this.Load += new EventHandler(Form1_Load);
            }

            
    void Form1_Load(object sender, EventArgs e)
            {
                ServiceHost host 
    = new ServiceHost(typeof(ServiceLib.Demo));

                
    // 强制为每个 baseAddresses 生成默认 endpoint(即使显示地指定 endpoint 也会生成默认的 endpoint)
                
    // host.AddDefaultEndpoints();

                
    if (host.State != CommunicationState.Opening)
                    host.Open();

                txtMsg.Text 
    += string.Format("endpoint 的数量: {0}", host.Description.Endpoints.Count);
                txtMsg.Text 
    += "\r\n";

                
    foreach (ServiceEndpoint se in host.Description.Endpoints)
                {
                    txtMsg.Text 
    += string.Format("A: {0}\r\nB: {1}\r\nC: {2}",
                        se.Address, se.Binding.Name, se.Contract.Name);
                }
            }
        }
    }


    3、演示在没有 .svc 物理文件的情况下,直接在 IIS 上托管 WCF 服务
    宿主的配置:Web.config
    代码
    <?xml version="1.0"?>
    <configuration>
        
    <system.web>
            
    <compilation debug="true" targetFramework="4.0" />
        
    </system.web>
        
    <system.serviceModel>

            
    <!--
                要实现“不需要 .svc 的物理文件,而直接在 IIS 上托管 WCF 服务”的功能,需要指定相对地址和服务类型之间的映射关系
                relativeAddress - 向外提供服务的相对地址
                service - 服务类型
                factory - ajax 服务使用 System.ServiceModel.Activation.WebScriptServiceHostFactory , rest 服务使用 System.ServiceModel.Activation.WebServiceHostFactory
            
    -->
            
    <serviceHostingEnvironment>
                
    <serviceActivations>
                    
    <add relativeAddress="IIS_Hosting_Without_SVC_File.svc" service="ServiceLib.Demo" />
                
    </serviceActivations>
            
    </serviceHostingEnvironment>
            
            
    <behaviors>
                
    <serviceBehaviors>
                    
    <behavior>
                        
    <serviceMetadata httpGetEnabled="true"/>
                        
    <serviceDebug includeExceptionDetailInFaults="true"/>
                    
    </behavior>
                
    </serviceBehaviors>
            
    </behaviors>
            
        
    </system.serviceModel>
    </configuration>


    4、演示如何通过标准终结点中的 webScriptEndpoint 来提供 ajax 服务
    服务端:AjaxDemo.cs
    代码
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;

    using System.ServiceModel;

    namespace ServiceLib
    {
        [ServiceContract(Namespace 
    = "WCF")]
        
    public interface IAjaxDemo
        {
            [OperationContract]
            
    string Hello(string name);
        }

        
    public class AjaxDemo : IAjaxDemo
        {
            
    public string Hello(string name)
            {
                
    return "Hello: " + name;
            }
        }
    }

    宿主的配置:Web.config
    代码
    <?xml version="1.0"?>
    <configuration>
        
    <system.web>
            
    <compilation debug="true" targetFramework="4.0" />
        
    </system.web>
        
    <system.serviceModel>

            
    <serviceHostingEnvironment>
                
    <serviceActivations>
                    
    <add relativeAddress="WebScriptEndpointDemo.svc" service="ServiceLib.AjaxDemo" factory="System.ServiceModel.Activation.WebScriptServiceHostFactory" />
                
    </serviceActivations>
            
    </serviceHostingEnvironment>

            
    <!--
                标准终结点是已经定义好相关配置的标准终结点
                通过 kind 指定标准终结点
            
    -->
            
    <services>
                
    <service name="ServiceLib.AjaxDemo">
                    
    <endpoint kind="webScriptEndpoint" contract="ServiceLib.IAjaxDemo" />
                
    </service>
            
    </services>
            
            
    <behaviors>
                
    <serviceBehaviors>
                    
    <behavior>
                        
    <serviceMetadata httpGetEnabled="true"/>
                        
    <serviceDebug includeExceptionDetailInFaults="true"/>
                    
    </behavior>
                
    </serviceBehaviors>
            
    </behaviors>
            
        
    </system.serviceModel>
    </configuration>

    客户端:WebScriptEndpointDemo.aspx
    代码
    <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="WebScriptEndpointDemo.aspx.cs"
        Inherits
    ="WebHost.WebScriptEndpointDemo" %>

    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head runat="server">
        
    <title></title>
    </head>
    <body>
        
    <form id="form1" runat="server">
        
    <div>
            
    <!--
                因为 ajax 要同域,所以此 ajax 演示的 client 端要和 host 端在一起
            
    -->

            
    <asp:ScriptManager ID="ScriptManager1" runat="server">
                
    <Services>
                    
    <asp:ServiceReference Path="WebScriptEndpointDemo.svc" />
                
    </Services>
            
    </asp:ScriptManager>

            
    <script type="text/javascript">

                
    function pageLoad() {
                    
    var proxy = new WCF.IAjaxDemo();
                    proxy.Hello(
    "webabcd", onSuccess, onFailed);
                }

                
    function onSuccess(result) {
                    alert(result);
                }

                
    function onFailed(error) {
                    alert(error.get_message());
                }

            
    </script>
        
    </div>
        
    </form>
    </body>
    </html>


    5、REST 服务的增强
    服务端:RestDemo.cs
    代码
    /*
     * 注意:
     * 如果需要引用 System.ServiceModel.Web 程序集的话,需要把程序的目标框架设置为 .NET Framework 4 而不是默认的 .NET Framework 4 Client Profile(精简版)
     * 引用了目标框架为 .NET Framework 4 的项目的程序的目标框架也应该是 .NET Framework 4
     
    */

    /*
     * 要在 REST 服务上实现 HTTP 缓存,需要做的配置如下
     * 1、在 web.config 中的 system.web/caching 节点上为 REST 服务提供一个缓存配置
     * 2、在方法上通过类似 [AspNetCacheProfile("Cache30S")] 的声明指定方法所使用的缓存配置
     * 3、在 web.config 中的 system.serviceModel/serviceHostingEnvironment 节点上增加一个属性 aspNetCompatibilityEnabled="true" ,以启用 asp.net 兼容模式
     * 4、在方法上使用如下声明,[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)] ,以启用 asp.net 兼容模式
     
    */ 

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;

    using System.ServiceModel;
    using System.ServiceModel.Web;
    using System.ServiceModel.Activation;

    namespace ServiceLib
    {
        [ServiceContract]
        
    public interface IRestDemo
        {
            [OperationContract]
            [WebGet(UriTemplate 
    = "Hello/{name}", ResponseFormat = WebMessageFormat.Json)]
            [AspNetCacheProfile(
    "Cache30S")]
            
    string Hello(string name);
        }

        [AspNetCompatibilityRequirements(RequirementsMode 
    = AspNetCompatibilityRequirementsMode.Allowed)]
        
    public class RestDemo : IRestDemo
        {
            
    public string Hello(string name)
            {
                
    return "Hello: " + name + " - " + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
            }
        }
    }

    宿主端的配置:Web.config
    代码
    <?xml version="1.0"?>
    <configuration>
        
    <system.web>
            
    <compilation debug="true" targetFramework="4.0" />

            
    <!--
                要在 REST 服务上实现 HTTP 缓存,需要做的配置如下
                1、在 web.config 中的 system.web/caching 节点上为 REST 服务提供一个缓存配置
                2、在方法上通过类似 [AspNetCacheProfile("Cache30S")] 的声明指定方法所使用的缓存配置
                3、在 web.config 中的 system.serviceModel/serviceHostingEnvironment 节点上增加一个属性 aspNetCompatibilityEnabled="true" ,以启用 asp.net 兼容模式
                4、在方法上使用如下声明,[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)] ,以启用 asp.net 兼容模式
            
    -->
            
    <caching>
                
    <outputCacheSettings>
                    
    <outputCacheProfiles>
                        
    <add name="Cache30S" duration="30" varyByParam="*" />
                    
    </outputCacheProfiles>
                
    </outputCacheSettings>
            
    </caching>
            
        
    </system.web>
        
    <system.serviceModel>

            
    <serviceHostingEnvironment aspNetCompatibilityEnabled="true">
                
    <serviceActivations>
                    
    <add relativeAddress="RestDemo.svc" service="ServiceLib.RestDemo" factory="System.ServiceModel.Activation.WebServiceHostFactory" />
                
    </serviceActivations>
            
    </serviceHostingEnvironment>

            
    <!--
                标准终结点是已经定义好相关配置的标准终结点
                通过 kind 指定标准终结点
            
    -->
            
    <services>
                
    <service name="ServiceLib.RestDemo">
                    
    <endpoint kind="webHttpEndpoint" contract="ServiceLib.IRestDemo" behaviorConfiguration="HelpBehavior" />
                
    </service>
            
    </services>
            
            
    <behaviors>
                
    <endpointBehaviors>
                    
    <!--
                        启用 REST 的 Help 功能(在服务地址上加“/help”即可进入 REST 服务的帮助页面)
                        本例的 REST 服务的帮助页面为 http://localhost:14802/RestDemo.svc/help
                    
    -->
                    
    <behavior name="HelpBehavior">
                        
    <webHttp helpEnabled="true" />
                    
    </behavior>
                
    </endpointBehaviors>
                
    <serviceBehaviors>
                    
    <behavior>
                        
    <serviceMetadata httpGetEnabled="true"/>
                        
    <serviceDebug includeExceptionDetailInFaults="true"/>
                    
    </behavior>
                
    </serviceBehaviors>
            
    </behaviors>
            
        
    </system.serviceModel>
    </configuration>

    客户端:RestDemo.aspx.cs
    代码
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Web;
    using System.Web.UI;
    using System.Web.UI.WebControls;

    using System.Net;

    namespace WebClient
    {
        
    public partial class RestDemo : System.Web.UI.Page
        {
            
    protected void Page_Load(object sender, EventArgs e)
            {
                System.Net.WebClient client 
    = new System.Net.WebClient();

                var jsonResult 
    = client.DownloadString("http://localhost:14802/RestDemo.svc/Hello/webabcd");

                Response.Write(jsonResult);
            }
        }
    }


    OK
    [源码下载]
  • 相关阅读:
    SNOI 2019 字符串
    1068: [SCOI2007]压缩
    POJ 1848 Tree 树形DP
    BZOJ bzoj1396 识别子串
    BZOJ 4503: 两个串
    BZOJ 2302: [HAOI2011]Problem c(数学+DP)
    BZOJ 3157: 国王奇遇记 (数学)
    CF_528D
    BZOJ 3000: Big Number (数学)
    新の开始
  • 原文地址:https://www.cnblogs.com/webabcd/p/1790175.html
Copyright © 2011-2022 走看看