Procedura: pubblicare metadati per un servizio utilizzando codice

Questo è uno dei due argomenti in cui viene illustrato come pubblicare metadati per un servizio Windows Communication Foundation (WCF). Esistono due modi per specificare la pubblicazione di metadati da parte di un servizio ovvero utilizzando un file di configurazione oppure utilizzando il codice. In questo argomento viene illustrato come pubblicare metadati per un servizio utilizzando un codice.

Attenzione:
In questo argomento viene illustrato come pubblicare metadati in modo non sicuro. Qualsiasi client può recuperare i metadati dal servizio. Se è necessario che il servizio pubblichi metadati in modo sicuro, vedere Endpoint di metadati protetto personalizzato.

Per ulteriori informazioni su pubblicazione di metadati in un file di configurazione, vedere Procedura: pubblicare metadati per un servizio utilizzando un file di configurazione. La pubblicazione di metadati consente ai client di recuperare i metadati utilizzando una richiesta GET WS-Transfer o una richiesta HTTP/GET tramite la stringa di query ?wsdl. Per essere certi che il codice funzioni, è necessario creare un servizio WCF di base. Nel codice seguente viene fornito un servizio indipendente di base.

Imports System
Imports System.Runtime.Serialization
Imports System.ServiceModel
Imports System.ServiceModel.Description

<ServiceContract()> _
Public Interface ISimpleService
    <OperationContract()> _
    Function SimpleMethod(ByVal msg As String) As String
End Interface

Class SimpleService
    Implements ISimpleService

    Public Function SimpleMethod(ByVal msg As String) As String Implements ISimpleService.SimpleMethod
        Console.WriteLine("The caller passed in " + msg)
        Return "Hello " + msg
    End Function
End Class

using System;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Description;

namespace Metadata.Samples
{
    [ServiceContract]
    public interface ISimpleService
    {
        [OperationContract]
        string SimpleMethod(string msg);
    }

    class SimpleService : ISimpleService
    {
        public string SimpleMethod(string msg)
        {
            Console.WriteLine("The caller passed in " + msg);
            return "Hello " + msg;
        }
    }

Per pubblicare metadati nel codice

1. All'interno del metodo principale di un'applicazione console, creare un'istanza di un oggetto ServiceHost passando il tipo di servizio e l'indirizzo di base.

   Dim svcHost As New ServiceHost(GetType(SimpleService), New Uri("https://localhost:8001/MetadataSample"))
   

   ServiceHost svcHost = new ServiceHost(typeof(SimpleService), new Uri("https://localhost:8001/MetadataSample"));
   

2. Creare un blocco try subito sotto il codice per il passaggio 1. In tal modo verranno rilevate tutte le eccezioni generate mentre il servizio è in esecuzione.

   Try
   

   try
   {
   

   Catch commProblem As CommunicationException
   
       Console.WriteLine("There was a communication problem. " + commProblem.Message)
       Console.Read()
   End Try
   

   }
   catch (CommunicationException commProblem)
   {
       Console.WriteLine("There was a communication problem. " + commProblem.Message);
       Console.Read();
   }
   

3. Controllare se l'host del servizio contiene già un ServiceMetadataBehavior. In caso contrario, creare una nuova istanza di ServiceMetadataBehavior.

   'Check to see if the service host already has a ServiceMetadataBehavior
   Dim smb As ServiceMetadataBehavior = svcHost.Description.Behaviors.Find(Of ServiceMetadataBehavior)()
   'If not, add one
   If (smb Is Nothing) Then
       smb = New ServiceMetadataBehavior()
   End If
   

   // Check to see if the service host already has a ServiceMetadataBehavior
   ServiceMetadataBehavior smb = svcHost.Description.Behaviors.Find<ServiceMetadataBehavior>();
   // If not, add one
   if (smb == null)
       smb = new ServiceMetadataBehavior();
   

4. Impostare la proprietà HttpGetEnabled su true.

   smb.HttpGetEnabled = True
   

   smb.HttpGetEnabled = true;
   

5. ServiceMetadataBehavior contiene una proprietà MetadataExporter. MetadataExporter contiene una proprietà PolicyVersion. Impostare il valore della proprietà PolicyVersion su Policy15. La proprietà PolicyVersion può essere impostata anche su Policy12. Se è impostata su Policy15, l'utilità di esportazione genera informazioni sui criteri con i metadati conformi a WS-Policy 1.5, mentre se è impostata su Policy12, l'utilità di esportazione genera informazioni sui criteri con i metadati conformi a WS-Policy 1.2.

   smb.MetadataExporter.PolicyVersion = PolicyVersion.Policy15
   

   smb.MetadataExporter.PolicyVersion = PolicyVersion.Policy15;
   

6. Aggiungere l'istanza di ServiceMetadataBehavior alla raccolta di comportamenti dell'host del servizio.

   svcHost.Description.Behaviors.Add(smb)
   

   svcHost.Description.Behaviors.Add(smb);
   

7. Aggiungere l'endpoint di scambio dei metadati all'host del servizio.

   'Add MEX endpoint
   svcHost.AddServiceEndpoint( _
         ServiceMetadataBehavior.MexContractName, _
         MetadataExchangeBindings.CreateMexHttpBinding(), _
         "mex")
   

   // Add MEX endpoint
   svcHost.AddServiceEndpoint(
     ServiceMetadataBehavior.MexContractName,
     MetadataExchangeBindings.CreateMexHttpBinding(),
     "mex"
   );
   

8. Aggiungere un endpoint dell'applicazione all'host del servizio.

   'Add application endpoint
   svcHost.AddServiceEndpoint(GetType(ISimpleService), New WSHttpBinding(), "")
   

   // Add application endpoint
   svcHost.AddServiceEndpoint(typeof(ISimpleService), new WSHttpBinding(), "");
   

   Nota:
   Se non vengono aggiunti endpoint al servizio, il runtime aggiunge gli endpoint predefiniti. In questo esempio poiché il servizio ha un oggetto ServiceMetadataBehavior impostato su true, è abilitata la pubblicazione di metadati. Per ulteriori informazioni su endpoint predefiniti, vedere Configurazione semplificata e Configurazione semplificata per servizi WCF.

9. Aprire l'host del servizio e attendere le chiamate in ingresso. Quando l'utente preme il tasto INVIO, chiudere l'host del servizio.

   'Open the service host to accept incoming calls
   svcHost.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 ServiceHostBase to shutdown the service.
   svcHost.Close()
   

   // Open the service host to accept incoming calls
   svcHost.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 ServiceHostBase to shutdown the service.
   svcHost.Close();
   

10. Compilare ed eseguire l'applicazione console.

11. Utilizzare Internet Explorer per accedere all'indirizzo di base del servizio (https://localhost:8001/MetadataSample in questo esempio) e verificare che la pubblicazione dei metadati sia attivata. Dovrebbe venire visualizzata una pagina Web con scritto "Simple Service" in alto, seguito subito sotto da "È stato creato un servizio". In caso contrario, all'inizio della pagina risultante verrà visualizzato il messaggio: "La pubblicazione dei metadati per il servizio è attualmente disabilitata".

Esempio

Nell'esempio di codice seguente viene illustrata l'implementazione di un servizio di base WCF che pubblica i metadati per il servizio nel codice.

Imports System
Imports System.Runtime.Serialization
Imports System.ServiceModel
Imports System.ServiceModel.Description

<ServiceContract()> _
Public Interface ISimpleService
    <OperationContract()> _
    Function SimpleMethod(ByVal msg As String) As String
End Interface

Class SimpleService
    Implements ISimpleService

    Public Function SimpleMethod(ByVal msg As String) As String Implements ISimpleService.SimpleMethod
        Console.WriteLine("The caller passed in " + msg)
        Return "Hello " + msg
    End Function
End Class

Module Module1

    Sub Main()
        Dim svcHost As New ServiceHost(GetType(SimpleService), New Uri("https://localhost:8001/MetadataSample"))
        Try
            'Check to see if the service host already has a ServiceMetadataBehavior
            Dim smb As ServiceMetadataBehavior = svcHost.Description.Behaviors.Find(Of ServiceMetadataBehavior)()
            'If not, add one
            If (smb Is Nothing) Then
                smb = New ServiceMetadataBehavior()
            End If
            smb.HttpGetEnabled = True
            smb.MetadataExporter.PolicyVersion = PolicyVersion.Policy15
            svcHost.Description.Behaviors.Add(smb)
            'Add MEX endpoint
            svcHost.AddServiceEndpoint( _
                  ServiceMetadataBehavior.MexContractName, _
                  MetadataExchangeBindings.CreateMexHttpBinding(), _
                  "mex")
            'Add application endpoint
            svcHost.AddServiceEndpoint(GetType(ISimpleService), New WSHttpBinding(), "")
            'Open the service host to accept incoming calls
            svcHost.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 ServiceHostBase to shutdown the service.
            svcHost.Close()
        Catch commProblem As CommunicationException

            Console.WriteLine("There was a communication problem. " + commProblem.Message)
            Console.Read()
        End Try
    End Sub
End Module

using System;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Description;

namespace Metadata.Samples
{
    [ServiceContract]
    public interface ISimpleService
    {
        [OperationContract]
        string SimpleMethod(string msg);
    }

    class SimpleService : ISimpleService
    {
        public string SimpleMethod(string msg)
        {
            Console.WriteLine("The caller passed in " + msg);
            return "Hello " + msg;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            ServiceHost svcHost = new ServiceHost(typeof(SimpleService), new Uri("https://localhost:8001/MetadataSample"));
            try
            {
                // Check to see if the service host already has a ServiceMetadataBehavior
                ServiceMetadataBehavior smb = svcHost.Description.Behaviors.Find<ServiceMetadataBehavior>();
                // If not, add one
                if (smb == null)
                    smb = new ServiceMetadataBehavior();
                smb.HttpGetEnabled = true;
                smb.MetadataExporter.PolicyVersion = PolicyVersion.Policy15;
                svcHost.Description.Behaviors.Add(smb);
                // Add MEX endpoint
                svcHost.AddServiceEndpoint(
                  ServiceMetadataBehavior.MexContractName,
                  MetadataExchangeBindings.CreateMexHttpBinding(),
                  "mex"
                );
                // Add application endpoint
                svcHost.AddServiceEndpoint(typeof(ISimpleService), new WSHttpBinding(), "");
                // Open the service host to accept incoming calls
                svcHost.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 ServiceHostBase to shutdown the service.
                svcHost.Close();
            }
            catch (CommunicationException commProblem)
            {
                Console.WriteLine("There was a communication problem. " + commProblem.Message);
                Console.Read();
            }
        }
    }
}

Vedere anche

Attività

Procedura: ospitare un servizio WCF in un'applicazione gestita
Servizio indipendente
Procedura: pubblicare metadati per un servizio utilizzando un file di configurazione

Concetti

Panoramica dell'architettura dei metadati
Utilizzo di metadati