ReadMe.txt 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. Mode d'emploi du projet modèle MVC-entity
  2. *-*-*-*-*-*
  3. historique
  4. v0.1 13/07/2016 (Julien Legrand) : 1ère version
  5. *-*-*-*-*-*
  6. # Actions à faire après copie
  7. 1. Renommer les projets en suivant ce schéma : "CD67.[nom appli].[Entity/Factory/MVC/Tests/Batchs]"
  8. 2. Renommer également les assemblies et espaces de nom de chaque projet (dans les propriétés des projets, onglet "Application")
  9. x. Supprimer les fichiers Exemples :
  10. - CD67.ModeleMVC.Entity\Extend\PARAM.cs
  11. 10. supprimer ce fichier pour ne pas que l'on sache que vous avez utilisé un modèle
  12. # Description générale
  13. La solution est consituée de 4 projets :
  14. - CD67.ModeleMVC.Entity : Projet qui contient les objets métiers, c'est à dire dans le cas de projets Entity : le modèle entity framework
  15. - CD67.ModeleMVC.Factory : Projet qui contient les classes permettant la gestion des objets : les actions CRUD pour chacun à minima
  16. - CD67.ModeleMVC.MVC : Projet qui comprent le site Web MVC
  17. - CD67.ModeleMVC.Tests : Tests unitaires
  18. # CD67.ModeleMVC.Entity
  19. Le modèle se nomme par défaut "EntityModel"
  20. Le dossier "Extend" contient les extensions éventuelles de classe Entity (qui se trouvent dans "EntityModel.edmx\EntityModel.tt\").
  21. C'est notamment utile pour ajouter les DataAnnotations permettant de décrire le données en vue d'une génération de contrôles plus appropiés dans les vues MVC.
  22. Attention à bien surveiller l'espace de noms lors de la création d'une classe dans ce sous-dossier (erreur fréquente) :
  23. - par défaut ce sera : "CD67.ModeleMVC.Entity.Extend",
  24. - mais il faut "CD67.ModeleMVC.Entity" (le même que les classes de bases Entity).
  25. Le dossier "Internal" contient :
  26. - "FormattedDbEntityValidationException.cs" : classe héritée de Exception qui permet un affichage plus complet dans les messages d'erreur pour les exceptions liées au format de données du modèle Entity
  27. - "Entities.cs" : classe partielle permettant d'utiliser les nouvelles Exceptions FormattedDbEntityValidationException en surchargeant "SaveChanges()"
  28. En cas d'ajout d'une nouvelle connexion avec Entity Framework, il faut ajouter une nouvelle classe d'extension du même type.
  29. # CD67.ModeleMVC.Factory
  30. Les classes sont nommées ainsi : "[Nom objet]Factory"
  31. Chaque "Factory" hérite de la classe de base "baseFactory"
  32. # CD67.ModeleMVC.MVC
  33. La partie Model du projet n'est pas nécessaire que pour définir des classes ne servant qu'à l'affichage, les classes mêtiers étant dans le projet Entity.
  34. # CD67.ModeleMVC.Tests
  35. Projet le plus important de la solution :)