WCF终结点——终结点地址(EndpointAddress)

image

终结点的地址的Uri属性作为终结点地址的唯一标示。

包括客户端终结点服务端终结点。

一、服务端终结点:

服务端的终结点通过宿主的添加方法暴露出来,从而成为可以调用的资源。

image

下面是将服务绑定到宿主的代码:

定义宿主时使用的是契约的实现类,也即服务类添加终结点到宿主的使用的是契约接口

1.1代码实现

代码实现往指定服务的宿主上添加终结点:

image

1.2配置实现

下面通过配置实现:

image

代码实现对应的配置如下:

image

1.3svc文件的配置

下面也给出svc文件中的配置:

由于svc文件被部署到了IIS上,所以对应的有端口,本身svc是一个文件,对应的也有路径,所以配置不用使用address字段

image

1.4获取宿主上的终结点

可以向一个宿主身上添加多个服务终结点,所以一个服务可以有多个终结点。每一个服务对应着一个宿主。当然可以获取所有的终结点。

宿主有个关于服务的描述属性,该属性包括了宿主的承载的所有服务终结点

image

image

1.5使用基地址+相对地址类添加契约终结点

当终结点比较多时,并且前面的部分相同时,可以通过基地址+相对地址类来添加终结点到宿主上面。

image

宿主这时也会根据使用的Binding类型的不同来区分请求的终结点。注意上面的一个是NetTcpBinding,一个是BasicHttpBinding。这就要求同一种绑定类型的基地址只能有一种,要不然会弄乱的。

下面是配置方式

image

IIS来讲文件所在地点就是基地址:

image

1.6当一个服务同时实现了两个契约时,需要共享相同的地址,那么必须保证其绑定是同一个。方法是new一个绑定供两个终结点使用。

image

二、客户端终结点

客户端通过引用服务,最终生成了一个代理类:客户端服务代理类继承自ClientBase<TChannel>和TChannel,其中TChannel是和服务端等效的接口,不过名称是自动生成的,我们可以使用此代理类来操作数据;也可以通过ChannelFactory<TChannel>来创建代理类来操作数据。

下面看简单的看一下代理类的基类的部分构造方法和两个属性。下面的属性有个ChannelFactory<TChannel>,其实第一种方法的代理是通过ClientBase<TChannel>的属性创建的。
public abstract class ClientBase<TChannel>

{
        protected ClientBase();
        protected ClientBase(ServiceEndpoint endpoint);
        protected ClientBase(string endpointConfigurationName);
        protected ClientBase(Binding binding, EndpointAddress remoteAddress);
        protected ClientBase(string endpointConfigurationName, EndpointAddress remoteAddress);
        protected ClientBase(string endpointConfigurationName, string remoteAddress);

        protected TChannel Channel { get; }
        public ChannelFactory<TChannel> ChannelFactory { get; }
}

为什么客户端能调用服务端的方法类操作数据?

由构造函数来看主要是通过使用终结点来和服务端相对应,来让客户端能够找到服务端的对象。

下面给出客户端的终结点的第一种配置:

<system.serviceModel>
    <client>
      <endpoint name="myEndPoint"
                address="http://127.0.0.1/wcfservices/"
                binding="wsHttpBinding"
                contract="ServiceReference1.ICalculator">
      </endpoint>
    </client>
</system.serviceModel>
如果是使用上面的配置,那么就可以使用基类参数为endpointConfigurationName=myEndPoint的构造方法构造。

三、地址报头

每个终结点都含有一个Headers属性,客户端来说会被添加到请求消息的报头集合中,对于服务端来说,会提取响应的报头信息和本地终结点的地址报头来进行比较以选择出于请求消息相匹配的终结点。

地址报头的创建

AddressHeader CreateAddressHeader(string name, string ns, object value, XmlObjectSerializer serializer);

以下是服务端终结点的形状:

image

下面是如何使用地址报头的代码:

using (ChannelFactory<CalculatorService> channelFactory = new ChannelFactory<CalculatorService>("wsHttpBinding"))
          {
              CalculatorService calculator = channelFactory.CreateChannel();
              Uri uri = new Uri("http://127.0.0.1:3721/calculatorservice");
              AddressHeader header = AddressHeader.CreateAddressHeader("Licensed User", "http://www.artech.com", "UserType");
                  using (OperationContextScope operationContextScope=new OperationContextScope(calculator as IContextChannel))
              {
                  OperationContext.Current.OutgoingMessageHeaders.Add(header.ToMessageHeader());
                  double result = calculator.Divide(1, 2);
              }

}

如果AddressFilterMode为Any,报头可以不匹配。使用如下:

[ServiceBehavior(AddressFilterMode=AddressFilterMode.Any]
  public class CalculatorService:ICalculator

四、逻辑地址和物理地址

物理地址对于服务端来说是监听地址,对于客户端来说是真正发送的目标地址

针对SOAP的消息交换来说,服务的逻辑地址是<To>报头的地址。

对于服务端来说物理地址和逻辑地址分离的表现在:用于监听地址和收到的消息TO报头的地址不一致。

在客户端表现逻辑地址和物理地址分离的表现:<To>的报头地址和消息真正发送目标地址不一致。

需要中介服务参与消息路由的通信就涉及物理地址和逻辑地址的分离。

对于服务消费者来说,消息发送的逻辑地址是针对服务的最终提供者的。

<endpoint address="http://127.0.0.1:5555/service1"
                 binding="basicHttpBinding"
                 contract="Artech.WcfServices.Service.Interface.ICalculator" />
       <!--2. BasicHttpBinding + ListenUriMode.Unique-->
       <!--6666加GUID-->
       <endpoint address="http://127.0.0.1:6666/service2"
                 binding="basicHttpBinding"
                 contract="Artech.WcfServices.Service.Interface.ICalculator"
                 listenUriMode="Unique" />
       <!--3. NetTcpBinding & ListenUriMode.Explicit-->
       <!--7777-->
       <endpoint address="net.tcp://127.0.0.1:7777/service3"
                 binding="netTcpBinding"
             contract="Artech.WcfServices.Service.Interface.ICalculator"/>
       <!--4. NetTcpBinding & ListenUriMode.Unique-->
       <!--会使用未占用的端口-->
       <endpoint address="net.tcp://127.0.0.1:8888/service4"
                 binding="netTcpBinding"
                 contract="Artech.WcfServices.Service.Interface.ICalculator"
                 listenUriMode="Unique" />
       <!--5. NetTcpBinding & ListenUriMode.Unique & Port Sharing-->
       <!--会使用原来的端口,后面加个GUID-->
       <endpoint address="net.tcp://127.0.0.1:9999/service5"
                 binding="netTcpBinding"
                 bindingConfiguration="PortSharingBinding"
                 contract="Artech.WcfServices.Service.Interface.ICalculator"
                 listenUriMode="Unique" />

上面的配置主要说明了监听地址和监听方式决定了最终的监听地址。

using (ServiceHost host = new ServiceHost(typeof(CalculatorService)))
            {
                host.Open();
                int i = 0;
                foreach (ChannelDispatcher channelDispatcher in host.ChannelDispatchers)
                {
                    Console.WriteLine("{0}: {1}", ++i, channelDispatcher.Listener.Uri);
                }
                Console.ReadKey();
            }

提供服务的主机,对应着一个或者多个分发器,每个分发器对应着一个或多个监听器。

wcf提供了4中类型的行为:1.服务行为、2契约行为、3终结点行为、4操作行为。行为是客户端或者服务端本地实现某个功能的一种方式,是一种单边的行为

2和4被定义为特性。3只能通过配置,1可以声明和配置。1.服务行为,主要用于service behaviorConfiguration="" 。3.终结点行为主要用于终结点的endpoint endpointConfiguration=""

服务和终结点的行为配置如下:

image

image

终结点行为配置还可以如下:

<behaviors>
      <endpointBehaviors>
        <behavior name="aa" >
          <clientVia viaUri="http://127.0.0.1:55551/service1"/>
        </behavior>
      </endpointBehaviors>
    </behaviors>

上面的viaUri是代表的是物理地址,即消息真正发送的目的地址。

实现服务端逻辑地址和物理地址的分离的demo

image

客户端配置:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <bindings>
      <ws2007HttpBinding>
        <binding name="myBinding">
          <security mode="None"/>
        </binding>
      </ws2007HttpBinding>
    </bindings>
    <client>
      <endpoint name="calculatorservice"
             address="http://127.0.0.1:9999/calculatorservice"
             binding="ws2007HttpBinding"
             bindingConfiguration="myBinding"
             contract="Artech.WcfServices.Service.Interface.ICalculator"/>
    </client>
  </system.serviceModel>
</configuration>

服务端配置:

<system.serviceModel>
  <bindings>
    <ws2007HttpBinding>
      <binding name="myBinding">
        <security mode="None"/>
      </binding>
    </ws2007HttpBinding>
  </bindings>
  <services>
    <service name="Artech.WcfServices.Service.CalculatorService">
      <endpoint address="http://127.0.0.1:9999/calculatorservice"
                binding="ws2007HttpBinding"
                bindingConfiguration="myBinding"
                contract="Artech.WcfServices.Service.Interface.ICalculator"
                listenUri="http://127.0.0.1:8888/CalculatorService"
                listenUriMode="Explicit"/>
    </service>
  </services>
</system.serviceModel>

路由转发设置:监听9999,目的8888.To包含的是9999.

接下来是客户端逻辑地址和物理地址的分离的实例:

image

服务端

<system.serviceModel>
  <bindings>
    <ws2007HttpBinding>
      <binding name="myBinding">
        <security mode="None"/>
      </binding>
    </ws2007HttpBinding>
  </bindings>
  <services>
    <service name="Artech.WcfServices.Service.CalculatorService">
      <endpoint address="http://127.0.0.1:9999/calculatorservice"
                binding="ws2007HttpBinding"
                bindingConfiguration="myBinding"
                contract="Artech.WcfServices.Service.Interface.ICalculator"/>
    </service>
  </services>
</system.serviceModel>

客户端地址

<system.serviceModel>
  <behaviors>
    <endpointBehaviors>
      <behavior name="clientVia">
        <clientVia viaUri="http://127.0.0.1:8888/calculatorservice"/>
      </behavior>
    </endpointBehaviors>
  </behaviors>
  <bindings>
    <ws2007HttpBinding>
      <binding name="myBinding">
        <security mode="None"/>
      </binding>
    </ws2007HttpBinding>
  </bindings>
  <client>
    <endpoint name="calculatorservice"
           address="http://127.0.0.1:9999/calculatorservice"
           binding="ws2007HttpBinding"
           bindingConfiguration="myBinding"
           behaviorConfiguration="clientVia"
           contract="Artech.WcfServices.Service.Interface.ICalculator"/>
  </client>
</system.serviceModel>

路由转发从8888转到9999,双方的Address必须相同,为了让<To>内的地址相同。可以知道发送到哪里。

image
信道分发器进行请求监听和消息接受,终结点分发器最终完成对消息的处理。

信道分发器相当于保安,当有人找公司里面的人时,保安会通知具体的公司人去处理事情。

posted @ 2013-11-29 16:40  haiziguo  阅读(15798)  评论(0编辑  收藏  举报