1.WCF学习--创建简单的WCF服务

时间:2023-03-09 09:58:28
1.WCF学习--创建简单的WCF服务

一、基本了解WCF
  1、面向服务代表的是一种设计理念,和面向对象、面向组件一样,体现的是一种对关注点进行分解的思想,面向服务是和技术无关的

  2、WCF需要依存一个运行着的宿主进程,服务寄宿就是为服务指定一个宿主的过程,服务寄宿的目的就是开启一个进程,为WCF提供一个运行的环境,并为服务提供一个或多个终结点,使之暴露给潜在的服务消费者
  WCF采用基于终结点(Endpoint)的通信手段。终结点由地址(Address)、绑定(Binding)、契约(Contract)三要数组成
    地址:地址决定了服务的位置,解决了服务寻址的问题
    绑定:绑定实现了通讯所有细节,包括网络传输、消息编码、以及其他为实现某种功能(比如传输安全、可靠消息、事务等)对消息进行相应的处理。
    契约:契约是对服务操作的抽象,也是对消息交换及消息结构的定义

    注意:WCF中具有一系列的系统定义绑定,比如:BasicHttpBinding、WSHttpBinding和NetTcpBinding等

二、构建简单的WCF应用

  目录结构如下:

    Service.Interface:用于定义服务契约的类库项目,引用WCF核心程序集 System.ServiceModel.dll

    Service:用于定义服务类型的类库项目,实现服务契约(Service.Interface)

    Hosting:作为服务寄宿的控制台应用

    WCF_自我寄宿:客户端,调用服务

1.WCF学习--创建简单的WCF服务

  定义服务契约:

/// <summary>
/// 用于定义服务契约的地方Contract
/// </summary>
namespace Service.Interface
{
/// <summary>
/// 当服务被添加到客户端程序时,契约接口会被生成出来,出来的名称与 ServiceContract特性里面属性name定义的名称一样
/// </summary>
[ServiceContract(Name ="CalculatorService",Namespace ="http://www.artech.com/")]
public interface ICalculator
{
[OperationContract]
double Add(double x, double y); [OperationContract]
double Subtract(double x, double y); [OperationContract]
double Multiply(double x, double y); [OperationContract]
double Divide(double x, double y);
}
}

  使用编程方式寄宿:

/// <summary>
/// 使用编程方式寄宿
/// </summary>
public static void Programme()
{
//服务寄宿
using (ServiceHost host = new ServiceHost(typeof(Service.CalculatorService)))
{
//添加终结点(一个基于WSHttpBinding绑定的终结点 终结点地址:http://127.0.0.1:3721/calculatorservice 服务契约的类型:ICalculator)
host.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), "http://127.0.0.1:3721/calculatorservice");
if (host.Description.Behaviors.Find<ServiceMetadataBehavior>() == null)
{
// 添加服务行为(控制服务元数据和相关信息的发布。)
ServiceMetadataBehavior behavior = new ServiceMetadataBehavior();
behavior.HttpGetEnabled = true;//指定采用http-get的元数据获取方式
behavior.HttpGetUrl = new Uri("http://127.0.0.1:3721/calculatorservice/metadata");//指定元数据发布地址,这样在服务寄宿后我们可以通过这个地址访问服务相关的元数据
host.Description.Behaviors.Add(behavior);
} host.Opened += delegate
{
Console.WriteLine("CalculatorService 启动,按任意键终止服务!");
};
host.Open();//开启服务
Console.Read();
}
}

  使用配置文件寄宿

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
</startup>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior name="metadateBehavior">
<!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false 并删除上面的元数据终结点 -->
<serviceMetadata httpGetEnabled="true" httpGetUrl="calculatorservice/metadata" />
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service behaviorConfiguration="metadateBehavior" name="Service.CalculatorService">
<endpoint address="calculatorservice" binding="wsHttpBinding"
name="Service.CalculatorService" contract="Service.Interface.ICalculator" />
<host>
<baseAddresses>
<add baseAddress="http://127.0.0.1:3721" />
</baseAddresses>
</host>
</service>
</services>
</system.serviceModel>
</configuration>

  

/// <summary>
/// 使用配置文件添加服务
/// </summary>
public static void Config()
{
using (ServiceHost host = new ServiceHost(typeof(CalculatorService)))
{
host.Opened += delegate
{
Console.WriteLine("CalculatorService 启动,按任意键终止服务!");
};
host.Open();//开启服务
Console.Read();
}
}

1.WCF学习--创建简单的WCF服务

1.WCF学习--创建简单的WCF服务

1.WCF学习--创建简单的WCF服务

  客户端调用服务:

    1、当服务被添加后,客户端进行服务调用的服务契约接口CalculatorService会被生成出来并且与ICalculator契约接口具有相同的成员且等效
    注意:这个掉用的服务契约与定义契约接口时使用ServiceContractAttribute特性的name属性设置的一样

namespace WCF_自我寄宿.ServiceReference1 {

    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(Namespace="http://www.artech.com/", ConfigurationName="ServiceReference1.CalculatorService")]
public interface CalculatorService { [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Add", ReplyAction="http://www.artech.com/CalculatorService/AddResponse")]
double Add(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Add", ReplyAction="http://www.artech.com/CalculatorService/AddResponse")]
System.Threading.Tasks.Task<double> AddAsync(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Subtract", ReplyAction="http://www.artech.com/CalculatorService/SubtractResponse")]
double Subtract(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Subtract", ReplyAction="http://www.artech.com/CalculatorService/SubtractResponse")]
System.Threading.Tasks.Task<double> SubtractAsync(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Multiply", ReplyAction="http://www.artech.com/CalculatorService/MultiplyResponse")]
double Multiply(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Multiply", ReplyAction="http://www.artech.com/CalculatorService/MultiplyResponse")]
System.Threading.Tasks.Task<double> MultiplyAsync(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Divide", ReplyAction="http://www.artech.com/CalculatorService/DivideResponse")]
double Divide(double x, double y); [System.ServiceModel.OperationContractAttribute(Action="http://www.artech.com/CalculatorService/Divide", ReplyAction="http://www.artech.com/CalculatorService/DivideResponse")]
System.Threading.Tasks.Task<double> DivideAsync(double x, double y);
} [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]
public interface CalculatorServiceChannel : WCF_自我寄宿.ServiceReference1.CalculatorService, System.ServiceModel.IClientChannel {
} [System.Diagnostics.DebuggerStepThroughAttribute()]
[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]
public partial class CalculatorServiceClient : System.ServiceModel.ClientBase<WCF_自我寄宿.ServiceReference1.CalculatorService>, WCF_自我寄宿.ServiceReference1.CalculatorService { public CalculatorServiceClient() {
} public CalculatorServiceClient(string endpointConfigurationName) :
base(endpointConfigurationName) {
} public CalculatorServiceClient(string endpointConfigurationName, string remoteAddress) :
base(endpointConfigurationName, remoteAddress) {
} public CalculatorServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :
base(endpointConfigurationName, remoteAddress) {
} public CalculatorServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :
base(binding, remoteAddress) {
} public double Add(double x, double y) {
return base.Channel.Add(x, y);
} public System.Threading.Tasks.Task<double> AddAsync(double x, double y) {
return base.Channel.AddAsync(x, y);
} public double Subtract(double x, double y) {
return base.Channel.Subtract(x, y);
} public System.Threading.Tasks.Task<double> SubtractAsync(double x, double y) {
return base.Channel.SubtractAsync(x, y);
} public double Multiply(double x, double y) {
return base.Channel.Multiply(x, y);
} public System.Threading.Tasks.Task<double> MultiplyAsync(double x, double y) {
return base.Channel.MultiplyAsync(x, y);
} public double Divide(double x, double y) {
return base.Channel.Divide(x, y);
} public System.Threading.Tasks.Task<double> DivideAsync(double x, double y) {
return base.Channel.DivideAsync(x, y);
}
}
}

    2、查看调用服务后生成的代码可以看出来其实真正被调用的是CalculatorServiceClient类
    public interface CalculatorService
    public partial class CalculatorServiceClient : System.ServiceModel.ClientBase<WCF_自我寄宿.ServiceReference1.CalculatorService>, WCF_自我寄宿.ServiceReference1.CalculatorService
    可以看到CalculatorServiceClient同样实现了契约接口并且其基类是System.ServiceModel.ClientBase<WCF_自我寄宿.ServiceReference1.CalculatorService>,
    并通过从基类继承的Channel属性的相应方法实现了4个运算操作

  

  客户端引用服务后字节调用:

//1、直接调用
CalculatorServiceClient client = new CalculatorServiceClient();
Console.WriteLine(client.Add(, ));

  由于WCF采用基于契约的服务调用方法。
  vs在添加服务的时候会在客户端创建一个与服务等效的服务契约接口。 public interface CalculatorService
  由于服务端和客户端在同一个解决方案里面,因此可以让服务端和客户端引用相同的契约(当然这里是删除了服务引用,并且引用服务契约1Calculator)
  通过System.ServiceModel.ChannelFactory<Tchannel>直接创建服务代理对象

using (ChannelFactory<ICalculator> channelFactory = new ChannelFactory<ICalculator>(new WSHttpBinding(), "http://127.0.0.1:3721/calculatorservice"))
{
ICalculator calculator = channelFactory.CreateChannel();
Console.WriteLine(calculator.Add(, ));
}

  说明:

    终结点是WCF进行通讯的唯一手段,ChannelFactory<ICalculator>本质上是通过指定的终结点创建用于进行服务调用的服务代理

    在创建channelFactory对象的时候我们指定了 地址和绑定 泛型ChannelFactory<ICalculator>指定了 契约

  一般我们通过在配置文件添加终结点(常用)再通过System.ServiceModel.ChannelFactory<Tchannel>直接创建服务代理对象

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
</startup>
<system.serviceModel>
<client>
<endpoint
address="http://127.0.0.1:3721/calculatorservice"
binding="wsHttpBinding"
contract="Service.Interface.ICalculator"
name="CalCulatorService" />
</client>
</system.serviceModel>
</configuration>

1.WCF学习--创建简单的WCF服务

using (ChannelFactory<ICalculator> channelFactory = new ChannelFactory<ICalculator>("CalCulatorService"))
{
ICalculator calculator = channelFactory.CreateChannel();
Console.WriteLine(calculator.Add(, ));
Console.WriteLine("按任意键终止程序");
Console.Read();
}

IIS寄宿:https://blog.****.net/heyangyi_19940703/article/details/51831094