Instrukcje: Ujawnianie kontraktu klientom sieci Web i SOAP

Domyślnie program Windows Communication Foundation (WCF) udostępnia punkty końcowe tylko klientom protokołu SOAP. W temacie Instrukcje: tworzenie podstawowej internetowej usługi HTTP programu WCF punkt końcowy jest udostępniany klientom niebędącym protokołem SOAP. Czasami chcesz udostępnić ten sam kontrakt na oba sposoby, jako punkt końcowy sieci Web i jako punkt końcowy protokołu SOAP. W tym temacie przedstawiono przykład tego, jak to zrobić.

Aby zdefiniować kontrakt usługi

1. Zdefiniuj kontrakt usługi przy użyciu interfejsu oznaczonego ServiceContractAttributeza pomocą elementu i WebInvokeAttributeWebGetAttribute atrybutów, jak pokazano w poniższym kodzie:

   [ServiceContract]
   public interface IService
   {
       [OperationContract]
       [WebGet]
       string EchoWithGet(string s);
   
       [OperationContract]
       [WebInvoke]
       string EchoWithPost(string s);
   }
   

   <ServiceContract()> _
   Public Interface IService
   
       <OperationContract()> _
       <WebGet()> _
       Function EchoWithGet(ByVal s As String) As String
   
       <OperationContract()> _
       <WebInvoke()> _
       Function EchoWithPost(ByVal s As String) As String
   End Interface
   

   Uwaga

   Domyślnie WebInvokeAttribute mapuje wywołania POST na operację. Można jednak określić metodę mapowania na operację, określając parametr "method=". WebGetAttribute nie ma parametru "method=" i mapuje tylko wywołania GET do operacji usługi.

2. Zaimplementuj kontrakt usługi, jak pokazano w poniższym kodzie:

   public class Service : IService
   {
       public string EchoWithGet(string s)
       {
           return "You said " + s;
       }
   
       public string EchoWithPost(string s)
       {
           return "You said " + s;
       }
   }
   

   Public Class Service
       Implements IService
       Public Function EchoWithGet(ByVal s As String) As String Implements IService.EchoWithGet
           Return "You said " + s
       End Function
   
       Public Function EchoWithPost(ByVal s As String) As String Implements IService.EchoWithPost
           Return "You said " + s
       End Function
   End Class
   

Aby hostować usługę

1. ServiceHost Utwórz obiekt, jak pokazano w poniższym kodzie:

   ServiceHost host = new ServiceHost(typeof(Service), new Uri("http://localhost:8000"));
   

   Dim host As New ServiceHost(GetType(Service), New Uri("http://localhost:8000"))
   

2. Dodaj element ServiceEndpoint with BasicHttpBinding dla punktu końcowego protokołu SOAP, jak pokazano w poniższym kodzie:

   host.AddServiceEndpoint(typeof(IService), new BasicHttpBinding(), "Soap");
   

   host.AddServiceEndpoint(GetType(IService), New BasicHttpBinding(), "Soap")
   

3. Dodaj element ServiceEndpoint with WebHttpBinding dla punktu końcowego innego niż SOAP i dodaj element WebHttpBehavior do punktu końcowego, jak pokazano w poniższym kodzie:

   ServiceEndpoint endpoint = host.AddServiceEndpoint(typeof(IService), new WebHttpBinding(), "Web");
   endpoint.Behaviors.Add(new WebHttpBehavior());
   

   Dim endpoint As ServiceEndpoint
   endpoint = host.AddServiceEndpoint(GetType(IService), New WebHttpBinding(), "Web")
   endpoint.Behaviors.Add(New WebHttpBehavior())
   

4. ServiceHost Wywołaj Open() wystąpienie, aby otworzyć hosta usługi, jak pokazano w poniższym kodzie:

   host.Open();
   

   host.Open()
   

Aby wywołać operacje usługi mapowane na metodę GET w przeglądarce

1. W przeglądarce internetowej przejdź do "http://localhost:8000/Web/EchoWithGet?s=Hello, world!". Adres URL zawiera podstawowy adres usługi (http://localhost:8000/), względny adres punktu końcowego (""), operację usługi do wywołania ("EchoWithGet") oraz znak zapytania, po którym następuje lista nazwanych parametrów rozdzielonych ampersand (&).

Aby wywołać operacje usługi w internetowym punkcie końcowym w kodzie

1. Utwórz wystąpienie WebChannelFactory<TChannel> w using bloku, jak pokazano w poniższym kodzie.

   using (WebChannelFactory<IService> wcf = new WebChannelFactory<IService>(new Uri("http://localhost:8000/Web")))
   

   Using wcf As New WebChannelFactory(Of IService)(New Uri("http://localhost:8000/Web"))
   

Uwaga

Close() element jest automatycznie wywoływany na kanale na końcu using bloku.

1. Utwórz kanał i wywołaj usługę, jak pokazano w poniższym kodzie.

   IService channel = wcf.CreateChannel();
   
   string s;
   
   Console.WriteLine("Calling EchoWithGet by HTTP GET: ");
   s = channel.EchoWithGet("Hello, world");
   Console.WriteLine("   Output: {0}", s);
   
   Console.WriteLine("");
   Console.WriteLine("This can also be accomplished by navigating to");
   Console.WriteLine("http://localhost:8000/Web/EchoWithGet?s=Hello, world!");
   Console.WriteLine("in a web browser while this sample is running.");
   
   Console.WriteLine("");
   
   Console.WriteLine("Calling EchoWithPost by HTTP POST: ");
   s = channel.EchoWithPost("Hello, world");
   Console.WriteLine("   Output: {0}", s);
   

   Dim channel As IService = wcf.CreateChannel()
   
   Dim s As String
   
   Console.WriteLine("Calling EchoWithGet by HTTP GET: ")
   s = channel.EchoWithGet("Hello, world")
   Console.WriteLine("   Output:  {0}", s)
   
   Console.WriteLine("")
   Console.WriteLine("This can also be accomplished by navigating to")
   Console.WriteLine("http://localhost:8000/Web/EchoWithGet?s=Hello, world!")
   Console.WriteLine("in a web browser while this sample is running.")
   
   Console.WriteLine("")
   
   Console.WriteLine("Calling EchoWithPost by HTTP POST: ")
   s = channel.EchoWithPost("Hello, world")
   Console.WriteLine("   Output:  {0}", s)
   

Aby wywołać operacje usługi w punkcie końcowym protokołu SOAP

1. Utwórz wystąpienie ChannelFactory w using bloku, jak pokazano w poniższym kodzie.

   using (ChannelFactory<IService> scf = new ChannelFactory<IService>(new BasicHttpBinding(), "http://localhost:8000/Soap"))
   

   Using scf As New ChannelFactory(Of IService)(New BasicHttpBinding(), "http://localhost:8000/Soap")
   

2. Utwórz kanał i wywołaj usługę, jak pokazano w poniższym kodzie.

   IService channel = scf.CreateChannel();
   
   string s;
   
   Console.WriteLine("Calling EchoWithGet on SOAP endpoint: ");
   s = channel.EchoWithGet("Hello, world");
   Console.WriteLine("   Output: {0}", s);
   
   Console.WriteLine("");
   
   Console.WriteLine("Calling EchoWithPost on SOAP endpoint: ");
   s = channel.EchoWithPost("Hello, world");
   Console.WriteLine("   Output: {0}", s);
   

   Dim channel As IService = scf.CreateChannel()
   
   Dim s As String
   
   Console.WriteLine("Calling EchoWithGet on SOAP endpoint: ")
   s = channel.EchoWithGet("Hello, world")
   Console.WriteLine("   Output:  {0}", s)
   
   Console.WriteLine("")
   
   Console.WriteLine("Calling EchoWithPost on SOAP endpoint: ")
   s = channel.EchoWithPost("Hello, world")
   Console.WriteLine("   Output:  {0}", s)
   

Aby zamknąć hosta usługi

1. Zamknij hosta usługi, jak pokazano w poniższym kodzie.

   host.Close();
   

   host.Close()
   

Przykład

Poniżej przedstawiono pełną listę kodu dla tego tematu:

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.ServiceModel.Web;
using System.Text;

namespace Microsoft.ServiceModel.Samples.BasicWebProgramming
{
    [ServiceContract]
    public interface IService
    {
        [OperationContract]
        [WebGet]
        string EchoWithGet(string s);

        [OperationContract]
        [WebInvoke]
        string EchoWithPost(string s);
    }

    public class Service : IService
    {
        public string EchoWithGet(string s)
        {
            return "You said " + s;
        }

        public string EchoWithPost(string s)
        {
            return "You said " + s;
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            ServiceHost host = new ServiceHost(typeof(Service), new Uri("http://localhost:8000"));
            host.AddServiceEndpoint(typeof(IService), new BasicHttpBinding(), "Soap");
            ServiceEndpoint endpoint = host.AddServiceEndpoint(typeof(IService), new WebHttpBinding(), "Web");
            endpoint.Behaviors.Add(new WebHttpBehavior());

            try
            {
                host.Open();

                using (WebChannelFactory<IService> wcf = new WebChannelFactory<IService>(new Uri("http://localhost:8000/Web")))
                {
                    IService channel = wcf.CreateChannel();

                    string s;

                    Console.WriteLine("Calling EchoWithGet by HTTP GET: ");
                    s = channel.EchoWithGet("Hello, world");
                    Console.WriteLine("   Output: {0}", s);

                    Console.WriteLine("");
                    Console.WriteLine("This can also be accomplished by navigating to");
                    Console.WriteLine("http://localhost:8000/Web/EchoWithGet?s=Hello, world!");
                    Console.WriteLine("in a web browser while this sample is running.");

                    Console.WriteLine("");

                    Console.WriteLine("Calling EchoWithPost by HTTP POST: ");
                    s = channel.EchoWithPost("Hello, world");
                    Console.WriteLine("   Output: {0}", s);
                    Console.WriteLine("");
                }
                using (ChannelFactory<IService> scf = new ChannelFactory<IService>(new BasicHttpBinding(), "http://localhost:8000/Soap"))
                {
                    IService channel = scf.CreateChannel();

                    string s;

                    Console.WriteLine("Calling EchoWithGet on SOAP endpoint: ");
                    s = channel.EchoWithGet("Hello, world");
                    Console.WriteLine("   Output: {0}", s);

                    Console.WriteLine("");

                    Console.WriteLine("Calling EchoWithPost on SOAP endpoint: ");
                    s = channel.EchoWithPost("Hello, world");
                    Console.WriteLine("   Output: {0}", s);
                    Console.WriteLine("");
                }

                Console.WriteLine("Press [Enter] to terminate");
                Console.ReadLine();
                host.Close();
            }
            catch (CommunicationException cex)
            {
                Console.WriteLine("An exception occurred: {0}", cex.Message);
                host.Abort();
            }
        }
    }
}

Imports System.Collections.Generic
Imports System.ServiceModel
Imports System.ServiceModel.Description
Imports System.ServiceModel.Web
Imports System.Text

<ServiceContract()> _
Public Interface IService

    <OperationContract()> _
    <WebGet()> _
    Function EchoWithGet(ByVal s As String) As String

    <OperationContract()> _
    <WebInvoke()> _
    Function EchoWithPost(ByVal s As String) As String
End Interface

Public Class Service
    Implements IService
    Public Function EchoWithGet(ByVal s As String) As String Implements IService.EchoWithGet
        Return "You said " + s
    End Function

    Public Function EchoWithPost(ByVal s As String) As String Implements IService.EchoWithPost
        Return "You said " + s
    End Function
End Class
Module Program

    Sub Main()
        Dim host As New ServiceHost(GetType(Service), New Uri("http://localhost:8000"))
        host.AddServiceEndpoint(GetType(IService), New BasicHttpBinding(), "Soap")
        Dim endpoint As ServiceEndpoint
        endpoint = host.AddServiceEndpoint(GetType(IService), New WebHttpBinding(), "Web")
        endpoint.Behaviors.Add(New WebHttpBehavior())

        Try
            host.Open()

            Using wcf As New WebChannelFactory(Of IService)(New Uri("http://localhost:8000/Web"))

                Dim channel As IService = wcf.CreateChannel()

                Dim s As String

                Console.WriteLine("Calling EchoWithGet by HTTP GET: ")
                s = channel.EchoWithGet("Hello, world")
                Console.WriteLine("   Output:  {0}", s)

                Console.WriteLine("")
                Console.WriteLine("This can also be accomplished by navigating to")
                Console.WriteLine("http://localhost:8000/Web/EchoWithGet?s=Hello, world!")
                Console.WriteLine("in a web browser while this sample is running.")

                Console.WriteLine("")

                Console.WriteLine("Calling EchoWithPost by HTTP POST: ")
                s = channel.EchoWithPost("Hello, world")
                Console.WriteLine("   Output:  {0}", s)
                Console.WriteLine("")
            End Using
            Using scf As New ChannelFactory(Of IService)(New BasicHttpBinding(), "http://localhost:8000/Soap")

                Dim channel As IService = scf.CreateChannel()

                Dim s As String

                Console.WriteLine("Calling EchoWithGet on SOAP endpoint: ")
                s = channel.EchoWithGet("Hello, world")
                Console.WriteLine("   Output:  {0}", s)

                Console.WriteLine("")

                Console.WriteLine("Calling EchoWithPost on SOAP endpoint: ")
                s = channel.EchoWithPost("Hello, world")
                Console.WriteLine("   Output:  {0}", s)
                Console.WriteLine("")
            End Using


            Console.WriteLine("Press <Enter> to terminate")
            Console.ReadLine()
            host.Close()
        Catch cex As CommunicationException
            Console.WriteLine("An exception occurred:  {0}", cex.Message)
            host.Abort()
        End Try

    End Sub
End Module

Kompilowanie kodu

Podczas kompilowania Service.cs należy odwołać się do System.ServiceModel.dll i System.ServiceModel.Web.dll.

Zobacz też

• WebHttpBinding
• WebGetAttribute
• WebInvokeAttribute
• WebServiceHost
• ChannelFactory
• WebHttpBehavior
• Model programowania protokołu HTTP sieci Web w programie WCF