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


相关文章
|
消息中间件 人工智能 监控
文生图架构设计原来如此简单之分布式服务
想象一下,当成千上万的用户同时要求AI画图,如何公平高效地处理这些请求?文生图/图生图大模型的架构设计看似复杂,实则遵循简单而有效的原则:合理排队、分工明确、防患未然。
542 14
文生图架构设计原来如此简单之分布式服务
|
SQL 分布式计算 DataWorks
MaxCompute MaxFrame评测 | 分布式Python计算服务MaxFrame(完整操作版)
在当今数字化迅猛发展的时代,数据信息的保存与分析对企业决策至关重要。MaxCompute MaxFrame是阿里云自研的分布式计算框架,支持Python编程接口、兼容Pandas接口并自动进行分布式计算。通过MaxCompute的海量计算资源,企业可以进行大规模数据处理、可视化数据分析及科学计算等任务。本文将详细介绍如何开通MaxCompute和DataWorks服务,并使用MaxFrame进行数据操作。包括创建项目、绑定数据源、编写PyODPS 3节点代码以及执行SQL查询等内容。最后,针对使用过程中遇到的问题提出反馈建议,帮助用户更好地理解和使用MaxFrame。
|
SQL 分布式计算 数据处理
云产品评测|分布式Python计算服务MaxFrame | 在本地环境中使用MaxFrame + 基于MaxFrame实现大语言模型数据处理
本文基于官方文档,介绍了由浅入深的两个部分实操测试,包括在本地环境中使用MaxFrame & 基于MaxFrame实现大语言模型数据处理,对步骤有详细说明。体验下来对MaxCompute的感受是很不错的,值得尝试并使用!
387 1
|
分布式计算 数据处理 MaxCompute
云产品评测|分布式Python计算服务MaxFrame
云产品评测|分布式Python计算服务MaxFrame
371 2
|
前端开发
WCF更新服务引用报错的原因之一
WCF更新服务引用报错的原因之一
|
C# 数据安全/隐私保护
c#如何创建WCF服务到发布(SqlServer版已经验证)
c#如何创建WCF服务到发布(SqlServer版已经验证)
198 0
|
安全 数据库连接 数据库
WCF服务创建到发布(SqlServer版)
在本示例开始之前,让我们先来了解一下什么是wcf? wcf有哪些特点? wcf是一个面向服务编程的综合分层架构。该架构的项层为服务模型层。 使用户用最少的时间和精力建立自己的软件产品和外界通信的模型。它使得开发者能够建立一个跨平台的安全、可信赖、事务性的解决方案。且能与已有系统兼容写作。 简单概括就是:一组数据通信的应用程序开发接口。
375 0
|
C++
WCF基础教程(二)——解析iis8和iis8.5+VS2013发布wcf服务问题
WCF基础教程(二)——解析iis8和iis8.5+VS2013发布wcf服务问题
315 0
WCF基础教程(二)——解析iis8和iis8.5+VS2013发布wcf服务问题
WCF使用纯代码的方式进行服务寄宿
服务寄宿的目的是为了开启一个进程,为WCF服务提供一个运行的环境。通过为服务添加一个或者多个终结点,使之暴露给潜在的服务消费,服务消费者通过匹配的终结点对该服务进行调用,除去上面的两种寄宿方式,还可以以纯代码的方式实现服务的寄宿工作。
1081 0

热门文章

最新文章