Lezen in het Engels

Delen via

Procedure: Berichten in wachtrij uitwisselen met WCF-eindpunten

  • Artikel

Wachtrijen zorgen ervoor dat betrouwbare berichten kunnen optreden tussen een client en een WCF-service (Windows Communication Foundation), zelfs als de service niet beschikbaar is op het moment van communicatie. De volgende procedures laten zien hoe u duurzame communicatie tussen een client en een service kunt garanderen met behulp van de standaardbinding in de wachtrij bij het implementeren van de WCF-service.

In deze sectie wordt uitgelegd hoe u kunt gebruiken NetMsmqBinding voor communicatie in de wachtrij tussen een WCF-client en een WCF-service.

Wachtrijen gebruiken in een WCF-service

  1. Definieer een servicecontract met behulp van een interface die is gemarkeerd met de ServiceContractAttribute. Markeer de bewerkingen in de interface die deel uitmaken van het servicecontract met de OperationContractAttribute en geef deze op als eenrichtingswijze omdat er geen reactie op de methode wordt geretourneerd. De volgende code bevat een voorbeeldservicecontract en de bijbehorende bewerkingsdefinitie.

    [ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface IOrderProcessor
{
    [OperationContract(IsOneWay = true)]
    void SubmitPurchaseOrder(PurchaseOrder po);
}

  2. Wanneer het servicecontract door de gebruiker gedefinieerde typen doorgeeft, moet u gegevenscontracten voor deze typen definiëren. De volgende code toont twee gegevenscontracten en PurchaseOrderPurchaseOrderLineItem. Deze twee typen definiëren gegevens die naar de service worden verzonden. (Houd er rekening mee dat de klassen die dit gegevenscontract definiëren ook een aantal methoden definiëren. Deze methoden worden niet beschouwd als onderdeel van het gegevenscontract. Alleen leden die met het DataMemberAttribute kenmerk zijn gedeclareerd, maken deel uit van het gegevenscontract.)

    [DataContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
public class PurchaseOrder
{
    static readonly string[] OrderStates = { "Pending", "Processed", "Shipped" };
    static Random statusIndexer = new Random(137);

    [DataMember]
    public string PONumber;

    [DataMember]
    public string CustomerId;

    [DataMember]
    public PurchaseOrderLineItem[] orderLineItems;

    public float TotalCost
    {
        get
        {
            float totalCost = 0;
            foreach (PurchaseOrderLineItem lineItem in orderLineItems)
                totalCost += lineItem.TotalCost;
            return totalCost;
        }
    }

    public string Status
    {
        get
        {
            return OrderStates[statusIndexer.Next(3)];
        }
    }

    public override string ToString()
    {
        System.Text.StringBuilder strbuf = new System.Text.StringBuilder("Purchase Order: " + PONumber + "\n");
        strbuf.Append("\tCustomer: " + CustomerId + "\n");
        strbuf.Append("\tOrderDetails\n");

        foreach (PurchaseOrderLineItem lineItem in orderLineItems)
        {
            strbuf.Append("\t\t" + lineItem.ToString());
        }

        strbuf.Append("\tTotal cost of this order: $" + TotalCost + "\n");
        strbuf.Append("\tOrder status: " + Status + "\n");
        return strbuf.ToString();
    }
}

  3. Implementeer de methoden van het servicecontract dat is gedefinieerd in de interface in een klasse.

    public class OrderProcessorService : IOrderProcessor
{
    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]
    public void SubmitPurchaseOrder(PurchaseOrder po)
    {
        Orders.Add(po);
        Console.WriteLine("Processing {0} ", po);
    }
}

    Let op de OperationBehaviorAttribute geplaatste methode SubmitPurchaseOrder . Hiermee geeft u op dat deze bewerking moet worden aangeroepen binnen een transactie en dat de transactie automatisch wordt voltooid wanneer de methode is voltooid.

  4. Maak een transactionele wachtrij met behulp van System.Messaging. U kunt ervoor kiezen om de wachtrij te maken met microsoft Message Queuing (MSMQ) Microsoft Management Console (MMC) in plaats daarvan. Als dit het geval is, moet u een transactionele wachtrij maken.

    // Create the transacted MSMQ queue if necessary.
if (!MessageQueue.Exists(queueName))
    MessageQueue.Create(queueName, true);

  5. Definieer een ServiceEndpoint in-configuratie waarmee het serviceadres wordt opgegeven en de standaardbinding NetMsmqBinding wordt gebruikt. Zie WCF-services configureren voor meer informatie over het gebruik van WCF-configuratie.

  6. Maak een host voor de OrderProcessing service die ServiceHost berichten uit de wachtrij leest en verwerkt. Open de servicehost om de service beschikbaar te maken. Geef een bericht weer waarmee de gebruiker op een willekeurige toets moet drukken om de service te beëindigen. Oproep ReadLine om te wachten totdat de toets is ingedrukt en sluit vervolgens de service.

    // Create a ServiceHost for the OrderProcessorService type.
using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))
{
    // Open the ServiceHost to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHostB to shutdown the service.
    serviceHost.Close();
}

Een client maken voor de service in de wachtrij

  1. In het volgende voorbeeld ziet u hoe u de hostingtoepassing uitvoert en het hulpprogramma Svcutil.exe gebruikt om de WCF-client te maken.

    svcutil http://localhost:8000/ServiceModelSamples/service

  2. Definieer een ServiceEndpoint in configuratie waarmee het adres wordt opgegeven en de standaardbinding NetMsmqBinding wordt gebruikt, zoals wordt weergegeven in het volgende voorbeeld.

  3. Maak een transactiebereik om naar de transactionele wachtrij te schrijven, roep de SubmitPurchaseOrder bewerking aan en sluit de WCF-client, zoals wordt weergegeven in het volgende voorbeeld.

    //Create a transaction scope.
using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))
{
    // Make a queued call to submit the purchase order.
    client.SubmitPurchaseOrder(po);
    // Complete the transaction.
    scope.Complete();
}

//Closing the client gracefully closes the connection and cleans up resources.
client.Close();

Opmerking

In de volgende voorbeelden ziet u de servicecode, de hostingtoepassing, het App.config-bestand en de clientcode die voor dit voorbeeld is opgenomen.

// This is the service code
//  Copyright (c) Microsoft Corporation.  All Rights Reserved.

using System;
using System.ServiceModel.Channels;
using System.Configuration;
using System.Messaging;
using System.ServiceModel;
using System.Transactions;
using System.Runtime.Serialization;
using System.Collections.Generic;

namespace Microsoft.ServiceModel.Samples
{
    // Define the purchase order line item.
    [DataContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
    public class PurchaseOrderLineItem
    {
        [DataMember]
        public string ProductId;

        [DataMember]
        public float UnitCost;

        [DataMember]
        public int Quantity;

        public override string ToString()
        {
            String displayString = "Order LineItem: " + Quantity + " of "  + ProductId + " @unit price: $" + UnitCost + "\n";
            return displayString;
        }

        public float TotalCost
        {
            get { return UnitCost * Quantity; }
        }
    }

    // Define the purchase order.
    [DataContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
    public class PurchaseOrder
    {
        static readonly string[] OrderStates = { "Pending", "Processed", "Shipped" };
        static Random statusIndexer = new Random(137);

        [DataMember]
        public string PONumber;

        [DataMember]
        public string CustomerId;

        [DataMember]
        public PurchaseOrderLineItem[] orderLineItems;

        public float TotalCost
        {
            get
            {
                float totalCost = 0;
                foreach (PurchaseOrderLineItem lineItem in orderLineItems)
                    totalCost += lineItem.TotalCost;
                return totalCost;
            }
        }

        public string Status
        {
            get
            {
                return OrderStates[statusIndexer.Next(3)];
            }
        }

        public override string ToString()
        {
            System.Text.StringBuilder strbuf = new System.Text.StringBuilder("Purchase Order: " + PONumber + "\n");
            strbuf.Append("\tCustomer: " + CustomerId + "\n");
            strbuf.Append("\tOrderDetails\n");

            foreach (PurchaseOrderLineItem lineItem in orderLineItems)
            {
                strbuf.Append("\t\t" + lineItem.ToString());
            }

            strbuf.Append("\tTotal cost of this order: $" + TotalCost + "\n");
            strbuf.Append("\tOrder status: " + Status + "\n");
            return strbuf.ToString();
        }
    }

    // Order Processing Logic
    // Can replace with transaction-aware resource such as SQL or transacted hashtable to hold the purchase orders.
    // This example uses a non-transactional resource.
    public class Orders
    {
        static Dictionary<string, PurchaseOrder> purchaseOrders = new Dictionary<string, PurchaseOrder>();

        public static void Add(PurchaseOrder po)
        {
            purchaseOrders.Add(po.PONumber, po);
        }

        public static string GetOrderStatus(string poNumber)
        {
            PurchaseOrder po;
            if (purchaseOrders.TryGetValue(poNumber, out po))
                return po.Status;
            else
                return null;
        }

        public static void DeleteOrder(string poNumber)
        {
            if(purchaseOrders[poNumber] != null)
                purchaseOrders.Remove(poNumber);
        }
    }

    // Define a service contract.
    [ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
    public interface IOrderProcessor
    {
        [OperationContract(IsOneWay = true)]
        void SubmitPurchaseOrder(PurchaseOrder po);
    }

    // Service class that implements the service contract.
    // Added code to write output to the console window.
    public class OrderProcessorService : IOrderProcessor
    {
        [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]
        public void SubmitPurchaseOrder(PurchaseOrder po)
        {
            Orders.Add(po);
            Console.WriteLine("Processing {0} ", po);
        }
    }
}

// This is the hosting application.

using System;
using System.ServiceModel.Channels;
using System.Configuration;
using System.Messaging;
using System.ServiceModel;
using System.Transactions;
using System.Runtime.Serialization;
using System.Collections.Generic;

namespace Microsoft.ServiceModel.Samples
{
    class hostApp
    {
        // Host the service within this EXE console application.
        public static void Main()
        {
            // Get MSMQ queue name from appsettings in configuration.
            string queueName = ConfigurationManager.AppSettings["queueName"];

            // Create the transacted MSMQ queue if necessary.
            if (!MessageQueue.Exists(queueName))
                MessageQueue.Create(queueName, true);

            // Create a ServiceHost for the OrderProcessorService type.
            using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))
            {
                // Open the ServiceHost to create listeners and start listening for messages.
                serviceHost.Open();

                // The service can now be accessed.
                Console.WriteLine("The service is ready.");
                Console.WriteLine("Press <ENTER> to terminate service.");
                Console.WriteLine();
                Console.ReadLine();

                // Close the ServiceHostB to shutdown the service.
                serviceHost.Close();
            }
        }
    }
}

// This is the client code.
//  Copyright (c) Microsoft Corporation.  All Rights Reserved.

using System;
using System.Configuration;
using System.Messaging;
using System.ServiceModel;
using System.Transactions;

namespace Microsoft.ServiceModel.Samples
{
    //The service contract is defined in generatedClient.cs, generated from the service by the svcutil tool.

    //Client implementation code.
    class Client
    {
        static void Main()
        {
            // Create a client.
            OrderProcessorClient client = new OrderProcessorClient();

            // Create the purchase order.
            PurchaseOrder po = new PurchaseOrder();
            po.CustomerId = "somecustomer.com";
            po.PONumber = Guid.NewGuid().ToString();

            PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();
            lineItem1.ProductId = "Blue Widget";
            lineItem1.Quantity = 54;
            lineItem1.UnitCost = 29.99F;

            PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();
            lineItem2.ProductId = "Red Widget";
            lineItem2.Quantity = 890;
            lineItem2.UnitCost = 45.89F;

            po.orderLineItems = new PurchaseOrderLineItem[2];
            po.orderLineItems[0] = lineItem1;
            po.orderLineItems[1] = lineItem2;

            //Create a transaction scope.
            using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))
            {
                // Make a queued call to submit the purchase order.
                client.SubmitPurchaseOrder(po);
                // Complete the transaction.
                scope.Complete();
            }

            //Closing the client gracefully closes the connection and cleans up resources.
            client.Close();

            Console.WriteLine();
            Console.WriteLine("Press <ENTER> to terminate client.");
            Console.ReadLine();
        }
    }
}

Zie ook