< Précédent | Suivant >

Leçon 3 : Créer le service de calcul de prêt hypothécaire

Créez un service dédié au calcul des mensualités.

Au cours de cette leçon, vous allez créer un composant Service EGL, qui est un composant générable. Chaque composant générable doit être placé dans un fichier source distinct, et le nom du composant doit être doit être le même que celui du fichier.

Création d'un composant Service

  1. Dans la fenêtre Explorateur de projets, cliquez avec le bouton droit sur MortgageServiceProject, puis sur Nouveau > Service.
  2. Dans la fenêtre Nouvelle partie Service EGL, entrez les informations suivantes :
    1. Dans la zone Package, entrez le nom suivant :
      services
    2. Dans la zone Nom du fichier source EGL, entrez le nom suivant :
      MortgageCalculationService
      EGL ajoute l'extension .egl au fichier.
    3. Vérifiez que les options Créer en tant que service Web (SOAP) et Créer en tant que service Web (REST) sont désélectionnées, et laissez vide la zone Implémente les interfaces.
      La fenêtre Nouvelle partie Service EGL contient le nom de service et le package.
  3. Cliquez sur Terminer. EGL ouvre le nouveau composant Service dans l'éditeur.
  4. Supprimez le code du fichier, en conservant uniquement les lignes suivantes :
    package services;
    
    service MortgageCalculationService
    
    end
  5. Ajoutez la fonction suivante avant l'instruction end :
    	function amortize(inputData MortgageCalculationResult inOut)
    		amt MONEY = inputData.loanAmount;
    		// convertir en taux mensuel
    		rate DECIMAL(10, 8) = (1 + inputData.interestRate / 1200);
    		// convertir en mois
    		term INT = (inputData.term * 12);
    
    		// calcul du montant du paiement mensuel
    		pmt MONEY = (amt * (rate - 1) * Mathlib.pow(rate, term)) /
    				(MathLib.pow(rate, term) - 1);
    		totalInterest MONEY = (pmt * term) - amt;
    		
    		// mise à jour de l'enregistrement du résultat
    		inputData.monthlyPayment = pmt;
    		inputData.interest = totalInterest;
    	end
    Lorsque vous collez du code à partir de ces instructions, le formatage peut changer. Cliquez sur Ctrl+Maj+F pour reformater le code. Vous pouvez modifier les règles de formatage en cliquant sur Fenêtre > Préférences > EGL > Editeur > Formateur.
    Remarque :
    EGL signale les erreurs de code en affichant une croix (X) rouge dans la marge gauche et en soulignant l'erreur par une ligne ondulée rouge. Positionnez le curseur sur la croix pour voir le message d'erreur.
    Les erreurs sont signalées par des lignes de soulignement rouges et des croix rouges dans la marge.

    Comme le type MortgageCalculationResult n'est pas encore défini, EGL ne peut pas créer la variable inputData basée sur ce type. Lorsque vous allez créer ce type d'enregistrement au prochain exercice, EGL supprimera les marques d'erreur.

  6. Enregistrez le fichier en cliquant sur Fichier > Sauvegarder.

Création d'un composant Enregistrement

La fonction amortize() utilise un enregistrement MortgageCalculationResult. Vous pouvez définir cet enregistrement dans le même fichier que le service.

Pour créer le composant Enregistrement :

  1. Ajoutez le code suivant après la fonction amortize() dans le fichier MortgageCalculationService.egl. L'enregistrement étant un composant, vous le définissez en dehors du composant Service, c'est-à-dire après la dernière instruction end du fichier :
    record MortgageCalculationResult
    	// saisie de l'utilisateur
    	loanAmount MONEY;
    	interestRate DECIMAL(10,8);
    	term INT;
    
    	// zones calculées
    	monthlyPayment MONEY;
    	interest MONEY;
    end
  2. Sauvegardez le fichier. EGL ne devrait plus signaler d'erreurs dans le code. Si vous constatez des erreurs dans votre fichier source, comparez son code au code présenté à la rubrique Code finalisé du fichier MortgageCalculationService.egl après la leçon 3. Lorsque vous progressez dans le tutoriel, des croix rouges peuvent apparaître en regard du projet ou de l'un de ses dossiers, sans que le fichier lui-même en contienne. Si vous rencontrez cette situation, résolvez-la en cliquant sur Projet > Nettoyer. Dans la fenêtre Nettoyer, cliquez sur Nettoyer les projets sélectionnés ci-dessous, puis cliquez sur le projet concerné, par exemple MortgageServiceProject.
    MortgageServiceProject est sélectionné dans la liste.
    Cliquez sur OK. EGL régénère le projet sélectionné, et la croix rouge disparaît de la vue Explorateur de projets.
  3. Fermez le fichier en cliquant sur le X à côté du nom de fichier dans l'onglet en haut de l'éditeur, ou en cliquant sur Fichier > Fermer.

Récapitulatif de la leçon

Vous avez appris à effectuer les tâches suivantes :
  • Créer un composant Service EGL
  • Créer un composant Enregistrement EGL et l'ajouter au fichier source du Service.
  • Vérifier si le code contient des erreurs.

Dans la leçon suivante, vous allez créer l'interface utilisateur du premier portlet d'application.

< Précédent | Suivant >

Retour d'informations