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,如需转载请自行联系原作者


相关文章
|
14天前
|
数据管理 API 调度
鸿蒙HarmonyOS应用开发 | 探索 HarmonyOS Next-从开发到实战掌握 HarmonyOS Next 的分布式能力
HarmonyOS Next 是华为新一代操作系统,专注于分布式技术的深度应用与生态融合。本文通过技术特点、应用场景及实战案例,全面解析其核心技术架构与开发流程。重点介绍分布式软总线2.0、数据管理、任务调度等升级特性,并提供基于 ArkTS 的原生开发支持。通过开发跨设备协同音乐播放应用,展示分布式能力的实际应用,涵盖项目配置、主界面设计、分布式服务实现及部署调试步骤。此外,深入分析分布式数据同步原理、任务调度优化及常见问题解决方案,帮助开发者掌握 HarmonyOS Next 的核心技术和实战技巧。
143 76
鸿蒙HarmonyOS应用开发 | 探索 HarmonyOS Next-从开发到实战掌握 HarmonyOS Next 的分布式能力
|
3月前
|
存储 缓存 算法
分布式锁服务深度解析:以Apache Flink的Checkpointing机制为例
【10月更文挑战第7天】在分布式系统中,多个进程或节点可能需要同时访问和操作共享资源。为了确保数据的一致性和系统的稳定性,我们需要一种机制来协调这些进程或节点的访问,避免并发冲突和竞态条件。分布式锁服务正是为此而生的一种解决方案。它通过在网络环境中实现锁机制,确保同一时间只有一个进程或节点能够访问和操作共享资源。
110 3
|
5月前
|
存储 监控 负载均衡
检索服务elasticsearch分布式结构
【8月更文挑战第22天】
56 3
|
17天前
|
消息中间件 存储 安全
分布式系统架构3:服务容错
分布式系统因其复杂性,故障几乎是必然的。那么如何让系统在不可避免的故障中依然保持稳定?本文详细介绍了分布式架构中7种核心的服务容错策略,包括故障转移、快速失败、安全失败等,以及它们在实际业务场景中的应用。无论是支付场景的快速失败,还是日志采集的安全失败,每种策略都有自己的适用领域和优缺点。此外,文章还为技术面试提供了解题思路,助你在关键时刻脱颖而出。掌握这些策略,不仅能提升系统健壮性,还能让你的技术栈更上一层楼!快来深入学习,走向架构师之路吧!
52 11
|
3月前
|
NoSQL Java Redis
开发实战:使用Redisson实现分布式延时消息,订单30分钟关闭的另外一种实现!
本文详细介绍了 Redisson 延迟队列(DelayedQueue)的实现原理,包括基本使用、内部数据结构、基本流程、发送和获取延时消息以及初始化延时队列等内容。文章通过代码示例和流程图,逐步解析了延迟消息的发送、接收及处理机制,帮助读者深入了解 Redisson 延迟队列的工作原理。
|
4月前
|
数据采集 分布式计算 MaxCompute
MaxCompute 分布式计算框架 MaxFrame 服务正式商业化公告
MaxCompute 分布式计算框架 MaxFrame 服务于北京时间2024年09月27日正式商业化!
110 3
|
5月前
|
开发者 云计算 数据库
从桌面跃升至云端的华丽转身:深入解析如何运用WinForms与Azure的强大组合,解锁传统应用向现代化分布式系统演变的秘密,实现性能与安全性的双重飞跃——你不可不知的开发新模式
【8月更文挑战第31天】在数字化转型浪潮中,传统桌面应用面临新挑战。本文探讨如何融合Windows Forms(WinForms)与Microsoft Azure,助力应用向云端转型。通过Azure的虚拟机、容器及无服务器计算,可轻松解决性能瓶颈,满足全球用户需求。文中还提供了连接Azure数据库的示例代码,并介绍了集成Azure Storage和Functions的方法。尽管存在安全性、网络延迟及成本等问题,但合理设计架构可有效应对,帮助开发者构建高效可靠的现代应用。
39 0
|
5月前
|
Java 应用服务中间件 数据库
SpringCloud:服务保护和分布式事务详解
SpringCloud:服务保护和分布式事务详解
140 0
|
3月前
|
NoSQL Java Redis
太惨痛: Redis 分布式锁 5个大坑,又大又深, 如何才能 避开 ?
Redis分布式锁在高并发场景下是重要的技术手段,但其实现过程中常遇到五大深坑:**原子性问题**、**连接耗尽问题**、**锁过期问题**、**锁失效问题**以及**锁分段问题**。这些问题不仅影响系统的稳定性和性能,还可能导致数据不一致。尼恩在实际项目中总结了这些坑,并提供了详细的解决方案,包括使用Lua脚本保证原子性、设置合理的锁过期时间和使用看门狗机制、以及通过锁分段提升性能。这些经验和技巧对面试和实际开发都有很大帮助,值得深入学习和实践。
太惨痛: Redis 分布式锁 5个大坑,又大又深, 如何才能 避开 ?
|
1月前
|
存储 NoSQL Java
使用lock4j-redis-template-spring-boot-starter实现redis分布式锁
通过使用 `lock4j-redis-template-spring-boot-starter`,我们可以轻松实现 Redis 分布式锁,从而解决分布式系统中多个实例并发访问共享资源的问题。合理配置和使用分布式锁,可以有效提高系统的稳定性和数据的一致性。希望本文对你在实际项目中使用 Redis 分布式锁有所帮助。
103 5