Création du projet
Dans les différents tutoriels que je vous proposes, j'utiliserai comme exemple une application qui permet de gérer une collection de films.Commençons tout d'abord par créer dans Visual Studio une application WPF. Ajouter ensuite dans les références, la bibliothèque DBLib.dll
Créer ensuite un dossier nommé Schemas, y ajouter une classe nommée Films (au pluriel).
De la même façon, créer un dossier Rows, y ajouter une classe Film (au singulier).
Définition de la classe Films
Cette classe représente le schéma d'une table de films.public class Films:Table<Film>
{
public static UniqueIDColumn<Film> FilmID = new UniqueIDColumn<Film>("FilmID");
public static ValueColumn<Film, Text> Title = new ValueColumn<Film, Text>("Title");
public static ValueColumn<Film, short> Year=new ValueColumn<Film,short>("Year");
}
Elle contient la définition de trois colonnes:
- FilmID: Cette colonne contiendra une valeur unique pour chaque film.
- Title: Cette colonne contiendra le titre du film.
- Year: Cette colonne contiendra l'année de sortie du film.
Vous remarquerez que la structure de la classe est très proche d'un schéma de table de bases de données.
La définition des colonnes est statique et utilise des génériques:
- Le premier paramètre indique que la colonne appartient aux objets du type Film.
- Le second paramètre (si présent), indique le type de la valeur contenue. Il doit obligatoirement être un type de valeur.
- Le constructeur de chaque champ nécessite au moins un paramètre, qui précise le nom de la colonne.
Note: J'utilise dans mon framework la structure personnalisée Text, car la classe string n'est pas un type de valeur.
Réalisons quelques ajustements...
public class Films:Table<Film>
{
public static UniqueIDColumn<Film> FilmID = new UniqueIDColumn<Film>("FilmID");
public static ValueColumn<Film, Text> Title = new ValueColumn<Film, Text>("Title") { DefaultValue = "New film" };
public static ValueColumn<Film, short> Year=new ValueColumn<Film,short>("Year");
public static ValueColumn<Film, Text> Description = new ValueColumn<Film, Text>("Description",true);
}
J'ai ajouté une valeur par défaut pour Title, et une nouvelle colonne Description. Le second paramètre du constructeur, indique que la valeur NULL est autorisée dans ce champ.
Définition de la classe Film
Cette classe représente un film de notre collection.
public class Film:Row
{
public Guid? FilmID
{
get { return Films.FilmID.GetValue(this); }
}
public Text? Title
{
get { return Films.Title.GetValue(this); }
set { Films.Title.SetValue(this, value); }
}
public short? Year
{
get { return Films.Year.GetValue(this); }
set { Films.Year.SetValue(this, value); }
}
public Text? Description
{
get { return Films.Description.GetValue(this); }
set { Films.Description.SetValue(this, value); }
}
}
La classe expose des propriétés, qui retournent les valeurs des colonnes définies dans la table.
La propriété FilmID n'a pas d'accesseur set, car comme une clé primaire, cet ID unique n'a pas de raison de changer.Chaque propriété retourne un type Nullable<T>, où T est le type défini dans la colonne correspondante.
Note: Le nom de la propriété doit être identique au nom de la colonne spécifiée dans le constructeur.
La base de données
Créons maintenant une base de données, qui contiendra nos tables. Pour cela, ajouter une classe Collections (au pluriel) dans le dossier Schemas, et une classe Collection dans la racine du projet.
La classe Collections, représente le schéma de la base de données.
public class Collections : Schema<Collection>
{
public static readonly Films Films = new Films();
}
Ce schéma déclare une seule table (celle des films). Les règles de déclaration des tables sont similaires à celles de déclaration des colonnes.
Dans le cas des tables, si un nom n'est pas spécifié dans le constructeur, le framework utilisera le nom du type de la classe.
La classe Collection représente une instance de notre base de données.
public class Collection : Database
{
public override byte Version
{
get { return 1; }
}
public RowCollection<Film> Films
{
get { return Collections.Films.GetValue(this); }
}
}
Elle doit hériter du type Database, et doit fournir au minimum, la propriété Version. Cette valeur pourra être utilisée plus tard, pour la compatibilité ascendante.
Elle expose aussi une liste de films, récupérée à travers le champ statique du schéma.
Conclusion
Nous avons terminé de déclarer nos classes. J'ai sciemment fait le choix d'utiliser des données fortement typées, et explicitement déclarées dans le code c#, contrairement par exemple, aux dataset de l'espace de noms System.Data. Ceci me garantie l'intégrité de mes données, et m'évite les erreurs de frappe dans le code, ou dans les déclarations XAML.
La mécanisme de déclaration des tables et des colonnes et largement inspiré des DependencyProperty, mais propose des mécanisme supplémentaires.
Nous verrons dans le prochain article comment intégrer ces données dans notre interface utilisateur.
Télécharger le projet Visual Studio




Aucun commentaire:
Enregistrer un commentaire