WCF开发之服务契约

2024-05-02 00:48
文章标签 服务 开发 wcf 契约

本文主要是介绍WCF开发之服务契约,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

契约服务说白了就是对WCF服务的对外接口作定义和声明。下面是一些关键字,只有加了关键字的方法才能被服务调用者访问。

[ServiceContract]:定义服务操作,对于某个Interface加上这个属性标签就会就定义了一个服务,客户端才可以看到这个服务。这个属性标签可以应用于接口或者类,建议应用于接口,第一,可以消除服务实现的耦合性,因为接口中不存在任何的业务逻辑相关的东西,第二,服务可能会实现多于一个契约,也就是说一个类同时实现多个服务,如果把标签定义在类上,就无法同时实现多个服务了。

两个属性:

Name:指定暴露给客户端的服务名称。

Namespace:提供有意义的命名空间。

[OperationContract]:使得方法作为公共服务契约的一部分暴露出来,也就说说客户端可以看到服务中暴露出来的方法。服务契约中的所有方法都应该拥有这个属性标签。

一些属性:

Namespace:提供有意义的命名空间。

Name:指定暴露给客户端的方法名称。

Action:Web调用地址,获取或设置请求消息的 WS-Addressing 操作,定义具体的动作,他表示的是一个层次上的关系,下面的代码中可以看出,Action=namespace+servername+methodname。当客户端导入一个服务终结点的元数据时,如果该终结点的契约属于接口层级的一部分,则生成的客户端契约将不再维持原来的层级关系。相反,它会取消层级,组成一个单独的契约,名称为终结点的契约名。这个单独的契约包含了层级中从上至下所有接口定义的操作。然而,如果使用OperationContract特性中的Action与ResponseAction属性,那么导入的接口定义仍然可以保留原来定义每个操作的契约名,比如:服务接口之间如果有继承关系的存在,那么他就可以派上用场了。

ReplyAction:调用后回传的地址,获取或设置用于该操作答复消息的 SOAP 操作的值,定义具体的相应动作。它主要完成的是SOAP数据到具体代码的映射关系。

对于这后两个属性是不是不太理解,没关系后面的sample会给你答案, 继续读完吧,坚持就是胜利!!!

[MessageParameter]:用来控制参数或者返回名称,下面的一段代码可以很好的帮我们理解他的作用,很简单,其实就是映射作用。具体如下:有一个Java的客户端,发送一个SOAP给WCF服务,WCF会检查SOAP中有没有的对应定义的MessageParameter Name,如果有就会对应到WCF函数中的相应位置,通过这种映射关系,然后通过反序列化把数据传到WCF的对应方法中,实现对象的传递。说简单点他就是用来控制在soap中参数节点的名称的。

概念SOAP:Simple Object Access Protocol,简单对象访问协议(SOAP)是一种轻量的、简单的、基于 XML 的协议,它被设计成在 WEB 上交换结构化的和固化的信息。 SOAP 可以和现存的许多因特网协议和格式结合使用,包括超文本传输协议( HTTP),简单邮件传输协议(SMTP),多用途网际邮件扩充协议(MIME)。它还支持从消息系统到远程过程调用(RPC)等大量的应用程序。

WCF服务和Client之间其实就是用的SOAP这种协议。下面的代码展示了这些关键字的使用方法。

复制代码
Demo 代码
using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;
using  System.ServiceModel;

namespace  WCF.Demo
{
    
public   class  HelloWorldService : IService
    {
        
public   string  HelloWorld( string  message)
        {
            
return   string .Format( " At {0}, I will say {1} " , DateTime.Now, message);
        }

        
public   void  SaveLink( string  item)
        {

        }

        
public   string  GetLink( string  id)
        {
            
return   " Thanks! " ;
        }
    }

    [ServiceContract(Name 
=   " ContentManagerContract " , Namespace  =   " http://www.cnblogs.com/CharlesLiu " )]
    
public   interface  IService
    {
        [OperationContract(Name 
=   " SaveLinkString " , Action  =   " http://www.cnblogs.com/CharlesLiu/ContentManagerContract/SaveLink " ,ReplyAction = " http://www.cnblogs.com/CharlesLiu/ContentManagerContract/ResponseSaveLink " )]
        
void  SaveLink([MessageParameter(Name  =   " StringItem " )] string  item);

        [OperationContract]
        [
return : MessageParameter(Name  =   " StringItem " )]
        
string  GetLink( string  id);

        [OperationContract]
        
string  HelloWorld( string  message);
    }
}
复制代码

 

下面的例子主要介绍Action属性,创建WCF程序项目,更加方便,不用编写host部分了,F5会自动把Service给host起来,如下图:

 

复制代码
Demo1.IService代码
using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Runtime.Serialization;
using  System.ServiceModel;
using  System.Text;

namespace  WcfServiceLibraryDemo
{
    
//  NOTE: If you change the interface name "IService1" here, you must also update the reference to "IService1" in App.config.
    [ServiceContract(Name  =   " ServiceAContract " , Namespace  =   " http://www.cnblogs.com/Charlesliu " )]
    
public   interface  IServiceA
    {
        [OperationContract(Name 
=   " Name_Operation1 " , Action  =   " http://www.cnblogs.com/Charlesliu/ServiceAContract/Operation1 " , ReplyAction  =   " http://www.cnblogs.com/Charlesliu/ServiceAContract/Operation1Response " )]
        
string  Operation1();

        [OperationContract(Name 
=   " Name_Operation2 " , Action  =   " http://www.cnblogs.com/Charlesliu/ServiceAContract/Operation2 " , ReplyAction  =   " http://www.cnblogs.com/Charlesliu/ServiceAContract/Operation2Response " )]
        
string  Operation2();
    }
}
复制代码

 

复制代码
Demo1.Service.Class代码
using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Runtime.Serialization;
using  System.ServiceModel;
using  System.Text;

namespace  WcfServiceLibraryDemo
{
    
public   class  ServiceA : IServiceA
    {

        
public   string  Operation1()
        {
            
return   " IServiceA.Operation1() invoked. " ;
        }

        
public   string  Operation2()
        {
            
return   " IServiceA.Operation2() invoked. " ;
        }

    }
}
复制代码

 

复制代码
Demo1.WinClient代码
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;

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

        
private   void  button1_Click( object  sender, EventArgs e)
        {
            MyServiceReference.ServiceAContractClient so1 
=   new  WinTest.MyServiceReference.ServiceAContractClient();
            MessageBox.Show(so1.Name_Operation1());
        }

        
private   void  button2_Click( object  sender, EventArgs e)
        {
            MyServiceReference.ServiceAContractClient so1 
=   new  WinTest.MyServiceReference.ServiceAContractClient();
            MessageBox.Show(so1.Name_Operation2());
        }
    }
}
复制代码

Action说简单点就是用来定义某个web方法在SOAP中的调用地址的。ReplyAction也就是用来定义某个web方法返回值在SOAP中的输出地址的。当在一个大的服务中出现同名的方法时,不论是有继承关系或是简单的同名,这个地址就可以很好的在SOAP中区分开该方法。

只有有了这些地址WCF才能进行输入和输出的操作,他们会用默认值自动设置上去。

 当然这部分还有很多的知识,在以后的开发工作中会逐步积累和总结。

这篇关于WCF开发之服务契约的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/953063

相关文章

springboot项目如何开启https服务

《springboot项目如何开启https服务》:本文主要介绍springboot项目如何开启https服务方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录springboot项目开启https服务1. 生成SSL证书密钥库使用keytool生成自签名证书将

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

Spring LDAP目录服务的使用示例

《SpringLDAP目录服务的使用示例》本文主要介绍了SpringLDAP目录服务的使用示例... 目录引言一、Spring LDAP基础二、LdapTemplate详解三、LDAP对象映射四、基本LDAP操作4.1 查询操作4.2 添加操作4.3 修改操作4.4 删除操作五、认证与授权六、高级特性与最佳

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S

Python通过模块化开发优化代码的技巧分享

《Python通过模块化开发优化代码的技巧分享》模块化开发就是把代码拆成一个个“零件”,该封装封装,该拆分拆分,下面小编就来和大家简单聊聊python如何用模块化开发进行代码优化吧... 目录什么是模块化开发如何拆分代码改进版:拆分成模块让模块更强大:使用 __init__.py你一定会遇到的问题模www.

Spring Security基于数据库的ABAC属性权限模型实战开发教程

《SpringSecurity基于数据库的ABAC属性权限模型实战开发教程》:本文主要介绍SpringSecurity基于数据库的ABAC属性权限模型实战开发教程,本文给大家介绍的非常详细,对大... 目录1. 前言2. 权限决策依据RBACABAC综合对比3. 数据库表结构说明4. 实战开始5. MyBA

使用Python开发一个简单的本地图片服务器

《使用Python开发一个简单的本地图片服务器》本文介绍了如何结合wxPython构建的图形用户界面GUI和Python内建的Web服务器功能,在本地网络中搭建一个私人的,即开即用的网页相册,文中的示... 目录项目目标核心技术栈代码深度解析完整代码工作流程主要功能与优势潜在改进与思考运行结果总结你是否曾经

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优