WCF分布式开发步步为赢(3)WCF服务元数据交换、配置及编程开发

简介:
   今天我们继续 WCF分布式开发步步为赢(3)WCF服务元数据交换、配置及编程开发的学习。经过前面两节的学习,我们了解WCF分布式开发的相关的基本的概念和自定义宿主托管服务的完整的开发和配置过程。今天我们来详细学习WCF服务元数据交换的相关内容。WCF服务元数据究竟是什么?为什么WCF服务要暴露元数据交换节点?这些和以前的Web Service有什么关系?WCF服务元数据交换的方式有那些?我们如何实现WCF服务元数据交换,本节我们会详细讲解。全文结构如下:【1】WCF服务元数据的基本概念、【2】WCF服务元数据交换方式介绍【3】WCF服务元数据交换配置实现过程详解【4】WCF服务元数据交换编程实现过程详解【5】总结。
【1】WCF服务元数据的基本概念:
    WCF服务元数据究竟是什么?它的作用是什么?为什么WCF服务要暴露元数据交换节点?这些和以前的Web Service有什么关系?这些通常是我们在学习WCF服务分布式系统开发过程中常常困扰我们的问题。
     【1.1】WCF服务元数据是什么:
    WCF服务元数据是WCF服务的核心部分服务地址(Address)、绑定(通信协议Binding)、契约(服务、操作、数据Contract)的原始描述信息。服务所公开的元数据包括 XSD(文档中出现的元素、文档中出现的属性、子元素、子元素的数量、子元素的顺序、元素是否为空、元素和属性的数据类型、元素或属性的默认和固定值)和 WSDL 文档(用于描述服务的方法、参数、参数个数、顺序、返回值、返回值的类型等方法的相关信息)。.Disco文档(描述服务的协议、地址、命名空间等信息)。
    这些关键的WCF服务元数据全部都是基于XML语言描述,支持核心的行业标准协议。XSD好处显而易见,  基于XML,没有专门的语法 ,XML Schema支持一系列的数据类型(int、float、Boolean、date等) ,可扩充的数据模型,支持综合命名空间 ,支持属性组等。而这些正式WCF分布式服务追求的跨语言、跨平台的关键部分所在。
    【1.2】为什么要暴露服务元数据:
     知道了WCF服务元数据的概念后,我们就能理解为什么要暴露服务的元数据。WCF服务的元数据描述服务的核心信息,客户端需要了解这些特征以便与该服务进行通信。要想实现异构平台或者系统之间的通信,以前的技术是使用Web Service.因为其具有自描述、可扩展、与平台无关等优势。客户端只需要根据Web Service地址,便可获取服务的相关信息,反序列话本地的代码,通过服务代理进行服务的调用。
   WCF服务主要特性之一就是跨平台的服务交互。而暴露服务元数据的重要原因就是解决了异构客户端服务交互的关键问题。 元数据基于XML,自描述。客户端可以根据服务的元数据反序列换生成本地代码,无论是c#,vb还是java语。
   【1.3】WCF的服务和Web Service比较:
     WCF其中一个重要特性就是支持Web Service的核心协议。无论是服务应用程序还是实际项目中客户端服务的引用的代码都能看出很多相似之处。这里线来看看服务程序的代码结构(IIS托管为例)。
  两者除了包括自己的扩展文件外还有与其对应的服务代码文件。
再来看看客户端引用服务后本地的代码结构。首先是Web Service客户端的服务引用的本地文件:
其次是WCF客户端服务引用的文件结构:
两者都包括服务的本地代码文件(反序列化生成的本地服务相关代码),WSDL服务描述文件、XSD服务结构文件。WCF框架模型一定程度上参考了以前的ASP.NET Web Service,并对此进行了扩展。
【2】WCF服务元数据交换方式介绍:
      WCF服务有两种方案可以发布自己的元数据。一种是基于HTTP-GET协议提供元数据;另一种则为MEX终结点元数据交换方式,和WCF服务一样使用一个专门的终结点,称为MEX元数据交换终结点。
       System.ServiceModel.Description命名空间里 MetadataExchangeClientMode枚举类型里进行了定义。代码如下:
using  System;

namespace  System.ServiceModel.Description
{
    
//  Summary:
    
//      Specifies the exchange mode used to obtain metadata.
     public   enum  MetadataExchangeClientMode
    {
        
//  Summary:
        
//      A WS-Transfer Get request is used.
        MetadataExchange  =   0 ,
        
//
        
//  Summary:
        
//      An HTTP GET request is used.
        HttpGet  =   1 ,
    }
}
   元数据交换终结点与其它终结点相似,包含自己的地址(Address)、绑定(通信协议Binding)、契约(服务、操作、数据Contract),但是使用的服务契约为WCF提供的接口IMetadataExchange。两种发布元数据的方式使用了两种不同的标准网络传输协议,前者为HTTP/GET请求,后者为WS-MetadataExchange(MEX:WCF支持的基本绑定HTTP、HTTPS、TCP、IPC等绑定协议)。
    启用元数据交换服务后,必须显式配置元数据交换行为。下面我们来分别详细介绍WCF服务元数据交换配置和编程两种方式的实现过程。
【3】WCF服务元数据交换配置实现过程详解:
    【3.1】配置HTTP-GET元数据交换方式:
    需要配置服务的行为和基地址,客户端可以根据基地址查看服务的元数据。代码如下:
       < service name = " WcfServiceApp.WCFService "  behaviorConfiguration = " WcfServiceApp.WCFServiceBehavior " >
                
< host >
          
< baseAddresses >
            
< add baseAddress = " http://localhost:8001/ " />
          
</ baseAddresses >
        
</ host >
      
</ service >
    
</ services >
    
< behaviors >
      
< serviceBehaviors >
        
< behavior name = " WcfServiceApp.WCFServiceBehavior " >
          
<!--  To avoid disclosing metadata information,  set  the value below to  false  and remove the metadata endpoint above before deployment  -->
          
< serviceMetadata httpGetEnabled = " true " />
          
<!--  To receive exception details  in  faults  for  debugging purposes,  set  the value below to  true .  Set to  false  before deployment to avoid disclosing exception information  -->
          
< serviceDebug includeExceptionDetailInFaults = " false " />
        
</ behavior >
      
</ serviceBehaviors >
    
</ behaviors >
   配置完成以后,我们可以使用基地址在浏览器里查看服务的信息,效果如下图:
     【3.2】配置终结点元数据交换方式:
      我们这里配置了3种方式的元数据交换终结点,分别是HTTP、TCP、IPC方式。具体代码如下:
< endpoint address = " mex "  binding = " mexHttpBinding "  contract = " IMetadataExchange "   />
        
< endpoint address = " mex "  binding = " mexTcpBinding "  contract = " IMetadataExchange "   />
        
< endpoint address = " mex "  binding = " mexNamedPipeBinding "  contract = " IMetadataExchange "   />
        
< host >
          
< baseAddresses >
            
< add baseAddress = " http://localhost:8001/ " />
            
< add baseAddress = " net.tcp://localhost:8002/ " />
            
< add baseAddress = " net.pipe://localhost/ " />
          
</ baseAddresses >
        
</ host >
服务行为:
< serviceBehaviors >
        
< behavior name = " WCFService.WCFServiceBehavior " >
          
< serviceMetadata httpGetEnabled = " true "   />
          
< serviceDebug includeExceptionDetailInFaults = " false "   />
        
</ behavior >
      
</ serviceBehaviors >
    
</ behaviors >
 
【4】WCF服务元数据交换编程实现过程详解:
    以上的配置文件实现的WCF服务的元数据交换,同样我们也可以通过编程方式实现。前者配置简单、快捷,后者相对复杂。但是编程方式允许代码运行时控制或者设置元数据交换的信息。因而更加灵活。下面我们就来看看如何通过代码实现刚才的服务原数据交换的配置。
【4.1】WCF服务元数据交换HTTP-GET编程实现:
   必须添加对命名空间的引用,  using System.ServiceModel.Description;我们对服务元数据操作的类和接口信息定义在此命名空间里,具体的实现HTTP-GET的代码如下:
 ServiceMetadataBehavior metadataBehavior; // 定义服务行为变量,
                metadataBehavior  =  host.Description.Behaviors.Find < ServiceMetadataBehavior > ();
                
// 获取宿主的行为列表
                 if  (metadataBehavior  ==   null ) // 如果没有服务原数据交换的行为,实例化添加服务原数据交换行为
                {
                    metadataBehavior 
=   new  ServiceMetadataBehavior();
                    Uri httpAddress 
=   new  Uri( " http://localhost:8001/ " );
                    metadataBehavior.HttpGetUrl 
= httpAddress;
                    metadataBehavior.HttpGetEnabled 
=   true ; // 设置HTTP方式
                    host.Description.Behaviors.Add(metadataBehavior);
                }
 
   首先是获得服务行为的列表信息,如果没有设置,我们就进行实例化服务原数据交换行为,并设置http方式可用。 host.Description.Behaviors.Add(metadataBehavior);添加宿主服务的行为。
【4.2】WCF服务元数据交换WS-*编程实现:
    这里分别实现了HTTP、TCP、IPC三种方式的的元数据交换的代码。和http-get方式略有不同,我们需要实例化自己绑定元素和绑定,最后作为参数传递给host宿主实例。具体实现代码如下:
// 2编程方式实现ws*原数据交换
                
// 生命三个绑定节点类
                BindingElement tcpBindingElement  =   new  TcpTransportBindingElement();
                BindingElement httpBindingElement 
=   new  HttpsTransportBindingElement();
                BindingElement pipeBindingElement 
=   new  NamedPipeTransportBindingElement();
                
// 实例化通用绑定类的实例
                Binding tcpBinding  =   new  CustomBinding(tcpBindingElement);
                Binding httpBinding 
=   new  CustomBinding(httpBindingElement);
                Binding pipeBinding 
=   new  CustomBinding(pipeBindingElement);
                
//
                Uri tcpBaseAddress  =   new  Uri( " net.tcp://localhost:9001/ " );
                Uri httpBaseAddress 
=   new  Uri( " http://localhost:9002/ " );
                Uri pipeBaseAddress 
=   new  Uri( " net.pipe://localhost/ " );
                host.AddServiceEndpoint(
typeof (WCFService.IWCFService),  new  NetTcpBinding(), tcpBaseAddress);
                host.AddServiceEndpoint(
typeof (WCFService.IWCFService),  new  WSHttpBinding(), httpBaseAddress);
                host.AddServiceEndpoint(
typeof (WCFService.IWCFService),  new  NetNamedPipeBinding(), pipeBaseAddress);
                
                
// ServiceMetadataBehavior metadataBehavior; // 定义服务行为变量,
                metadataBehavior  =  host.Description.Behaviors.Find < ServiceMetadataBehavior > ();
                
// 获取宿主的行为列表
                 if  (metadataBehavior  ==   null ) // 如果没有服务原数据交换的行为,实例化添加服务原数据交换行为
                {
                    metadataBehavior 
=   new  ServiceMetadataBehavior();

                    host.Description.Behaviors.Add(metadataBehavior);
                }
                
// 如果没有可用的mex节点,可以使用一下代码判断,添加mex节点
                
                host.AddServiceEndpoint(
typeof (IMetadataExchange), tcpBinding,  " mex " );
                host.AddServiceEndpoint(
typeof (IMetadataExchange), httpBinding,  " mex " );
                host.AddServiceEndpoint(
typeof (IMetadataExchange), pipeBinding,  " mex " );
 
【5】总结:
    运行宿主程序,客户端添加服务引用,使用不同元数据地址,我们可以查询到不同的服务信息。结果如下:
 【5.1】http-get方式:
【5.1】终结点http方式:
【5.1】终结点tcp方式:
【5.1】终结点ipc方式:
【5.5】结论
     以上就是全部是WCF服务元数据交换相关概念、配置和编程实现http-get及WS-*等协议进行元数据交换的详细内容。元数据的信息除了包括服务、数据、操作等契约的相关的信息外,还有其他的如事物、可靠性、错误处理等相关的信息。
    了解了这些实现过程之后,在实际的WCF服务项目中,我们就可以以不同的方式配置元数据交换方式。WCF元数据交换其实和Web Service原数据交换有类似之处,都是基于XML语言描述,原数据交换之所以这样重要。
    首先,基于XML的元数据可以实现跨语言、跨平台之间的服务交互,真正做到与平台的无关性。
    其次,通过原数据反序列化生成本地代理类等信息,因为这样就实现了真正的客户端和服务端的解耦,降低了系统之间的耦合度。传统的程序集引用方式无法降低系统的耦合度,这个也是我们系统设计追求的目标。
    以上就是WCF服务元数据交互的全部内容,下面上传本节的实例代码:
/Files/frank_xl/WCFServiceMEXFrankXuLei.rar。供大家参考,也欢迎留言讨论~
参考资料:MSDN



 本文转自 frankxulei 51CTO博客,原文链接:http://blog.51cto.com/frankxulei/320407,如需转载请自行联系原作者


相关文章
|
机器学习/深度学习 监控 算法
分布式光伏储能系统的优化配置方法(Matlab代码实现)
分布式光伏储能系统的优化配置方法(Matlab代码实现)
562 1
|
人工智能 安全 Java
智慧工地源码,Java语言开发,微服务架构,支持分布式和集群部署,多端覆盖
智慧工地是“互联网+建筑工地”的创新模式,基于物联网、移动互联网、BIM、大数据、人工智能等技术,实现对施工现场人员、设备、材料、安全等环节的智能化管理。其解决方案涵盖数据大屏、移动APP和PC管理端,采用高性能Java微服务架构,支持分布式与集群部署,结合Redis、消息队列等技术确保系统稳定高效。通过大数据驱动决策、物联网实时监测预警及AI智能视频监控,消除数据孤岛,提升项目可控性与安全性。智慧工地提供专家级远程管理服务,助力施工质量和安全管理升级,同时依托可扩展平台、多端应用和丰富设备接口,满足多样化需求,推动建筑行业数字化转型。
517 5
|
安全 网络安全 数据库
YashanDB分布式节点间SSL连接配置
本文介绍YashanDB分布式节点间SSL连接配置方法,确保通信安全。需统一为整个集群配置SSL,使用相同根证书签名的服务器证书,否则可能导致连接失败或数据库无法启动。文章详细说明了使用OpenSSL生成根证书、服务器私钥、证书及DH文件的步骤,并指导如何将证书分发至各节点。最后,通过配置数据库参数(如`din_ssl_enable`)并重启集群完成设置。注意,证书过期需重新生成以保障安全性。
|
11月前
|
编解码 运维 算法
【分布式能源选址与定容】光伏、储能双层优化配置接入配电网研究(Matlab代码实现)
【分布式能源选址与定容】光伏、储能双层优化配置接入配电网研究(Matlab代码实现)
858 12
|
安全 JavaScript 前端开发
HarmonyOS NEXT~HarmonyOS 语言仓颉:下一代分布式开发语言的技术解析与应用实践
HarmonyOS语言仓颉是华为专为HarmonyOS生态系统设计的新型编程语言,旨在解决分布式环境下的开发挑战。它以“编码创造”为理念,具备分布式原生、高性能与高效率、安全可靠三大核心特性。仓颉语言通过内置分布式能力简化跨设备开发,提供统一的编程模型和开发体验。文章从语言基础、关键特性、开发实践及未来展望四个方面剖析其技术优势,助力开发者掌握这一新兴工具,构建全场景分布式应用。
1257 35
|
数据管理 API 调度
鸿蒙HarmonyOS应用开发 | 探索 HarmonyOS Next-从开发到实战掌握 HarmonyOS Next 的分布式能力
HarmonyOS Next 是华为新一代操作系统,专注于分布式技术的深度应用与生态融合。本文通过技术特点、应用场景及实战案例,全面解析其核心技术架构与开发流程。重点介绍分布式软总线2.0、数据管理、任务调度等升级特性,并提供基于 ArkTS 的原生开发支持。通过开发跨设备协同音乐播放应用,展示分布式能力的实际应用,涵盖项目配置、主界面设计、分布式服务实现及部署调试步骤。此外,深入分析分布式数据同步原理、任务调度优化及常见问题解决方案,帮助开发者掌握 HarmonyOS Next 的核心技术和实战技巧。
1928 76
鸿蒙HarmonyOS应用开发 | 探索 HarmonyOS Next-从开发到实战掌握 HarmonyOS Next 的分布式能力
|
数据库
如何在Seata框架中配置分布式事务的隔离级别?
总的来说,配置分布式事务的隔离级别是实现分布式事务管理的重要环节之一,需要认真对待和仔细调整,以满足业务的需求和性能要求。你还可以进一步深入研究和实践 Seata 框架的配置和使用,以更好地应对各种分布式事务场景的挑战。
783 160
|
消息中间件 缓存 算法
分布式开发:数字时代的高性能架构革命-为什么要用分布式?优雅草卓伊凡
分布式开发:数字时代的高性能架构革命-为什么要用分布式?优雅草卓伊凡
1637 0
分布式开发:数字时代的高性能架构革命-为什么要用分布式?优雅草卓伊凡
|
机器学习/深度学习 分布式计算 API
Python 高级编程与实战:深入理解并发编程与分布式系统
在前几篇文章中,我们探讨了 Python 的基础语法、面向对象编程、函数式编程、元编程、性能优化、调试技巧、数据科学、机器学习、Web 开发、API 设计、网络编程和异步IO。本文将深入探讨 Python 在并发编程和分布式系统中的应用,并通过实战项目帮助你掌握这些技术。