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.

  • 相关阅读:
    WebADI_数据验证1_建立基于PLSQL返回FND Message验证(案例)
    PLSQL_案例优化系列_探寻表设计对SQL优化的重要性(案例4)
    PLSQL_案例优化系列_学习左右SQL执行计划各种方法(案例14)
    PLSQL_案例优化系列_探讨该如何分析读懂析执行计划(案例9)
    WebADI_配置设定08_设定参数WebADI Parameters List(案例)
    WebADI_案例实施01_开发一个基于R12.1.3的简单WebADI Desktop(案例)
    PLSQL_案例优化系列_洞察表连接与SQL优化之间关系(案例8)
    WebADI_配置设定09_设定组件WebADI Components(案例)
    WebADI_配置设定07_设定显示WebADI Content / Mapping(案例)
    WebADI_案例实施03_利用FND_LOAD安装和迁移WEBADI以及设定(案例)
  • 原文地址:https://www.cnblogs.com/chucklu/p/4723970.html
Copyright © 2011-2022 走看看