C# 9 – Introduction

Les nouveautés du C# 9

Microsoft nous a récemment parlé du C# 9 durant la Build 2020, les experts INFEENY vont donc vous détailler et vous expliquer les nouveautés du C# 9.

Le Target typed

Ce que nous attendions depuis longtemps est enfin arrivé : le type ciblé (target typed). Il s’agit d’utiliser le mot-clé new() et seulement celui-ci pour instancier une class. Nous n’avons plus besoin de nous soucier du type à la création d’un objet à condition qu’il puisse être déduit par le compilateur.

Avant :


Classname objet =  new Classname(param1, param2) ;

Devient


Classname objet = new(param1, param2) ;

Comme nous pouvons le voir, dans la deuxième partie, le nom de la class avant le mot-clé new n’est plus utile.

Les propriétés Init-only

Avant C# 9 il fallait que des propriétés soit modifiables pour que l’initialisation de l’objet fonctionne. Cependant C# 9 introduit les accesseurs init qui permettent de set une valeur à une propriété qu’à l’instanciation de notre class.

Exemple :


public class Players
{
public int X { get; init; }
public int Y { get; init; }
}

Avec cette class l’utilisateur pourra donc modifier X et Y seulement pendant l’instanciation de la class sinon il renverra une erreur.

Le type record

Avant le C# 9, nous devions créer une class avec toutes propriétés déclarées dans celle-ci, ainsi que de surcharger (override) l’opérateur Equals et le GetHashCode. Enfin, créer un constructeur si besoin pour chaque propriété que l’on voulait set. Cela est de même pour le destructeur. Ce qui était fastidieux pour finalement peu d’utilité.

Aujourd’hui, C# 9 nous permet de faire cela en une simple ligne de code grâce au mot-clé data. Les propriétés crées seront en init-only. L’avantage du type record est donc sa simplicité. Cependant, sachez que vos propriétés seront immuables (const).

Avant :


class Players 
{
private int X {get;}
private int Y {get;}

public Players(int x, int y) 
{
this.X = x;
this.Y = y;
}
}

Devient


public data class Players(int X, int Y); // ici les propriétés sont en init-only,

si vous vouliez faire de l’héritage


public data class Mage : Players{int Mana} ; // cette class contiendra les propriétés X, Y, Mana

L’expression With

Si nous voulions modifier les valeurs des propriétés de notre class nous devrions donc créer une copie de cette classe en modifiant la valeur qui nous intéresse. C# 9 introduit donc une nouvelle expression : with. Cette expression clone l’objet d’origine, en remplaçant les valeurs des propriétés spécifiées entre les accolades. Pour cet exemple nous allons utiliser la class créer au-dessus avec data. Exemple :


Players player1 = new(1, 2) ;
Players player2 = player1 with {Y = 42};

La gestion des paramètre NULL

En plus du mot-clé with, C# 9 introduit une syntaxe simple pour vérifier automatiquement si des paramètres de fonction sont null. Cette syntaxe est représentée par un ‘ !’ après le nom du paramètre de votre fonction à vérifier. Si la variable a pour valeur null, il throw une exception du type ArgumentNullException.

Avant :


public string saysomethings(string somethings) 
{
if (somethings == null)

throw new ArgumentNullException(nameof(somethings));

return $"you say {somethings}";
}

Devient


public string saysomethings(string somethings!) => $"you say {somethings}";

L’égalité basé sur les valeurs

C# 9 a introduit une nouvelle fonctionnalité à l’opérateur Equals. Cette fonctionnalité permet donc de comparer deux objets selon les valeurs des propriétés et non pas l’objet en lui-même. Equals va donc comparer champs par champs et renvoyer true s’ils sont tous égaux.

La covariance du type de retour (modification)

Un nom bien compliqué qui vous simplifiera beaucoup la vie. Avant C# 9, en héritant d’une class, si nous voulions Override une méthode nous devions avoir le même type de retour que la méthode mère. C# 9 introduit le fait de pouvoir modifier ce type de retour. Exemple:


public class anyClass
{
public virtual anyClass Clone() => new anyClass();
}

public class SpecificAnyClass : anyClass
{
// Override with a more specific return type
public override SpecificAnyClass Clone() => new SpecificAnyClass();
}

Top level Programs ( Programmation au niveaux supérieur)

C#9 simplifie aussi l’écriture de code en permettant de le rédiger au niveau supérieur de votre fichier.

Avant :


using System;

class Program
{
static void Main()
{
Console.WriteLine("Hello World!");
}
}

Devient


using System; Console.WriteLine("Hello World!");

Pour finir, C# 9 ajoute aussi un dernier mot-clé : not. Il fonctionne de la même manière que « != ».

Exemple


if (player is not Mage) { … }

Pour conclure :

Nous avons balayé les principales fonctionnalités de C# 9

Le développement moderne Desktop Windows 10

Le modèle de développement selon Microsoft est très complexe car il est permissif. En effet, Microsoft n’impose rien, Microsoft propose des technologies au fur et à mesure des années et des nouveaux kits de développement. Mais comment décider ; que choisir pour développer une application ?

Si on suit la BUILD 2020, on parle de MAUI et de WinUI3. Soyons clair, ce n’est pas sérieux. Voici le détail de mon analyse.

Un rappel historique

Dans les années 90, 2000, le modèle était le suivant : Windows C Win32, C++ MFC ou Visual Basic, voir Delphi (Borland). Le modèle de ces années là est la domination du monde fenêtré. Soit SDI (Single Document Interface) soit MDI (Multi Document Interface). Le modèle MDI était populaire avec Word, Excel et consistait à avoir plusieurs fenêtres ouvertes dans la même application. Avec le modèle MDI, le paradigme était la programmation objet et le modèle des User Controls et de OLE2. OLE2 c’est les composants COM, les contrôles ActiveX, le pilotage OLE Automation et les Compound Documents ou documents composites qui consistent par exemple, à mettre un bout d’Excel (des graphiques) dans un document Word. Ce modèle OLE2 n’a jamais été égalé par se sophistication et sa beauté (oui c’est beau). Il faut reconnaitre qu’il y avait une certaine complexité avec toutes ces interfaces COM mais le résultat était magnifique. Les contrôles ActiveX ont eu un certain succès et l’avènement a été Visual Basic 6 avec ses multitudes de contrôles OCX.

L’arrivée de NET en 2001

En 2001, Microsoft présente NET avec Windows Forms. C’est un succès immédiat.

WPF en 2006 dans Vista

En 2006, Microsoft distribue WPF dans Windows Vista. Nom de code Avallon, de grandes ambitions ais l’OS Vista est une catastrophe et le projet est retardé et l’OS ne contiendra rien fait en NET. Tout sera implémenté en C++ cat WinDiv n’est pas content de NET (fiabilité, robustesse, vitesse). Il y a des incompréhensions entre DevDiv (qui produit NET) et WinDiv et le fossé est toujours présent en 2020 !

La mort de Windows Phone et Silverlight

Quand Microsoft sort le Windows Phone, avant 2010, seul le C# et WPF sont autorisés. XAML everywhere. L’adoption en terme d’apps est un fiasco. Le C++ est alors supporté mais le mal est fait. Le Store ne contient aucune apps ou si peu. De plus, WPF et Silverlight ne tiennent pas leurs promesses. C’est lourd, c’est lent, le modèle MVVM est indebuggable. La cata. La division WInDiv reprend les choses en main et coupe la branche. Silverlight est dead. Enfin en LTS mais il n’y auara plus d’évolutions. On sait ce que Microsoft veut dire dans ces cas-là. Quand les réponses ne sont aps données et que l’on en parle plus, on sait ce que cela veut dire.

Windows 8

En parallèle, en 20011, Windows 8 sort son modèle d’applications Metro. Les fans du NET pensent que NET est enfin dans Windows ! Manqué ! C’est des contrôles natifs fait en C++, les fameuses API WinRT faites… en COM. Microsoft ne parle plus de WPF et le modèle c’est WinRT, COM et XAML.

Pire, les applications Store et Accessoires sont faites en JS avec WinJS. Courrier est le parfait exemple. Pour le camp WPF, c’est une trahison. JS est mis en avant à la place de C# et NET et surtout WPF. Le Manager de WPF démissionne après avoir vidé son sac sur reddit et enflammé la toile. Microsoft ne bouge pas et confirme que le retour est au Win32 et à COM et surtout que les erreurs Windows Phone se seront plus commises ! Dans le monde Windows, on ne renie pas la famille Win32 sans impunité. Win32, c’est GDI32, USER32 et KERNEL32, c’est l’héritage de Dave Cutler, le père de Windows NT, Dieu. Les Boss de Windows ont sifflé la fin de la récréation. Les ISV ont indiqué que WPF ne permet pas de faire des applications Desktop comme ils le désirent. Le problème, c’est que de nombreux développeurs ont rejoint le rang de la communauté NET pour faire du XAML et du WPF. Il y a un certain désarroi dans la communauté WPF. Ils se sentent trahi par Microsoft. Il faut dire que Microsoft joue sur les deux tableaux en prônant la modernité et nous ressort du COM et des extensions à IUnknown… Moi à ça me plait car c’est mon monde et je sais que chaque classes C# est un composant COM mais le commun des développeurs NET ne le sait pas.

Windows 10

Depuis WinRT, Microsoft a sorti un framework pour ocntinuer l’avenir OLE2. Oui Monsieur ! WinRT arrive avec un framework nommé WRL (Windows Runtime Language) et surtout C++/CX, un C++ qui supporte WinRT et le XAML. Ce sont des templates C++ qui prennent la suite de ATL/COM. ATL est une suite de templates C++ pour faire du COM et de OLE2. C’est très efficace et toujours utilisé.

NET Core

Microsoft fusionne NET Framework et NET Core 3.1 pur faire NET 5. Il va y avoir un nouveau designer pour WinForms et WPF.

MAUI

La fusion de Xamarin.Forms, Mono avec GTK+ va fournir un environnement multi-plateforme qui va séduire de nombreux nouveaux venus dans le monde Microsoft. A suivre…

WinUI

En 2019, Microsoft annonce un projet open-source XAML Island permettant l’inclusion des contrôles Windows 10 dans les application NET et Win32. Rapidement renommé WinUI, se projet open-source prend de l’importance chez Microsoft et c’est propulsé comme l’avenir de l’UI selon Microsoft à la BUILD 2020. L’application de référence est XAML Control Gallery et présente les contrôles simples et la panoplie de contrôles XAML disponibles dans Microsoft.UI.Xaml.Controls.dll. Ces contrôles natifs sont livrés avec leur code source et disponible sous forme de package Nuget pour C# mais aussi utilisable en WinRT avec CPP/WinRT de Kenny Kerr.

La Question à 1 million de dollars : Que choisir ?

Là c’est ouvert. Les développeurs s’accrochent aux branches. NET Core leur ouvre un second souffle. Mais le grand gagnant est le retour de WinForms pour NET Core. Pourquoi ? Parce que c’est simple, orienté objet et évènementiel et surtout utilisable par tous. IL n’y a pas de modèle foireux comme MVVM. Les évènements arrivent dans des routines et on gère tout dedans. Même en faisant de la délégation à une classe centrale, tout est débuggable. Bref, ce n’est pas WPF et MVVM. Quand une technologie n’est pas simple, elle n’est pas adoptée.

XAML

Je suis très sceptique sur XAML. C’est le cœur de WPF et la mayonnaise n’a jamais prise. Déjà, le XAML est illisible. Le modèle MVVM est complexe est non standardisé. Tout le monde fait le sait. C’est foireux ! WinUI se veut l’avenir mais c’est du XAML. Alors je dis oui mais à une condition. Pas de modèle MVVM. Pas de commandes, pas de routing, pas de messages, pas de binding. On fait du XAML évènementiel comme ne WinForms. Les samples Microsoft me donnent raison, il n’y a pas de MVVM.

Win32 et C/C++ (for ever)

Le cœur de Windows est fait en C et en C++. Le modèle Windows repose toujours (et encore plus maintenant) sur le C++ Moderne (C++17) et la base de code installée en C/C++ est tellement importante que Microsoft ne fera pas la révolution. WinUI passera par l’introduction simple de contrôles XAML dans les applications existantes. Cela fera partie de Windows et du Windows SDK comme CPP/WinRT. Il n’y a que les néophytes qui pensent que Microsoft fera la révolution en NET et en C#. Microsoft fait 95% de ses logiciels en C++. La performance est primordiale. D’ailleurs, le projet Réunion à pour but de délivrer du C++ pour tous les langages via des projections (principes de CPP/WinRT) via les nouvelles API faites en WinRT. Les packages VCLibs et Microsoft.XAML sont la preuve de ce mouvement.  Autre application faites en WinUI, le Windows Terminal. Il incorpore cmd, powershell et bash. Il y a un support WinUI pour les Settings et les onglets (Tabs).

La stratégie floue de Microsoft

Microsoft produit des technologies et des produits. D’un côté, il y a Azure et de l’autre Windows, Office et les produits serveurs. Microsoft veut de nouveaux développeurs sur sa plateforme donc il y a aussi du TS, du Rust/WinRT et du React Native. Microsoft est une grosse machine et il est parfois nécessaire d’avoir le point de vue des vieux gurus pour s’en sortir. Chez Microsoft, il y a des technologies pour les POC et des technologies pour faire des vrais logiciels qui durent mais aussi du jetable.

Conclusion

Ce n’est pas parce que ça existe qu’il faut l’utiliser

Confucius.

Project Réunion

Qu’est ce que Le Projet Réunion nous apporte ?

Projet Réunion nous apporte trois nouvelles fonctionnalités dans lesquelles vos applications pourront piocher:

  1. De nouvelles API
  2. Un sous-ensembles D’API
  3. Des API convergentes

Les nouvelles API (new) : 

De nouvelles fonctionnalités Windows seront fournies dans le projet Réunion, celles-ci seront transparentes dans leurs identités, leurs packagings et leurs isolations. De plus elles partageront une interface commune ce qui vous permettra de l’utiliser peu importe le type de votre application (MSIX, MSI, Setup.exe, Desktop Bridge, AppContainer).

New APIs

Ces API sont autonomes et ont pour but de répondre à des problèmes spécifiques que vos applications peuvent rencontrer, elles vous aideront aussi à mettre en place des fonctionnalités supplémentaires.

Voici une liste potentielle des différents types d’API qui ne seront pas forcément pressent le premier jour :

  • Stockage et gestion des données dans un seul endroit pour garder en ordre le système de l’utilisateur
  • Cloud app support pour la gestion de l’identité ainsi que de la connectivité afin d’utiliser Azure
  • Packaging et système intégration pour que Windows comprenne ce que fait votre application
  • Aide de communication entre différentes applications (app-To-app) pour que vos applications fonctionnent ensemble.
  •  API d’accès aux ressources pour les caméras, les microphones et la localisation qui respectent la vie privée.

Comment utiliser ces nouvelles API ?

Pour utiliser ces API il vous suffit d’ajouter dans un premier temps le package NuGet « Project Reunion » et dans un second temps d’en faire appelle dans votre code. Les API seront disponibles dans toutes les versions de Windows ainsi que pour toutes les applications. Si certaines API se comportent autrement (du a son identité, d’un isolement particulier ou d’un cycle de vie différents) vos applications sont en mesures de le détecter grâce aux contrôles du type « TheType.IsSupported ».

Les API convergentes (converged):

Projet Réunion propose des Api de surface qui permettent de faire la liaisons entre Win32 et les fonctionnalités UWP/AppContainer déjà présentes dans la plate-forme. Les auteurs de comme partagé (Frameworks ou autre) peuvent avoir recours a une seule méthode afin d’éviter leurs propres verifications  » if (AppContainer) { x } else { y } ». Projet Reunion fournit des implémentations « polyfill » des API lorsque c’est nécessaire pour que votre application puisse fonctionner sur d’autres versions de Windows sans vérification supplémentaires.

Converged APIs

Voici quelque exemple d’API convergentes :

  • Window Content Frame abstraction entre WIn32 et UWP
  • Application lifecycle behaviors pour le démarrage, la déconnexion , ‘intégration du gestionnaire de redémarrage, le redémarrage pour la mise à jour
  • Assistance au démarrage et aux tâches de fond pour réduire la puissance et les performances de votre
  • Gestion des ressources d’application pour les chaîne de caractères(strings), les images, les résolution d’affichages et localisation

Une fois que vous avez ajouté les références a Projet Réunion l’application pourras commencer à migrer des blocs de fonctionnalités vers L’utilisation de ces API convergentes  entièrement prises en charge. Vous pouvez donc migrer autant de fonctionnalités que nécessaire, en conservant le style ainsi que le comportement de votre application. Ces API seront similaires a celles du SDK ce qui facilitera la transition. En ce qui concerne les API Win32 « Flat C » existantes, une API convergente sera ajoutée puis envoyer dans votre langage et votre runtime.

Lorsque les applications aurons migré pour Projet Réunion il sera plus facile d’alterner entre déploiement et isolation. En effet Projet Réunion gère l’accès au ressources à partir d’un processus avec un faible niveau d’intégrité (LOWIL) ou AppContainer pour que votre application puisse référencer les ressources tout en respectant le choix de l’utilisateur ainsi que les contrôles de confidentialité.

Converged APIs

Les sous-ensembles d’API (Subset Family):

Les sous-ensembles API vous permettent de commencer a utiliser les fonctionnalités de Project Reunion avec des changements minimaux de votre code déja existant. Cela fonctionne en utilisant un ensemble d’en-têtes et de mises en œuvre mis à jour et rationalisés.

Le Projet Réunion aide a rester dans l’ensemble des API que des Windows peu prendre en charge dans toutes les editions and les points de terminaison (endpoints).

Projet Reunion définit un sous-ensemble d’API prises en charge dans toutes les versions Windows. Si votre code cible ce sous-ensemble et utilise les Project reunion new API avec les Project Converged API il fonctionnera partout où Windows fonctionne sans ajout supplémentaire.

Les fonctionnalités prises en charge par le sous-ensemble de Project Reunion comprennent des sous-ensembles de :

  • Windowing, Input, Messaging, GDI, and GUI subsystem functionality
  • Filesystem and storage access
  • Networking
  • Printing
  • Process, threading, memory management, basic application services
  • DirectX, D3D, DirectML

Comment migrer vers l’ensemble d’API de Projet Reunion Subset ?

Pour migrer votre application il vous suffit de supprimer toute les références aux headers de Windows Kit (windows.h, kernel32.lib, user32.lib, winsock.h, etc) puis ajouter les références au header principal de Projet Reunion Subsete et aux lib d’importation.

Point important, malgres que de nombreuses API font parties du Kit WIndows ainsi que du sous-ensemble de Projet Réunion, il se peut que vous ayer quelques changements a effectuer dans votre code ou dans le comportement de votre application.

Composantes du Projet Réunion (Project Reunion Family Components) ?

Ce qui est disponible dès maintenant

Ces composants sont à votre disposition dès maintenant et respectent la « promesse de la famille du projet Réunion », à savoir qu’ils disposent d’une API unique pour toutes sortes d’applications.

  • WinUI 3 pour XAML vous aide à créer des UX fluides pour toutes sortes d’applications grâce à la puissance de XAML. Ce composant {lien vers repo} fait partie de la famille de fonctionnalités de Project Reunion, s’appuyant sur l’identité + le packaging + les idées transparentes de déploiement que Project Reunion prend également en charge pour votre application.
  • C++/WinRT, RUST/WinRT et C#/WinRT fournissent des projections en langage natif de Windows, de Project Reunion et de vos propres types personnalisés définis dans les métadonnées. Consommez les API du kit Windows, produisez-les pour les utiliser avec d’autres projections prises en charge et créez vos propres nouvelles projections de langage.
  • MSIX-Core vous permet de conditionner votre application pour la distribuer sur les machines Windows Desktop via le magasin ou votre propre pipeline de livraison. MSIX-Core vous permet d’utiliser les parties réutilisées de l’histoire du packaging MSIX sur les anciennes versions de Windows.

Ce qui est bientôt disponible

Bien que nous pensions qu’elles soient intéressantes pour les candidatures, c’est à vous de nous le dire ! Le travail au grand jour consiste en partie à apprendre ensemble les besoins des développeurs d’applications. Vous trouverez ci-dessous un ensemble de fonctionnalités qu’il semble intéressant de mettre à disposition dans le cadre d’un modèle convergent ou nouveau, mais c’est à vous de nous le dire ! Certaines sont liées à un fil de discussion proposant la fonctionnalité. +1 celles que vous aimez, commentez la conception détaillée et la direction, et aidez-nous à déterminer où nous allons.

  • WebView2, qui s’appuie sur Edge/Chromium, vous permet de créer facilement votre application en HTML+JS une fois et de la réutiliser sur toutes les plateformes. L’utilisation par WebView2 de technologies du Projet Réunion comme WinUI3 comme cadre d’hébergement vous permet d’exécuter un UX moderne basé sur le web sur toutes les éditions de Windows.
  • Modern Lifecycle helpers permettent à votre application d’être sensible à la consommation d’énergie et de réagir aux changements dans la gestion de l’énergie du système d’exécution et dans l’état de l’utilisateur. Elles aident également votre application à redémarrer après le redémarrage de l’utilisateur, enregistrent votre application pour qu’elle puisse être redémarrée et réduisent les redémarrages liés aux mises à jour.
  • Startup tasks donnent vie à votre application lorsque l’utilisateur se connecte pour se reconnecter, commencer à travailler sans surutiliser les ressources ou être prêt à une utilisation rapide. Les fonctions de choix de l’utilisateur et de gestion de l’énergie vous permettent de réduire votre impact sur le chemin critique de la connexion.
  • Update Scan Integration permet de maintenir votre application à jour automatiquement pendant son exécution, en même temps que d’autres tâches de maintenance du système.
  • Accès aux ressources utilisateur même à partir d’AppContainer et d’applications isolées. Vos applications AppContainer peuvent accéder à de puissantes technologies Win32 comme le presse-papiers, la communication entre processus et l’espace de nommage Windows Shell avec le consentement de l’utilisateur par le biais d’un courtage.
  • Modern Resource Tooling pour que vous puissiez utiliser la puissance de ResX/ResW dans vos applications Win32 au lieu de MUI.

Orientation future

Nous avons pour objectif de développer le Projet Réunion afin de fournir une version moderne, simple et accessible d’une grande partie de la puissance de la plate-forme d’application Windows. Le fait de travailler au grand jour avec notre communauté de développement garantit que nous faisons d’abord les bonnes choses pour résoudre les problèmes auxquels vos applications sont confrontées sur les versions actuelles et futures de Windows.

Certaines fonctionnalités seront d’abord livrées en tant que composants du projet Reunion. Lorsque nous pensons à faire évoluer la plate-forme, il est important de s’assurer que les nouvelles fonctionnalités et caractéristiques sont disponibles pour notre communauté de développeurs dès qu’elles sont prêtes à être utilisées. Les nouvelles fonctionnalités de la plate-forme vous aideront à les adopter dès qu’elles seront disponibles, sans que vous ayez à les cibler ou à les réécrire.

À mesure que votre application utilisera davantage de fonctionnalités de Project Reunion, elle sera prête pour des cibles supplémentaires telles que le packaging, l’identité, l’AppContainer et d’autres futures éditions Windows. Dépendre des API de Project Reunion signifie que nous prenons en charge le travail pour que ces API continuent à fonctionner au fur et à mesure de l’évolution de Windows. En restant dans la surface de l’API du Projet Réunion, vous vous assurez que votre application peut répondre à la plus large gamme d’éditions et de versions de Windows tout en utilisant des fonctionnalités à jour.

Comment nous procédons

Travailler au grand jour

Le Projet Réunion s’appuie sur la puissance de l’open-source et les fonctionnalités de GitHub pour vous livrer du code aussi vite que nous pouvons l’imaginer. Vous devez vous sentir libre de bifurquer, de créer des demandes de retrait, d’ouvrir des problèmes, de proposer des résolutions aux problèmes. Vous pouvez voir et influencer toutes nos fonctionnalités via le « issue tracker ». Vous devez vous attendre à ce que nous vous écoutions et que nous vous fournissions un retour d’information constructif.

Constructions et artifacts

Le code dans le cadre du projet Réunion GitHub repo s’appuie sur une boucle CI/CD et produit des DLL et des métadonnées fraîchement construites sur chaque demande de retrait. Le résultat comprend un paquet NuGet contenant les métadonnées pour le projet Reunion et un MSIX prêt à être livré pour être inclus dans votre demande comme redistribuable ou comme référence de paquet. Ajoutez une référence au paquet de Project Reunion et commencez à construire. Pour vous aider à déployer vos applications, nous inclurons un MSIX Framework Package ainsi que des instructions sur la façon de déployer ce MSIX à partir de votre installateur existant.

Versionnement
Le projet Reunion utilisera des définitions d’API basées sur des métadonnées fortement typées sur lesquelles vos applications peuvent prendre une dépendance à long terme suivant le cycle de vie de notre support publié. Nous utiliserons SemVer 2 pour identifier clairement les niveaux de forme des API qui permettent à ces API d’évoluer vers de nouvelles fonctionnalités sans compromettre les applications existantes. Project Reunion aide à maintenir les applications à jour grâce à des Framework Packages qui sont mis à jour avec des changements non cassants le cas échéant.

Extension des API
Une partie de ce que le Projet Réunion fournit est l’accès à des fonctionnalités qui se trouvent dans Windows, mais pour lesquelles il n’y a pas d’API publique. Nous travaillons sur les détails, mais notre plan est de fournir un paquet secondaire de code qui fournit une API publique sur ces composants précédemment non exposés. Ces composants seront mis en œuvre en tant que source fermée, mais ils seront accompagnés d’une surface d’API basée sur les métadonnées, pouvant être appelée et prise en charge par le public, et seront inclus dans les paquets du cadre du projet Reunion pour être utilisés par les applications.

Courtage
Les processus UWP (AppContainer, Low-IL) sont destinés à protéger à la fois l’utilisateur et l’application elle-même contre d’autres applications. L’accès aux ressources de l’utilisateur et du système est limité à l’ensemble des courtiers pris en charge pour ces ressources. Le projet Reunion comprend également un paquet principal qui fonctionne au niveau d’intégrité de l’utilisateur (moyen-IL, parfois appelé « full trust ») et peut fournir un accès approuvé par l’utilisateur à des ressources auparavant non disponibles pour les processus AppContainer et Low-IL.
Ce modèle est aujourd’hui disponible pour les applications AppContainer en tant que « composant de confiance totale » – le projet Reunion vise à fournir un modèle et une plate-forme communs pour ces composants personnalisés.

Ce que le Project Reunion n’est pas

Le Projet Réunion n’est pas un nouveau modèle d’application ou une nouvelle plate-forme de Windows. Il n’y aura pas de « nouvelle application Project Reunion » pour Visual Studio, VSCode ou d’autres environnements de développement.
Vous aurez toujours un accès complet au SDK Windows et aux kits associés. Au fil du temps, les fonctionnalités offertes par Project Reunion iront au-delà de la simple fusion des modèles Win32 et UWP existants et fourniront des fonctionnalités supplémentaires à toutes les applications à utiliser.

Project Reunion n’est pas un nouveau modèle d’empaquetage ou d’isolation des applications. Il n’est pas nécessaire de modifier votre application pour accéder à la fonctionnalité de Project Reunion, si ce n’est en utilisant la nouvelle fonctionnalité elle-même. Si les API que vous utilisez ont besoin d’une identité ou d’un packaging, ces exigences seront indiquées.

Le Projet Réunion n’est pas un nouveau modèle de sécurité ou de confidentialité pour les applications. Les histoires de sécurité, de confidentialité, de fiabilité et d’identité de votre application continuent de fonctionner avec Project Reunion. Il y a peut-être des endroits où le Projet Réunion aide votre application à être plus consciente des préoccupations des clients en matière de sécurité ou de confidentialité. Le Projet Réunion vous aide à utiliser des fonctionnalités modernes de sécurité et de confidentialité qui évoluent en fonction des besoins de votre application.

Le Projet Réunion n’est pas un moyen d’exécuter votre application dans le cloud. L’utilisation de la technologie de Project Reunion vous permettra d’intégrer votre application dans des familles d’API modernes qui sont prêtes pour le cloud. Des composants clés comme le cycle de vie moderne et l’isolation des états permettent de préparer votre application à fonctionner où que soient vos clients.

Project Réunion – Overview

Qu’est-ce que Le Projet Réunion ?
Project Reunion est la vision Microsoft pour unifier et faire évoluer la plate-forme de développeur Windows pour faciliter la génération d’applications formidables qui fonctionnent sur toutes les versions et appareils Windows 10 que les gens utilisent.

Project Reunion facilite la construction d’une grande application Windows en fournissant une plate-forme unifiée pour les applications Win32 et les applications UWP nouvelles et existantes. Il unifiera l’accès aux API Win32 et UWP existantes et les rendra disponibles découplés à partir du système d’exploitation, via des outils comme NuGet.

Project Reunion vous aidera à mettre à jour et à moderniser vos applications existantes avec les dernières fonctionnalités, qu’elles soient C++, .NET (y compris WPF, Windows Forms et UWP) ou React Native. Au fur et à mesure que Microsoft découple les API existantes et ajoute de nouvelles API, un travail pour polyfiller est réalisé, au besoin, de sorte que les API fonctionnent à un niveau bas entre les versions prises en charge de Windows.

Comment utiliser ?
WinUI 3 Preview 1 est l’un des premiers composants du voyage Project Reunion : c’est le cadre d’interface utilisateur natif moderne pour Windows, maintenant disponible pour tous les développeurs d’applications Windows dans les applications UWP et Bureau. À l’aide de WinUI, vous pourrez créer de nouvelles applications avec interface utilisateur moderne qui s’adapte et scalent à tous les appareils, ou moderniserez progressivement l’interface utilisateur des applications de bureau existantes, y compris C++, WPF et WinForms.

 

WinUI 3 – L’avenir du développement UI pour les devices Windows 10

La conférence BUILD nous annonce WinUI 3 : c’est l’avenir du développement UI sous les devices Windows 10.

Depuis l’apparition de Windows 10, de nouveaux contrôles graphiques sont apparus au sein du système d’exploitation. Les applications Accessoires comme la calculatrice, courrier, paint 3D ou le panneau de configuration ont un nouveau look, plus épuré, plus « Fluent ».

Les nouveaux contrôles graphiques sont implémentés en C++ et mis à disposition dans System32 via la librairie dynamique Microsoft.UI.Xaml.dll. Vous allez me dire Xaml ? Mais je connais, c’est WPF ? Et bien oui mais non… La Division qui fait Windows n’est pas très fan de WPF et de NET en général donc il n’y en a pas dans Windows. Par contre, il existe une implémentation Xaml en C++ ! Et la syntaxe/technologie Xaml est commune entre Windows et WPF.

Avec WinUI, il est possible de mettre des contrôles XAML Windows 10 et ce même pour les premières versions de Windows 10 dans des applications Win32, WinForms ou WPF.

Introduction au monde Fluent

Voici le look Fluent Design. Cela vous rappelle le panneau de configuration Windows 10 ?

C’est du XAML. L’écran est entièrement configuré en XML de type XAML.

Introduction aux contrôles natif C++

Le module se nomme Microsoft.UI.Xaml.dll et il contient tous les contrôles Xaml Windows 10. Il utilise les API WinRT du mode UWP.

Rappel des repo github utiles:

La Direction Technique et les Experts Infeeny vous préparent une série de contenus sur WinUI. A suivre.

 

 

VM Insights : Surveiller les performances et dépendances des VMs Azure

Surveiller ses environnements Azure est très important. Pour cela nous connaissons bien la solution Azure Monitor qui nous permet justement de surveiller et analyser nos environnements Azure. Azurer Monitor nous permet également d’être alerté si un incident survient sur notre plateforme.

              L’une des nouvelles fonctionnalités d’Azure Monitor est VM Insights. Elle nous permet de visualiser les performances et les dépendances de nos machines virtuelles. VM Insights se base sur les logs de VMS récupérés par les collecteurs de données Log Analytics.

              Voici les points qui seront traités :

  • Comment activer VM Insights : depuis le Portail et en PowerShell
  • Comment embarquer les VMs dans la solution : depuis le Portail et en PowerShell
  • Gérer les alertes en PowerShell

A l’issue de cet article vous saurez comment activer la solution et y embarquer les VMs automatiquement avec un script PowerShell complet et expliqué.

Activation de VM insights :

Il existe différentes méthodes pour activer VM Insights parmi lesquelles :

Directement sur le portail Azure

  • En ajoutant la solution au niveau d’un Log Analytics Workspace
    • En activant la solution depuis la machine virtuelle : dans le volet Monitoring de la VM > Insights > Enable / Activer.

L’activation de VM Insights directement depuis la VM, permet, en même temps d’activer la fonctionnalité VM Insights et d’embarquer la VM dans la solution. Une fois la fonctionnalité activée nous avons une visualisation des dépendances et performances de notre machine virtuelle comme représenté sur les Dashboards ci-dessous :

Visualisation des performances : Indicateur sur l’utilisation de la CPU, sur les espaces disques, les IOPS ou encore l’utilisation de la mémoire.

Visualisation des dépendances : nous permet notamment de voir avec quels environnements échange la VM et sur quels ports ou encore quels processus sont lancés sur la VM.

En ligne de commande

              Comme expliqué précédemment, la fonctionnalité VM Insights se base sur un Log Analytics Workspace. Nous devons donc commencer par en créer un ou récupérer les informations du Workspace déjà existant que l’on souhaite utiliser, ce sera le cas dans mon exemple. Voici le code permettant de récupérer les propriétés d’un Workspace existant puis d’ensuite activer la solution VM Insights :

# Get Log Analytics Workspace properties
$law = Get-AzOperationalInsightsWorkspace -ResourceGroupName $rgName 

#Set in a variable VM Insights solution Name
$SolutionName = "VMInsights"
 
#Enable VMInsights Solution on the Log Analytics Workspace
Set-AzOperationalInsightsIntelligencePack -ResourceGroupName $rgName -WorkspaceName $law.Name -IntelligencePackName $SolutionName -Enabled $true 

Comment embarquer les VMs dans la solution

              Pour embarquer des VMs dans la solution nous pouvons le faire comme expliqué précédemment directement depuis la VM ou bien via PowerShell. Il est important de comprendre comment le lien se fait entre les VMs et la solution VM Insights. Lors de l’activation de la solution pour une VM, 2 agents sont poussés dans la VM. Les agents sont les suivants :

  • Pour les VMs WINDOWS : Microsoft Monitoring Agent et Dependency Agent Windows
  • Pour les VMs Linux : Oms Agent For Linux et Dependency Agent Linux

              Si l’on souhaite déployer VM Insights sur un ensemble de VMs, nous n’allons pas passer par une activation de la solution à la main VM par VM depuis le portail. C’est tout l’intérêt du script PowerShell qui suit :

              Nous commençons par récupérer une liste de VMs pour lesquelles nous souhaitons analyser les performances et dépendances. Ici nous récupérons toutes les VMs d’un groupe de ressources :

# List all VMs in the resource group 
$azVMs = Get-AzVM -ResourceGroupName $rgName

              Ensuite, nous automatisons le déploiement des 2 Agents sur chaque VM de notre groupe de ressource en fonction de l’OS de la machine. Deux paramètres sont importants pour pousser l’installation des agents : l’ID du Workspace et la clé d’accès à ce dernier. Ce qui donne le code suivant :

$PublicSettings = @{"workspaceId" = $law.CustomerId}
$ProtectedSettings = @{"workspaceKey" = $lawKey}

# Push Agents Install on VMS to enable VM Insights
foreach ($vm in $azVMs) {
    # get VM's Os type

    $OsType = $vm.StorageProfile.OsDisk.OsType

    # Filter installation extension name by the Os type of the VM
    if($OsType -eq "Windows"){

        Set-AzVMExtension -ExtensionName "MMAExtension" `
            -ResourceGroupName $rgName `
            -VMName $vm.Name `
            -Publisher "Microsoft.EnterpriseCloud.Monitoring" `
            -ExtensionType "MicrosoftMonitoringAgent" `
            -TypeHandlerVersion 1.0 `
            -Settings $PublicSettings `
            -ProtectedSettings $ProtectedSettings `
            -Location $location

        Set-AzVMExtension -ExtensionName "DependencyAgentWindows" `
            -ResourceGroupName $rgName `
            -VMName $vm.Name `
            -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
            -ExtensionType "DependencyAgentWindows" `
            -TypeHandlerVersion 9.1 `
            -Settings $PublicSettings `
            -ProtectedSettings $ProtectedSettings `
            -Location $location

    }

    if($OsType -eq "Linux"){

        Set-AzVMExtension -ExtensionName "OMSExtension" `
            -ResourceGroupName $rgName `
            -VMName $vm.Name `
            -Publisher "Microsoft.EnterpriseCloud.Monitoring" `
            -ExtensionType "OmsAgentForLinux" `
            -TypeHandlerVersion 1.0 `
            -Settings $PublicSettings `
            -ProtectedSettings $ProtectedSettings `
            -Location $location

        Set-AzVMExtension -ExtensionName "DependencyAgentLinux" `
            -ResourceGroupName $rgName `
            -VMName $vm.Name `
            -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
            -ExtensionType "DependencyAgentLinux" `
            -TypeHandlerVersion 9.1 `
            -Settings $PublicSettings `
            -ProtectedSettings $ProtectedSettings `
            -Location $location

    }

    else{

        Write-Host "OS Type :" -ForegroundColor Red -NoNewline
        Write-Host $OsType -ForegroundColor White -NoNewline
        Write-Host "  not supported " -ForegroundColor Red -NoNewline
    }

} 

Création d’alertes

              Pour optimiser la surveillance de la plateforme et pouvoir suivre au mieux les performances de nos VMs, nous pouvons créer des règles d’alerte dans Azur Monitor en se basant sur les insights des VMs. Ici nous allons créer une alerte nous permettant d’être notifié par mail dès lors que l’utilisation de la CPU d’une VM dépasse 80%.

Créer un groupe d’action

              Pour commencer nous devons créer un groupe d’action dans lequel nous allons indiquer quelle action devra être effectuée lors du déclenchement de l’alerte, dans notre exemple un envoie de mail.


# Add new email where alerts should be send
$email = New-AzActionGroupReceiver -Name "alerts-mail" -EmailReceiver -EmailAddress "perfAlert@infeeny.com"

# Add Action group
$act = Set-AzActionGroup -Name "performance alerts" -ResourceGroup $rgName -ShortName "perfalerts" -Receiver $email

#$act = Get-AzActionGroup -ResourceGroupName $rgSocleName -Name "plateform alerts Action Group"
$action = New-AzActionGroup -ActionGroupId $act.id

Ajouter une règle d’alerte

      Maintenant nous créons le critère de l’alerte avec la métrique que nous souhaitons surveiller. Puis on crée l’alerte à laquelle nous allons associer ce critère et le groupe d’action créé juste avant.


### Add metric Rule for CPU ###

#set alert criteria for CPU utilization 
$criteriacpu = New-AzMetricAlertRuleV2Criteria -MetricName "Percentage CPU" `
-TimeAggregation average `
-Operator GreaterThanOrEqual `
-Threshold 80 

#Add alert rule     
Add-AzMetricAlertRuleV2 -Name "Windows and Linux CPU Alerts" `
    -ResourceGroupName $rgName `
    -WindowSize 00:05:00 `
    -Frequency 00:01:00 `
    -TargetResourceScope $rg.ResourceId `
    -Condition $criteriacpu `
    -TargetResourceType microsoft.compute/virtualmachines `
    -TargetResourceRegion $location `
    -ActionGroup $action `
    -Severity 3 

Conclusion

              Pour conclure, grâce à la nouvelle fonctionnalité VM Insights d’Azure Monitor, nous avons un suivi et une vision complète des performances de nos VMs. Cette fonctionnalité nous apporte des Dashboards complets que nous pouvons customiser afin d’afficher les métriques qui nous sont le plus cohérentes.
              Dans cet article, vous avez toutes les informations nécessaires pour déployer la fonctionnalité VM Insights sur vos VMs Azure et générer des alertes vous permettant ainsi de réagir au plus vite en cas d’incident ou de surcharge. Ici nous avons choisi PowerShell mais il est tout à fait possible de déployer la solution via Terraform ou Azure ARM si vous faites de l’InfrasAsCode.

Voici le lien Github vers le script complet :

https://github.com/infeeny/VMInsights/blob/master/VMInsights.ps1

L&L Kubernetes et AKS

Retrouvez notre Expert Christophe, dans une vidéo sur Kubernetes et AKS. La vidéo est Level 100, accessible à tous. URL sur Youtube: ici

Contenu: Il s’agit de prendre un projet Web API sous Visual Studio 2019 avec support Docker (container Linux) et de construire l’image Docker en local. Ensuite on pousse cette image dans une registry ACR afin de faire un déploiement dans un cluster AKS. Ensuite, on aborde kubectl, l’outil console de Kubernetes.

Pour réaliser toutes les opérations techniques, un HOWTO est à télécharger sur https://infeeny.com/net-core-sous-aks/

Développement Web ASP .NET Core

Bonjour, dans cet article, nous allons vous présenter la solution eShopWeb, voici comment va se décomposer l’article :

    • Architecture monolithique
    • Design Pattern MVC
    • Entity Framework Core
    •  eShopWeb
      • Introduction
      • Explication de la fonctionnalité Add to Basket
      • Explication de la fonctionnalité Checkout

Architecture monolithique

Le terme monolithique est plutôt utilisé lorsque l’on parle de conception d’application (ou architecture) et représente le modèle dit « traditionnel » d’une application. On peut considérer ce genre d’architecture comme un bloc unifié (contrairement aux micro-services).

Néanmoins, on peut mettre différentes couches de données (par exemple du MVC, mais nous reviendrons sur l’explication de se terme plus loin dans cet article). Ce qui signifie que les différents composants sont intrinsèquement connectés les uns aux autres et sont la plupart du temps dépendant de chacune des couches existantes.

L’inconvénient principal est lors de la mise à jour d’un élément, il faut alors réécrire une bonne partie de l’application (si ce n’est son entièreté). Par opposition, l’architecture monolithique permet un meilleur rendement que l’architecture micro-services. Mais surtout l’aspect monolithique permet de facilité les tests et le débogage car il y a moins d’éléments à prendre en compte.

Patron de conception : Modèle – Vue – Contrôleur (MVC)

Ce qu’on appelle en français un patron de conception est appelé en anglais design pattern. Et celui du MVC permet de séparer la logique du code :

  • Modèle : Un modèle permet de gérer les données du site. Il va donc chercher les informations dans la base de données, les organiser et les assembler pour ensuite être traité par le Contrôleur.
  • Vue : Une vue va comme son nom l’indique s’occuper de l’affichage. Il n’y a quasiment aucun calcul dans cette partie car son seul but est de récupérer des variables pour savoir ce qui va être affiché.
  • Contrôleur : Un contrôleur va gérer la logique du code. Il sert d’intermédiaire entre le modèle et la vue. Globalement, il va demander au modèle les données et les analyser puis il renvoie le texte qu’il faut afficher à la vue.

On peut, en complément du Contrôleur, avoir une couche que l’on va nommer communément Service, qui va se charger de la récupération de données pour une API par exemple.

Entity Framework Core

Entity Framework Core est un ORM créé par Microsoft, il vous permet d’effectuer des opérations CRUD sans avoir besoin d’écrire des requêtes SQL.

Pour reprendre à la base : qu’est-ce qu’un ORM ?

ORM signifie Object Relational Mapping ou Mapping Objet Relationnel en français. C’est une couche supplémentaire à notre application.

Mais qu’est-ce que ça signifie concrètement : que ça se place entre un programme applicatif et une base de données relationnelle afin de simuler une base de données orientée objet. On va donc associer une classe et une table et pour chacun des attributs de la classe qui vont correspondre à un champ de la table associée.

Avantages

  • Réduction de la quantité de code est réduite et que l’on gagne en homogénéité avec le reste du code (pour les langages orientés objets).
  • On va pouvoir travailler directement avec des objets complexes.
  • Plus besoin d’écrire nos requêtes SQL.
  • Moins de travail pour les développeurs

Inconvénients

L’utilisation d’ORM, induit une couche logicielle supplémentaire ce qui forcément nuit aux performances de l’application et rend particulièrement délicate la maintenance de l’application. Ainsi que la durée de vie de l’application.

Modeling

Entity Framework Core va via une commande « mapper » des classes complexes. Il va donc faire une requête à la base de données et remplir les données de nos classes associé au même table.

Les classes à remplir s’appellent des Modèles. Voici un exemple dans la solution eShopWeb :

namespace Microsoft.eShopWeb.Web.ViewModels
{
  public class CatalogItemViewModel
  {
     public int Id { get; set; }
     public string Name { get; set; }
     public string PictureUri { get; set; }
     public decimal Price { get; set; }
  }
}

Comme vous pouvez le voir, ce Modèle correspond aux informations relatives à un objet présent dans le catalogue.

Maintenant, voici l’objet Catalog qui contient tout les items et d’autres informations :

using Microsoft.AspNetCore.Mvc.Rendering; using System.Collections.Generic; namespace Microsoft.eShopWeb.Web.ViewModels {   
  public class CatalogIndexViewModel   
  {     
    public IEnumerable<CatalogItemViewModel> CatalogItems { get; set; } public IEnumerable<SelectListItem> Brands { get; set; }     
    public IEnumerable<SelectListItem> Types { get; set; }     
    public int? BrandFilterApplied { get; set; }     
    public int? TypesFilterApplied { get; set; }     
    public PaginationInfoViewModel PaginationInfo { get; set; }  
 
  } 
}

Pour pouvoir le remplir (binding), nous allons donc maintenant voir un nouvel exemple :

using Microsoft.eShopWeb.ApplicationCore.Entities;
using System.Collections.Generic;
using System.Threading.Tasks; namespace Microsoft.eShopWeb.ApplicationCore.Interfaces {   
  public interface IAsyncRepository<T> where T : BaseEntity, IAggregateRoot   
  {     
    Task<T> GetByIdAsync(int id);     
    Task<IReadOnlyList<T>> ListAllAsync();     
    Task<IReadOnlyList<T>> ListAsync(ISpecification<T> spec);     
    Task<T> AddAsync(T entity);
    Task UpdateAsync(T entity);     
    Task DeleteAsync(T entity);     Task<int> CountAsync(ISpecification<T> spec);   
  } }

Ci-dessus, c’est là où nous faisons appel à EntityFrameworkCore.

Et dans le Service : CatalogViewModelService.cs

public async Task<CatalogIndexViewModel> GetCatalogItems(int pageIndex, int itemsPage, int? brandId, int? typeId) {   
  _logger.LogInformation("GetCatalogItems called.");   
  var filterSpecification = new CatalogFilterSpecification(brandId, typeId);
  var filterPaginatedSpecification =   new CatalogFilterPaginatedSpecification(itemsPage * pageIndex, itemsPage, brandId, typeId);   // the implementation below using ForEach and Count. We need a List.   
  var itemsOnPage = await _itemRepository.ListAsync(filterPaginatedSpecification);   var totalItems = await _itemRepository.CountAsync(filterSpecification);   var vm = new CatalogIndexViewModel()   
{     
  CatalogItems = itemsOnPage.Select(i => new CatalogItemViewModel()     
  {        
    Id = i.Id,        
    Name = i.Name,       
    PictureUri = _uriComposer.ComposePicUri(i.PictureUri),        
    Price = i.Price     
  }),     
  
  Brands = await GetBrands(),     
  Types = await GetTypes(),     
  BrandFilterApplied = brandId ?? 0,     
  TypesFilterApplied = typeId ?? 0,     
  PaginationInfo = new PaginationInfoViewModel()    
  {       
    ActualPage = pageIndex,       
    ItemsPerPage = itemsOnPage.Count,       
    TotalItems = totalItems,       
    TotalPages = int.Parse(Math.Ceiling(((decimal)totalItems / itemsPage)).ToString())     
  }   
};   
  vm.PaginationInfo.Next = (vm.PaginationInfo.ActualPage == vm.PaginationInfo.TotalPages - 1) ? "is-disabled" : "";   
  vm.PaginationInfo.Previous = (vm.PaginationInfo.ActualPage == 0) ? "is-disabled" : "";   
  return vm; }

 

Providers

Un provider n’est ni plus ni moins qu’une librairie utilisable. Dans notre cas, celle qui nous intéresse particulièrement et dont on va parler est la librairie InMemory qui est un Fournisseur en Mémoire.

InMemory Provider

Ce fournisseur est utile lorsque l’on souhaite tester des composants en utilisant quelque chose qui se rapproche de la connexion à la base de données réelle, sans les frais des opérations de la base de données réelle.

L’avantage de ce fournisseur en mémoire et que l’on peut tester notre code par rapport à une base de données en mémoire au lieu de devoir en installer une et de la configurer.

Solution eShopWeb

Nous allons maintenant voir plus en détail cette solution et nous allons nous pencher sur les deux fonctionnalités majeures :

  • Add to Basket
  • Checkout

Add to Basket

Le « Add to Basket » comme son nom l’indique, vous permet d’ajouter un article dans votre panier.

eshopweb.PNG

Accueil du site

Voilà à quoi ressemble le site eShopWeb. Une fois que vous cliquez sur Add to Basket, vous êtes directement redirigé vers votre panier.  via l’URL : https://localhost:44315/Basket

Capturebasket.PNG

Que se passe-t-il au niveau du code ?

L’image représentant l’accueil du site est dans le code, lié au fichier _product.cshtml qui lorsqu’un utilisateur clique sur ADD TO BASKET il sera redirigé ver l’URL suivante : http://localhost:port/Basket

Cette URL correspond au fichier Index.cshtml qui est couplé au fichier Index.cshtml.cs et c’est ce fichier cshtml.cs qui va posséder la « logique » de la page avec une méthode OnPost.

public async Task<IActionResult> OnPost(CatalogItemViewModel productDetails) {   
    if (productDetails?.Id == null)   
    {     
        return RedirectToPage("/Index");   
    }   

    await SetBasketModelAsync(); //Vérifie si l'on est connecté.   
    await _basketService.AddItemToBasket(BasketModel.Id, productDetails.Id, productDetails.Price); //Ajout de l'objet au panier.   
    await SetBasketModelAsync();  
    return RedirectToPage(); }

Dans cette méthode OnPost, on peut voir :

  • Une condition if, afin de vérifier si l’ID du produit n’existe pas
    • Si cette condition se vérifie, l’utilisateur sera redirigé vers l’URL http://localhost:port/Index
    • Sinon, on vérifie d’abord que l’utilisateur est connecté grâce à SetBasketModelAsync()
  • Ce SetBasketModelAsync() va quant à lui, vérifier si l’utilisateur est connecté et s’il a déjà un panier de fait sinon l’utilisateur n’est pas encore connecté mais possède un panier avec les éléments qu’il aura ajouté dedans.
  • Suite à cela, on va ajouter le produit dans le panier en prenant en compte, l’id du panier, l’id du produit ainsi que le prix de celui-ci en passant par la classe BasketService :
public async Task AddItemToBasket(int basketId, int catalogItemId, decimal price, int quantity = 1) //Cette méthode ajoute le produit en premier. {   
    var basket = await _basketRepository.GetByIdAsync(basketId); //Vérifie à quel panier il doit l'ajouter.   
    basket.AddItem(catalogItemId, price, quantity); //Appel de la méthode dans Basket.cs   
    await _basketRepository.UpdateAsync(basket); }

Pour rappel, la variable _basketRepository basé sur la classe BasketRepository correpond à notre Entity Framework Core.

    • Ce même Service (BasketService) va tout d’abord Get le panier via l’id passé en paramètre (le nom du paramètre : basketId) et le stocker dans la variable basket (qui correspondra à une variable initialisée avec la classe Basket)
    • Puis on va ajouter un produit via la méthode AddItem que nous allons voir par la suite et qui prend en paramètres l’id du catalogue, le prix du produit et la quantité (par défaut initialisée à 1).
    • La dernière ligne va nous permettre de charger notre panier dans la base de donnée.
public void AddItem(int catalogItemId, decimal unitPrice, int quantity = 1) //méthode d'ajout 
{
  if (!Items.Any(i => i.CatalogItemId == catalogItemId))
    {
       _items.Add(new BasketItem(catalogItemId, quantity, unitPrice));
       return;
    }
  var existingItem = Items.FirstOrDefault(i => i.CatalogItemId == catalogItemId);
  existingItem.AddQuantity(quantity);
}
  •  le If va nous permettre de savoir si le produit se trouve déjà dans notre liste de produit.
  • Si non, nous entrons dans le If et nous l’ajoutons.
  • Si oui, nous allons simplement mettre à jour la quantité de ce produit.

 

Passons maintenant à la partie Paiement (Checkout)

Il existe deux cas pour cette partie :

  • Soit vous êtes connecté
    • Le bouton CHECKOUT dans le fichier Index.cshtml va vous emmener sur le fichier Checkout.cshtml.
      • Ce fichier est lié au fichier Checkout.cshtml.cs qui va s’occuper de toute la logique.
      • La méthode dans Checkout.cshtml.cs qui nous intéresse est la méthode OnPost :
public async Task<IActionResult> OnPost(Dictionary<string, int> items) {   
    await SetBasketModelAsync();   
    await _basketService.SetQuantities(BasketModel.Id, items);   
    await _orderService.CreateOrderAsync(BasketModel.Id, new Address("123 Main St.", "Kent", "OH", "United States", "44240"));   
    await _basketService.DeleteBasketAsync(BasketModel.Id);   
    return RedirectToPage(); 
}
        • La méthode SetBasketModelAsync() comme précédemment va vérifier si vous êtes connectés ou non en tant qu’utilisateur
        • Le _basketService.SetQuantities() va set le nombre d’articles présent dans notre panier
        • Le _orderService.CreateOrderAsync() fait appel au service OrderService et permet l’ajout de notre commande (on va le détailler comment cela fonctionne un peu plus tard).
        • Le _basketService.DeleteBasketAsync() va détruire le panier dans la base de donnée.
    • Pour revenir au _orderService.CreateOrderAsync() :
public async Task CreateOrderAsync(int basketId, Address shippingAddress) { var basket = await _basketRepository.GetByIdAsync(basketId);   Guard.Against.NullBasket(basketId, basket);
var items = new List<OrderItem>();
foreach (var item in basket.Items)
{
var catalogItem = await _itemRepository.GetByIdAsync(item.CatalogItemId);     var itemOrdered = new CatalogItemOrdered(catalogItem.Id, catalogItem.Name, _uriComposer.ComposePicUri(catalogItem.PictureUri));
var orderItem = new OrderItem(itemOrdered, item.UnitPrice, item.Quantity);     items.Add(orderItem); }
var order = new Order(basket.BuyerId, shippingAddress, items);
await _orderRepository.AddAsync(order);
}

Que fait cette méthode ?

  • On get d’abord le panier
  • Ensuite on regarde si le panier est null
  • Nous créons une liste d’item à commander
  • Dans la boucle nous allons remplir cette liste en récupérant les éléments se trouvant dans notre panier
  • Nous allons créer un nouvel objet Order
  • Et l’ajouter dans la base de donner (appel de OrderRepository.AddAsync())

MVC : Comment les interactions sont faites

order.PNG

Mes commandes – Images

 

Cette page est la représentation graphique de la View (vue) : MyOrders.cshtml

@model IEnumerable<OrderViewModel>
@{
ViewData["Title"] = "My Order History";
}

<div class="esh-orders">
<div class="container">
<h1>@ViewData["Title"]</h1>
<article class="esh-orders-titles row">
<section class="esh-orders-title col-xs-2">Order number</section>
<section class="esh-orders-title col-xs-4">Date</section>
<section class="esh-orders-title col-xs-2">Total</section>
<section class="esh-orders-title col-xs-2">Status</section>
<section class="esh-orders-title col-xs-2"></section>
</article>
@if (Model != null && Model.Any())
{
@foreach (var item in Model)
{
<article class="esh-orders-items row">
<section class="esh-orders-item col-xs-2">@Html.DisplayFor(modelItem => item.OrderNumber)</section>
<section class="esh-orders-item col-xs-4">@Html.DisplayFor(modelItem => item.OrderDate)</section>
<section class="esh-orders-item col-xs-2">$ @Html.DisplayFor(modelItem => item.Total)</section>
<section class="esh-orders-item col-xs-2">@Html.DisplayFor(modelItem => item.Status)</section>
<section class="esh-orders-item col-xs-1">
<a class="esh-orders-link" asp-controller="Order" asp-action="Detail" asp-route-orderId="@item.OrderNumber">Detail</a>
</section>
<section class="esh-orders-item col-xs-1">
@if (item.Status.ToLower() == "submitted")
{
<a class="esh-orders-link" asp-controller="Order" asp-action="cancel" asp-route-orderId="@item.OrderNumber">Cancel</a>
}
</section>
</article>
}
}
</div>
</div>

Cette View est directement lié au Contrôleur : OrderController, plus particulièrement à la méthode MyOrders :

[HttpGet()]
public async Task<IActionResult> MyOrders()
{
var viewModel = await _mediator.Send(new GetMyOrders(User.Identity.Name));

return View(viewModel);
}

Comme nous pouvons le voir ici, la première ligne correspond au contrôle de données (ici, nous récupérons la liste des commandes dans la base de données). Puis nous retournons la vue de notre Contrôleur (l’image Mes commandes – Images ci-dessus).

Si nous cliquons sur un des boutons DETAIL, nous aurons accès au détail du produit sélectionné (la sélection se fait par l’id du produit) :

<section class="esh-orders-item col-xs-1">
<a class="esh-orders-link" asp-controller="Order" asp-action="Detail" asp-route-orderId="@item.OrderNumber">Detail</a>
</section>

L’appel à Detail dans le fichier order.cshtmlIci, on va appeler la méthode de l’OrderController s’appelant Detail.

[HttpGet("{orderId}")]
public async Task<IActionResult> Detail(int orderId)
{
var viewModel = await _mediator.Send(new GetOrderDetails(User.Identity.Name, orderId));

if (viewModel == null)
{
return BadRequest("No such order found for this user.");
}

return View(viewModel);
}

On peut observer que dans le Contrôleur, nous récupérons le détail de la commande. Et nous retournons la bonne vue associée :

@model OrderViewModel
@{
ViewData["Title"] = "My Order History";
}
@{
ViewData["Title"] = "Order Detail";
}

<div class="esh-orders-detail">
<div class="container">
<section class="esh-orders-detail-section">
<article class="esh-orders-detail-titles row">
<section class="esh-orders-detail-title col-xs-3">Order number</section>
<section class="esh-orders-detail-title col-xs-3">Date</section>
<section class="esh-orders-detail-title col-xs-2">Total</section>
<section class="esh-orders-detail-title col-xs-3">Status</section>
</article>

<article class="esh-orders-detail-items row">
<section class="esh-orders-detail-item col-xs-3">@Model.OrderNumber</section>
<section class="esh-orders-detail-item col-xs-3">@Model.OrderDate</section>
<section class="esh-orders-detail-item col-xs-2">$@Model.Total.ToString("N2")</section>
<section class="esh-orders-detail-item col-xs-3">@Model.Status</section>
</article>
</section>

<section class="esh-orders-detail-section">
<article class="esh-orders-detail-titles row">
<section class="esh-orders-detail-title col-xs-12">Shipping Address</section>
</article>

<article class="esh-orders-detail-items row">
<section class="esh-orders-detail-item col-xs-12">@Model.ShippingAddress.Street</section>
</article>

<article class="esh-orders-detail-items row">
<section class="esh-orders-detail-item col-xs-12">@Model.ShippingAddress.City</section>
</article>

<article class="esh-orders-detail-items row">
<section class="esh-orders-detail-item col-xs-12">@Model.ShippingAddress.Country</section>
</article>
</section>

<section class="esh-orders-detail-section">
<article class="esh-orders-detail-titles row">
<section class="esh-orders-detail-title col-xs-12">ORDER DETAILS</section>
</article>

@for (int i = 0; i < Model.OrderItems.Count; i++)
{
var item = Model.OrderItems[i];
<article class="esh-orders-detail-items esh-orders-detail-items--border row">
<section class="esh-orders-detail-item col-md-4 hidden-md-down">
<img class="esh-orders-detail-image" src="@item.PictureUrl">
</section>
<section class="esh-orders-detail-item esh-orders-detail-item--middle col-xs-3">@item.ProductName</section>
<section class="esh-orders-detail-item esh-orders-detail-item--middle col-xs-1">$ @item.UnitPrice.ToString("N2")</section>
<section class="esh-orders-detail-item esh-orders-detail-item--middle col-xs-1">@item.Units</section>
<section class="esh-orders-detail-item esh-orders-detail-item--middle col-xs-2">$ @Math.Round(item.Units * item.UnitPrice, 2).ToString("N2")</section>
</article>
}
</section>

<section class="esh-orders-detail-section esh-orders-detail-section--right">
<article class="esh-orders-detail-titles esh-basket-titles--clean row">
<section class="esh-orders-detail-title col-xs-9"></section>
<section class="esh-orders-detail-title col-xs-2">TOTAL</section>
</article>

<article class="esh-orders-detail-items row">
<section class="esh-orders-detail-item col-xs-9"></section>
<section class="esh-orders-detail-item esh-orders-detail-item--mark col-xs-2">$ @Model.Total.ToString("N2")</section>
</article>
</section>
</div>
</div>

Fichier .cshtml se traduisant en élément graphique par l’image ci-dessous :

order_details.PNG

Détail du produit Mug

Il en va de même pour toutes les pages, chaque pages fonctionnant de la même façon. Notre Contrôleur va gérer nos données (Modèle) et retourner la Vue correspondante au Contrôleur.

 

Conclusion

Ce qu’on peut tirer de ce projet, est l’application d’une architecture monolithique en opposition avec le eShopOnContainers qui se base sur les micro-services.

Ce sont deux approches différentes et qui ont chacune leurs avantages et leurs inconvénients.

Néanmoins ces derniers temps, les entreprises privilégient les micro-services avec Docker et le concept de conteneurisation.

Article écrit par :

  • Julie LACOGNATA <julie.lacognata@infeeny.com>
  • Kévin ANSARD <kevin.ansard@infeeny.com>

Chroniques Techniques sur le JDN

Retrouvez les 3 dernières chroniques de notre Leader de Domaine .NET (ChristopheP) sur le Journal du Net (JDN):

.NET 5 : introduction à la plateforme unifiée de Microsoft – A partir de novembre 2020, Microsoft fusionne .NET Framework et .NET Core 3.x pour créer .NET 5. Une plateforme unifiée pour les développeurs combinant dev .NET, Cloud, gaming, IoT, web, et l’IA.

Comment devenir un développeur expert Microsoft ? – Le monde du développement selon Microsoft est complexe. Il faut savoir décrypter les messages envoyés par le marketing du groupe pour pourvoir lire entre les lignes.

Comment j’ai démystifié Kubernetes, sous Linux Ubuntu – Kubernetes est la technologie cloud à la mode. On en parle partout. J’ai voulu m’intéresser à ça et maîtriser la chose en local avant de la mettre en oeuvre dans le cloud. Voici la synthèse de mon expérience.