.net 6 Create Soap Service

5 min read Jun 03, 2024

Créer un service SOAP avec .NET 6

Le service Web SOAP (Simple Object Access Protocol) est un protocole de communication basé sur XML pour l'échange de données entre applications. Il est largement utilisé dans les environnements d'entreprise pour son interopérabilité et sa fiabilité.

Dans ce tutoriel, nous allons découvrir comment créer un service SOAP simple avec .NET 6.

Prérequis

Visual Studio 2022 ou Visual Studio Code avec l'extension C#
.NET 6 SDK
Connaissance de base de C# et du développement Web

Étapes de création du service SOAP

Créer un nouveau projet .NET 6

Ouvrez Visual Studio et créez un nouveau projet "Application Web ASP.NET Core". Sélectionnez le modèle "API Web" et assurez-vous que "Activer HTTPS" est coché.
Ajouter le package NuGet "System.ServiceModel.Primitives"

Ce package contient les classes nécessaires pour le développement de services SOAP. Vous pouvez l'ajouter via la console de gestion de package NuGet (Package Manager Console) en exécutant la commande suivante:
```
Install-Package System.ServiceModel.Primitives
```
Créer un contrat de service

Un contrat de service définit les opérations et les types de données utilisés par votre service SOAP. Créez une nouvelle classe dans votre projet et ajoutez les attributs suivants :
```
using System.Runtime.Serialization;
using System.ServiceModel;

[ServiceContract]
public interface IMyService
{
    [OperationContract]
    string GetData(string value);
}
```
- [ServiceContract] : Définit la classe comme un contrat de service SOAP.
- [OperationContract] : Définit une opération de service qui peut être appelée à partir d'un client SOAP.
Créer une implémentation du service

Créez une nouvelle classe qui implémente le contrat de service et fournit la logique métier pour chaque opération :
```
public class MyService : IMyService
{
    public string GetData(string value)
    {
        return $"Vous avez envoyé : {value}";
    }
}
```
Configurer le service SOAP

Dans le fichier Program.cs, configurez le service SOAP en ajoutant les lignes suivantes :
```
builder.Services.AddServiceModelServices();

builder.Services.AddScoped();

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// Configurez le service SOAP
builder.Services.AddServiceModel(options =>
{
    options.AddService();
    options.AddMetadataEndpoint();
});
```
- AddServiceModelServices() : Ajoute les services nécessaires pour l'hébergement du service SOAP.
- AddService<MyService>() : Ajoute le service MyService à la configuration du service SOAP.
- AddMetadataEndpoint() : Active le point de terminaison de métadonnées WS-MetadataExchange (MEX), qui permet aux clients de découvrir les opérations et les types de données du service SOAP.
Exécuter le service

Démarrez l'application et le service SOAP sera accessible via l'adresse https://localhost:7238/service.svc.

Consommer le service SOAP

Vous pouvez consommer le service SOAP à l'aide d'un client SOAP ou d'un outil de test comme SoapUI. Vous aurez besoin de l'adresse du service et des définitions WSDL (Web Services Description Language).

Conclusion

Créer un service SOAP avec .NET 6 est relativement simple et efficace. En utilisant les classes et les attributs fournis par le package System.ServiceModel.Primitives, vous pouvez rapidement créer des services Web SOAP robustes et interopérables.

Ce tutoriel vous a montré les étapes de base de la création d'un service SOAP avec .NET 6. Vous pouvez maintenant étendre ce service en ajoutant d'autres opérations, en manipulant des données complexes et en intégrant des fonctionnalités avancées.