Tuto - Les bases du WLangage

Rappels des concepts de la POO

• La méthode Constructeur appartenant à la classe est automatiquement appelée lors de la déclaration (instanciation) de l'objet du type de cette même classe.
• La méthode Destructeur appartenant à la classe est automatiquement appelée lors de la destruction (libération) de l'objet du type de cette même classe. Cette exécution de la méthode Destructeur est dépendante de la durée de vie de l'objet selon comme l'objet a été déclaré (global ou local),

Création de la classe

1. Sous le volet "Accueil", dans le groupe "Général", cliquez sur "Nouveau".
2. Dans la fenêtre qui s'affiche, cliquez sur "Code" puis sur "Classe".
3. Indiquez le nom de la classe à créer, CProduit dans notre exemple.
4. Validez. Le code WLangage de la classe est affiché. Il est composé de trois sections :
   • Déclaration
   • Constructeur
   • Destructeur
5. Dans l'événement "Déclaration", saisissez le code suivant :
   

   CProduit est une Classe
   
   PUBLIC
   	mg_SeuilAlerteStock est un entier = 20
   
   PRIVÉ
   	m_Référence est une chaîne
   	m_Libellé est une chaîne
   	m_Stock est un entier
   FIN
   
   // État du stock
   EtatStock est une Enumération
   	STOCK_VIDE 
   	STOCK_ALERTE
   	STOCK_OK
   FIN

   Ce code de déclaration contient :
   • La déclaration de la classe. Cette classe contient :
     • un membre public qui correspond au seuil d'alerte du stock. Ce membre est public car cette information est la même pour tous les produits.
     • trois membres privés, la référence du produit, son libellé et son stock.
   • La déclaration d'une énumération. Cette énumération permet de gérer l'état du stock. Pour que cette énumération puisse être manipulée par une des méthodes de la classe, il est nécessaire qu'elle soit déclarée dans le code de déclaration de la classe.
6. Enregistrez votre classe (Ctrl + S).

Création des propriétés

1. Dans le volet "Explorateur de projet" (affiché à gauche de l'environnement) :
   • Déroulez "Classes", puis déroulez "CProduit". Les différents éléments de la classe apparaissent dans le volet "Explorateur de projet".
   • Déroulez "Membres".
2. Positionnez-vous sur le membre "m_Référence".
3. Affichez le menu contextuel (clic droit) et sélectionnez "Générer la propriété". La fenêtre qui s'affiche permet de définir toutes les caractéristiques de la propriété :
   • Le nom de la propriété.
   • La visibilité de la propriété. Plusieurs options sont combinables. La propriété peut être :
     • Publique, protégée, restreinte, protégée restreinte ou privée.
     • Abstraite ou globale.
   • Le mode d'accès à la propriété (Lecture et/ou écriture).
   • Le rôle de la propriété : Non défini, Métier ou UI.
4. Saisissez le nom de la propriété "Référence" et validez.
5. Les propriétés permettant la lecture et l'écriture sont automatiquement créées avec le code WLangage correspondant.

Création des méthodes

• Une méthode permettant d'ajouter des produits au stock courant : AjouteStock.
• Une méthode permettant de connaître l'état du stock : EtatDuStock.

1. Dans le volet "Explorateur de projet", sélectionnez la classe CProduit.
2. Affichez le menu contextuel (clic droit) et sélectionnez "Nouvelle méthode". La fenêtre qui s'affiche permet de définir toutes les caractéristiques de la méthode. Saisissez le nom de la méthode "AjouteStock" et validez.
   
   

   La syntaxe des méthodes de classes est la même que celle des procédures.
3. L'éditeur de code affiche la méthode. Saisissez le code suivant :
   

   PROCÉDURE AjouteStock(LOCAL StockSupplémentaire est un entier) : booléen
   
   // Le stock fourni en paramètre doit être valide
   SI StockSupplémentaire < 0 ALORS
   	// Impossible d'ajouter un stock négatif
   	RENVOYER Faux
   FIN
   
   // Incrémente le stock actuel avec le stock supplémentaire
   m_Stock += StockSupplémentaire
   
   // L'ajout est effectif
   RENVOYER Vrai

   Examinons ce code WLangage :
   • La méthode AjouteStock attend en paramètre un entier et renvoie un booléen.
   • Un test sur la valeur du stock indiquée est réalisé. Si le stock est négatif, la méthode renvoie Faux : le stock de l'élément n'a pas été mis à jour.
   • Si la valeur du stock est positive, le stock de l'élément est incrémenté.

PROCÉDURE EtatDuStock() : EtatStock 

// Si le stock est vide
SI m_Stock = 0 ALORS
	RENVOYER STOCK_VIDE
FIN

// Si le stock est sous le seuil d'alerte
SI m_Stock <= mg_SeuilAlerteStock ALORS
	RENVOYER STOCK_ALERTE
FIN

// Le stock est OK
RENVOYER STOCK_OK

Déclarer et manipuler les objets

1. Dans la barre des éléments ouverts, faites un clic droit sur le bouton "P". Le menu contextuel s'affiche.
2. Sélectionnez l'option "Code de l'élément".
3. L'éditeur de code affiche les différents événements associés au projet.
4. Supprimez le code existant dans le code d'initialisation du projet et saisissez le code suivant :
   

   UnProduit est un CProduit
   
   UnProduit.Référence = "REF-123"
   UnProduit.Libellé = "Mon produit"

   
   Ce code permet de déclarer un objet et de l'instancier. Les propriétés sont renseignées via la syntaxe :
   
   <Nom de l'objet>.<Nom de la propriété> = Valeur
5. Ajoutons dans ce code les lignes suivantes :
   • Appel de la méthode AjouteStock :
     

     UnProduit.AjouteStock(500)

   • Lecture des propriétés :
     

     Trace(UnProduit.Référence + " " + UnProduit.Libellé + " " + UnProduit.Stock)

   • Utilisation de l'énumération :
     

     SI UnProduit.EtatDuStock() = CProduit.STOCK_OK ALORS
     	Trace("Le stock est correct")
     SINON
     	Trace("Le stock est insuffisant")
     FIN

6. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
7. Affichez si nécessaire le volet "Trace du débogueur" pour voir le résultat : sous le volet "Accueil", dans le groupe "Environnement", déroulez "Volets" et sélectionnez "Volets" puis "Trace du débogueur".
8. Le volet "Trace du débogueur" affiche les informations suivantes :
   
   REF-123 Mon produit 500
   Le stock est correct
   Nous retrouvons bien les informations concernant le produit et l'état du stock.

Utilisation du constructeur

mg_SeuilAlerteStock est un entier = 20

mg_SeuilAlerteStock est un entier

PROCÉDURE Constructeur(SeuilAlerteStock est un entier)
mg_SeuilAlerteStock = SeuilAlerteStock

1. Nous allons modifier :
   • le code d'instanciation de la classe. Remplacez la ligne de code suivante :
     

     UnProduit est un CProduit

     par :
     

     UnProduit est un CProduit(20)

     En effet, comme nous l'avons vu précédemment, la méthode Constructeur est appelée automatiquement lors de la déclaration (instanciation) de la classe. Le constructeur attend maintenant un paramètre : il faut donc rajouter le passage de la valeur du paramètre lors de l'instanciation. Dans cet exemple, la quantité limite est de 20.
   • le code d'appel de la méthode. Remplacez la ligne de code suivante :
     

     UnProduit.AjouteStock(500)

     par :
     

     UnProduit.AjouteStock(10)

     La quantité en stock est de 10.
2. Testons nos modifications (Cliquez sur l'icône "GO" parmi les icônes d'accès rapide).
3. Le volet "Trace du débogueur" affiche les informations suivantes :
   
   REF-123 Mon produit 10
   Le stock est insuffisant

• Concepts de la POO,
• Classes, membres, méthodes et propriétés,
• Héritage de classe.