zoukankan      html  css  js  c++  java
  • Duplex Services (Msdn)

    Duplex Services from msdn

    A duplex service contract is a message exchange pattern in which both endpoints can send messages to the other independently.
    A duplex service, therefore, can send messages back to the client endpoint, providing event-like behavior.

    Duplex communication occurs when a client connects to a service and provides the service with a channel on which the service can send messages back to the client.
    Note that the event-like behavior of duplex services only works within a session.

    To create a duplex contract you create a pair of interfaces.
    The first is the service contract interface that describes the operations that a client can invoke.
    That service contract must specify a callback contract in the ServiceContractAttribute.CallbackContract property.
    The callback contract is the interface that defines the operations that the service can call on the client endpoint.
    A duplex contract does not require a session, although the system-provided duplex bindings make use of them.

    The following is an example of a duplex contract.

    public interface ICalculatorDuplexCallback
        {
            [OperationContract(IsOneWay = true)]
            void Equals(double result);
            [OperationContract(IsOneWay = true)]
            void Equation(string eqn);
        }
    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode = SessionMode.Required,
                     CallbackContract = typeof(ICalculatorDuplexCallback))]
        public interface ICalculatorDuplex
        {
            [OperationContract(IsOneWay = true)]
            void Clear();
            [OperationContract(IsOneWay = true)]
            void AddTo(double n);
            [OperationContract(IsOneWay = true)]
            void SubtractFrom(double n);
            [OperationContract(IsOneWay = true)]
            void MultiplyBy(double n);
            [OperationContract(IsOneWay = true)]
            void DivideBy(double n);
        }

    The CalculatorService class implements the primary ICalculatorDuplex interface.
    The service uses the PerSession instance mode to maintain the result for each session.
    A private property named Callback accesses the callback channel to the client.
    The service uses the callback for sending messages back to the client through the callback interface, as shown in the following sample code.

    [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
        public class CalculatorService : ICalculatorDuplex
        {
            double result = 0.0D;
            string equation;
    
            public CalculatorService()
            {
                equation = result.ToString();
            }
    
            public void Clear()
            {
                Callback.Equation(equation + " = " + result.ToString());
                equation = result.ToString();
            }
    
            public void AddTo(double n)
            {
                result += n;
                equation += " + " + n.ToString();
                Callback.Equals(result);
            }
    
            public void SubtractFrom(double n)
            {
                result -= n;
                equation += " - " + n.ToString();
                Callback.Equals(result);
            }
    
            public void MultiplyBy(double n)
            {
                result *= n;
                equation += " * " + n.ToString();
                Callback.Equals(result);
            }
    
            public void DivideBy(double n)
            {
                result /= n;
                equation += " / " + n.ToString();
                Callback.Equals(result);
            }
    
            ICalculatorDuplexCallback Callback
            {
                get
                {
                    return OperationContext.Current.GetCallbackChannel<ICalculatorDuplexCallback>();
                }
            }
        }

    The client must provide a class that implements the callback interface of the duplex contract, for receiving messages from the service.
    The following sample code shows a CallbackHandler class that implements the ICalculatorDuplexCallback interface.

    public class CallbackHandler : ICalculatorDuplexCallback
    {
        public void Equals(double result)
        {
            Console.WriteLine("Equals({0})", result);
        }
    
        public void Equation(string eqn)
        {
            Console.WriteLine("Equation({0})", eqn);
        }
    }


    The WCF client that is generated for a duplex contract requires a InstanceContext class to be provided upon construction.
    This InstanceContext class is used as the site for an object that implements the callback interface and handles messages that are sent back from the service.
    An InstanceContext class is constructed with an instance of the CallbackHandler class.
    This object handles messages sent from the service to the client on the callback interface.

    // Construct InstanceContext to handle messages on callback interface
    InstanceContext instanceContext = new InstanceContext(new CallbackHandler());
    
    // Create a client
    CalculatorDuplexClient client = new CalculatorDuplexClient(instanceContext);


    The configuration for the service must be set up to provide a binding that supports both session communication and duplex communication.
    The wsDualHttpBinding element supports session communication and allows duplex communication by providing dual HTTP connections, one for each direction.

    On the client, you must configure an address that the server can use to connect to the client, as shown in the following sample configuration.

    Note:
    Non-duplex clients that fail to authenticate using a secure conversation typically throw a MessageSecurityException.
    However, if a duplex client that uses a secure conversation fails to authenticate, the client receives a TimeoutException instead.

    If you create a client/service using the WSHttpBinding element and you do not include the client callback endpoint, you will receive the following error.
    HTTP could not register URL
    htp://+:80/Temporary_Listen_Addresses/<guid> because TCP port 80 is being used by another application.

    The following sample code shows how to specify the client endpoint address in code.

    WSDualHttpBinding binding = new WSDualHttpBinding();
    EndpointAddress endptadr = new EndpointAddress("http://localhost:12000/DuplexTestUsingCode/Server");
    binding.ClientBaseAddress = new Uri("http://localhost:8000/DuplexTestUsingCode/Client/");

    The following sample code shows how to specify the client endpoint address in configuration.

    <client>
    <endpoint name ="ServerEndpoint" 
    address="http://localhost:12000/DuplexTestUsingConfig/Server"
    bindingConfiguration="WSDualHttpBinding_IDuplexTest" 
    binding="wsDualHttpBinding"
    contract="IDuplexTest" />
    </client>
    <bindings>
    <wsDualHttpBinding>
    <binding name="WSDualHttpBinding_IDuplexTest" 
    clientBaseAddress="http://localhost:8000/myClient/" >
    <security mode="None"/>
    </binding>
    </wsDualHttpBinding>
    </bindings>

    Caution
    The duplex model does not automatically detect when a service or client closes its channel.
    So if a client unexpectedly terminates, by default the service will not be notified, or if a client unexpectedly terminates, the service will not be notified.
    Clients and services can implement their own protocol to notify each other if they so choose.

  • 相关阅读:
    编程用外星人宏建设置教程(在网上找了好久没几个相关帖子,自己研究写下来留个备忘吧)
    通过selenium+pyautogui模拟登陆淘宝(完美实现)
    python之字符串的五种拼接方式
    python之批量文件重命名
    爬虫系列之链家的信息爬取及数据分析
    跟潭州学院的强子老师学习网络爬虫---爬取全书网
    Python之编写测试用例,unittest模块中的TestCase类中的六种断言方法,以及setUp()函数。
    Python学习之路
    GridBagLayout的帮助类
    eclipse和cygwin搭建C++环境的修正版本
  • 原文地址:https://www.cnblogs.com/chucklu/p/4723970.html
Copyright © 2011-2022 走看看