Procedura: Recuperare metadati e implementare un servizio conforme

Articolo
2025-03-26

Spesso, la stessa persona non progetta e implementa i servizi. Negli ambienti in cui le applicazioni di interoperabilità sono importanti, i contratti possono essere progettati o descritti in WSDL (Web Services Description Language) e uno sviluppatore deve implementare un servizio conforme al contratto fornito. È anche possibile eseguire la migrazione di un servizio esistente a Windows Communication Foundation (WCF) ma mantenere il formato di collegamento. Inoltre, i contratti duplex richiedono ai chiamanti di implementare anche un contratto di callback.

In questi casi, per generare un'interfaccia del contratto di servizio in un linguaggio gestito che è possibile implementare per soddisfare i requisiti del contratto, è necessario usare lo strumento ServiceModel Metadata Utility (Svcutil.exe ) o uno strumento equivalente. In genere, lo strumento di utilità metadati ServiceModel (Svcutil.exe) viene utilizzato per acquisire un contratto di servizio impiegato con una channel factory o un tipo di client WCF, così come con un file di configurazione del client che imposta il binding e l'indirizzo corretti. Per usare il file di configurazione generato, è necessario modificarlo in un file di configurazione del servizio. Potrebbe anche essere necessario modificare il contratto di servizio.

Per recuperare i dati e implementare un servizio conforme

Per generare un file di codice, usare ServiceModel Metadata Utility Tool (Svcutil.exe).

Cercare la parte del file di codice di output che contiene l'interfaccia di interesse (nel caso in cui ne siano presenti più) contrassegnate con l'attributo System.ServiceModel.ServiceContractAttribute. L'esempio di codice seguente illustra le due interfacce generate da ServiceModel Metadata Utility Tool (Svcutil.exe). Il primo (ISampleService) è l'interfaccia del contratto di servizio implementata per creare un servizio conforme. Il secondo (ISampleServiceChannel) è un'interfaccia helper per l'uso client che estende sia l'interfaccia del contratto di servizio che System.ServiceModel.IClientChannel ed è da usare in un'applicazione client.

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(
  Namespace="http://microsoft.wcf.documentation"
)]
public interface ISampleService
{

    [System.ServiceModel.OperationContractAttribute(
      Action="http://microsoft.wcf.documentation/ISampleService/SampleMethod",
      ReplyAction="http://microsoft.wcf.documentation/ISampleService/SampleMethodResponse"
    )]
    [System.ServiceModel.FaultContractAttribute(
      typeof(microsoft.wcf.documentation.SampleFault),
      Action="http://microsoft.wcf.documentation/ISampleService/SampleMethodSampleFaultFault"
    )]
    string SampleMethod(string msg);
}

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
public interface ISampleServiceChannel : ISampleService, System.ServiceModel.IClientChannel
{
}

Se il WSDL non specifica un'azione di risposta per ciascuna delle operazioni, i contratti di operazione generati possono avere la proprietà ReplyAction impostata sul carattere jolly (*). Rimuovere questa impostazione di proprietà. In caso contrario, quando si implementano i metadati del contratto di servizio, i metadati non possono essere esportati per tali operazioni.
Implementare l'interfaccia in una classe e ospitare il servizio. Per un esempio, vedere Procedura: Implementare un contratto di servizioo vedere una semplice implementazione seguente nella sezione Esempio.
Nel file di configurazione client generato dalla ServiceModel Metadata Utility Tool (Svcutil.exe) modificare la sezione di configurazione>client<in una sezione di configurazione>dei servizi di<. Per un esempio di file di configurazione dell'applicazione client generato, vedere la sezione "Esempio" seguente.
Nella sezione configurazione dei servizi <>, creare un attributo name nella sezione configurazione dei servizi <> per l'implementazione del servizio.
Impostare l'attributo servizio name al nome di configurazione per l'implementazione del servizio.
Aggiungere gli elementi di configurazione dell'endpoint che usano il contratto di servizio implementato alla sezione di configurazione del servizio.

Esempio

Nell'esempio di codice seguente viene illustrata la maggior parte di un file di codice generato eseguendo lo strumento di utilità metadati serviceModel (Svcutil.exe) sui file di metadati.

Il codice seguente mostra:

Interfaccia del contratto di servizio che, se implementata, è conforme ai requisiti del contratto (ISampleService).
L'interfaccia helper per l'uso da parte del client che estende sia l'interfaccia del contratto di servizio sia System.ServiceModel.IClientChannel e viene utilizzata in un'applicazione client (ISampleServiceChannel).
La classe helper che estende System.ServiceModel.ClientBase<TChannel> e viene usata in un'applicazione client (SampleServiceClient).
File di configurazione generato dal servizio.
Una semplice implementazione del servizio ISampleService.
Conversione del file di configurazione lato client in una versione lato servizio.

//------------------------------------------------------------------------------
// <auto-generated>
//     This code was generated by a tool.
//     Runtime Version:2.0.50727.42
//
//     Changes to this file may cause incorrect behavior and will be lost if
//     the code is regenerated.
// </auto-generated>
//------------------------------------------------------------------------------

[assembly: System.Runtime.Serialization.ContractNamespaceAttribute("http://microsoft.wcf.documentation", ClrNamespace="microsoft.wcf.documentation")]

namespace microsoft.wcf.documentation
{
    using System.Runtime.Serialization;

    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]
    [System.Runtime.Serialization.DataContractAttribute()]
    public partial class SampleFault : object, System.Runtime.Serialization.IExtensibleDataObject
    {

        private System.Runtime.Serialization.ExtensionDataObject extensionDataField;

        private string FaultMessageField;

        public System.Runtime.Serialization.ExtensionDataObject ExtensionData
        {
            get
            {
                return this.extensionDataField;
            }
            set
            {
                this.extensionDataField = value;
            }
        }

        [System.Runtime.Serialization.DataMemberAttribute()]
        public string FaultMessage
        {
            get
            {
                return this.FaultMessageField;
            }
            set
            {
                this.FaultMessageField = value;
            }
        }
    }
}

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(
  Namespace="http://microsoft.wcf.documentation"
)]
public interface ISampleService
{

    [System.ServiceModel.OperationContractAttribute(
      Action="http://microsoft.wcf.documentation/ISampleService/SampleMethod",
      ReplyAction="http://microsoft.wcf.documentation/ISampleService/SampleMethodResponse"
    )]
    [System.ServiceModel.FaultContractAttribute(
      typeof(microsoft.wcf.documentation.SampleFault),
      Action="http://microsoft.wcf.documentation/ISampleService/SampleMethodSampleFaultFault"
    )]
    string SampleMethod(string msg);
}

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
public interface ISampleServiceChannel : ISampleService, System.ServiceModel.IClientChannel
{
}

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
public partial class SampleServiceClient : System.ServiceModel.ClientBase<ISampleService>, ISampleService
{

    public SampleServiceClient()
    {
    }

    public SampleServiceClient(string endpointConfigurationName) :
            base(endpointConfigurationName)
    {
    }

    public SampleServiceClient(string endpointConfigurationName, string remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public SampleServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public SampleServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :
            base(binding, remoteAddress)
    {
    }

    public string SampleMethod(string msg)
    {
        return base.Channel.SampleMethod(msg);
    }
}

<configuration>
    <system.serviceModel>
        <bindings>
            <basicHttpBinding>
                <binding name="BasicHttpBinding_ISampleService" closeTimeout="00:01:00"
                    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
                    allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard"
                    maxBufferSize="65536" maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
                    messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"
                    useDefaultWebProxy="true">
                    <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
                        maxBytesPerRead="4096" maxNameTableCharCount="16384" />
                    <security mode="None">
                        <transport clientCredentialType="None" proxyCredentialType="None"
                            realm="" />
                        <message clientCredentialType="UserName" algorithmSuite="Default" />
                    </security>
                </binding>
            </basicHttpBinding>
        </bindings>
        <client>
            <endpoint address="http://localhost:8080/SampleService" binding="basicHttpBinding"
                bindingConfiguration="BasicHttpBinding_ISampleService" contract="ISampleService"
                name="BasicHttpBinding_ISampleService" />
        </client>
    </system.serviceModel>
</configuration>

// Implement the service. This is a very simple service.
class SampleService : ISampleService
{
  public string SampleMethod(string msg)
  {
    Console.WriteLine($"The caller said: \"{msg}\"");
    return "The service greets you: " + msg;
  }
}

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpBinding>
        <binding name="BasicHttpBinding_ISampleService" closeTimeout="00:01:00"
            openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
            allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard"
            maxBufferSize="65536" maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
            messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"
            useDefaultWebProxy="true">
          <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
              maxBytesPerRead="4096" maxNameTableCharCount="16384" />
          <security mode="None">
            <transport clientCredentialType="None" proxyCredentialType="None"
                realm="" />
            <message clientCredentialType="UserName" algorithmSuite="Default" />
          </security>
        </binding>
      </basicHttpBinding>
    </bindings>
    <services>
      <service
          name="Microsoft.WCF.Documentation.SampleService">
        <endpoint address="http://localhost:8080/SampleService" binding="basicHttpBinding"
            bindingConfiguration="BasicHttpBinding_ISampleService" contract="Microsoft.WCF.Documentation.ISampleService"
            />
      </service>
    </services>
  </system.serviceModel>
</configuration>

Vedere anche

ServiceModel Metadata Utility Tool (Svcutil.exe)

Condividi tramite

Procedura: Recuperare metadati e implementare un servizio conforme

Per recuperare i dati e implementare un servizio conforme

Esempio

Vedere anche

Risorse aggiuntive