Qt Reference Documentation

# Carnet d'Adresses 6 - Sauvegarde et chargement

Files:

- tutorials/addressbook-fr/part6/addressbook.cpp
- tutorials/addressbook-fr/part6/addressbook.h
- tutorials/addressbook-fr/part6/finddialog.cpp
- tutorials/addressbook-fr/part6/finddialog.h
- tutorials/addressbook-fr/part6/main.cpp
- tutorials/addressbook-fr/part6/part6.pro

Ce chapitre couvre les fonctionnalités de gestion des fichiers de Qt que l'on utilise pour écrire les procédures de sauvegarde et chargement pour l'application carnet d'adresses.

Bien que la navigation et la recherche de contacts soient des fonctionnalités importantes, notre carnet d'adresses ne sera pleinement utilisable qu'une fois que l'on pourra sauvegarder les contacts existants et les charger à nouveau par la suite. Qt fournit de nombreuses classes pour gérer les entrées et sorties, mais nous avons choisi de nous contenter d'une combinaison de deux classes simples à utiliser ensemble: QFile et QDataStream.

Un objet QFile représente un fichier sur le disque qui peut être lu, et dans lequel on peut écrire. QFile est une classe fille de la classe plus générique QIODevice, qui peut représenter différents types de périphériques.

Un objet QDataStream est utilisé pour sérialiser des données binaires dans le but de les passer à un QIODevice pour les récupérer dans le futur. Pour lire ou écrire dans un QIODevice, il suffit d'ouvrir le flux, avec le périphérique approprié en paramètre, et d'y lire ou écrire.

## Définition de la classe AddressBook

On déclare deux slots publics, `saveToFile()` et `loadFromFile()`, ainsi que deux objets QPushButton, `loadButton` et `saveButton`.

         void saveToFile();
         void loadFromFile();
         ...
         QPushButton *loadButton;
         QPushButton *saveButton;

## Implémentation de la classe AddressBook

Dans notre constructeur, on instancie `loadButton` et `saveButton`. Idéalement, l'interface serait plus conviviale avec des boutons affichant "Load contacts from a file" et "Save contacts to a file". Mais compte tenu de la dimension des autres boutons, on initialise les labels des boutons à Load... et Save.... Heureusement, Qt offre une façon simple d'ajouter des info-bulles avec setToolTip(), et nous l'exploitons de la façon suivante pour nos boutons:

         loadButton->setToolTip(tr("Load contacts from a file"));
         ...
         saveButton->setToolTip(tr("Save contacts to a file"));

Bien qu'on ne cite pas le code correspondant ici, nous ajoutons ces deux boutons au layout de droite, `button1Layout`, comme pour les fonctionnalités précédentes, et nous connectons leurs signaux clicked() à leurs slots respectifs.

Pour la sauvegarde, on commence par récupérer le nom de fichier `fileName`, en utilisant QFileDialog::getSaveFileName(). C'est une méthode pratique fournie par QFileDialog, qui ouvre une boîte de dialogue modale et permet à l'utilisateur d'entrer un nom de fichier ou de choisir un fichier `.abk` existant. Les fichiers `.abk` correspondent à l'extension choisie pour la sauvegarde des contacts de notre carnet d'adresses.

     void AddressBook::saveToFile()
     {
         QString fileName = QFileDialog::getSaveFileName(this,
             tr("Save Address Book"), "",
             tr("Address Book (*.abk);;All Files (*)"));

La boîte de dialogue affichée est visible sur la capture d'écran ci- dessous.

Si `fileName` n'est pas vide, on crée un objet QFile, `file`, à partir de `fileName`. QFile fonctionne avec QDataStream puisqu'il dérive de QIODevice.

Ensuite, on essaie d'ouvrir le fichier en écriture, ce qui correspond au mode WriteOnly. Si cela échoue, on en informe l'utilisateur avec une QMessageBox.

         if (fileName.isEmpty())
             return;
         else {
             QFile file(fileName);
             if (!file.open(QIODevice::WriteOnly)) {
                 QMessageBox::information(this, tr("Unable to open file"),
                     file.errorString());
                 return;
             }

Dans le cas contraire, on instancie un objet QDataStream, `out`, afin d'écrire dans le fichier ouvert. QDataStream nécessite que la même version de flux soit utilisée pour la lecture et l'écriture. On s'assure que c'est le cas en spécifiant explicitement d'utiliser la version introduite avec Qt 4.5 avant de sérialiser les données vers le fichier `file`.

             QDataStream out(&file);
             out.setVersion(QDataStream::Qt_4_5);
             out << contacts;
         }
     }

Pour le chargement, on récupère également `fileName` en utilisant QFileDialog::getOpenFileName(). Cette méthode est l'homologue de QFileDialog::getSaveFileName() et affiche également une boîte de dialogue modale permettant à l'utilisateur d'entrer un nom de fichier ou de selectionner un fichier `.abk` existant, afin de le charger dans le carnet d'adresses.

     void AddressBook::loadFromFile()
     {
         QString fileName = QFileDialog::getOpenFileName(this,
             tr("Open Address Book"), "",
             tr("Address Book (*.abk);;All Files (*)"));

Sous Windows, par exemple, cette méthode affiche une boîte de dialogue native pour la sélection de fichier, comme illustré sur la capture d'écran suivante:

Si `fileName` n'est pas vide, on utilise une fois de plus un objet QFile, `file`, et on tente de l'ouvrir en lecture, avec le mode ReadOnly. De même que précédemment dans notre implémentation de `saveToFile()`, si cette tentative s'avère infructueuse, on en informe l'utilisateur par le biais d'une QMessageBox.

         if (fileName.isEmpty())
             return;
         else {

             QFile file(fileName);

             if (!file.open(QIODevice::ReadOnly)) {
                 QMessageBox::information(this, tr("Unable to open file"),
                     file.errorString());
                 return;
             }

             QDataStream in(&file);
             in.setVersion(QDataStream::Qt_4_5);
             contacts.empty();   // empty existing contacts
             in >> contacts;

Dans le cas contraire, on instancie un objet QDataStream, `in`, en spécifiant la version à utiliser comme précédemment, et on lit les informations sérialisées vers la structure de données `contacts`. Notez qu'on purge `contacts` avant d'y mettre les informations lues afin de simplifier le processus de lecture de fichier. Une façon plus avancée de procéder serait de lire les contacts dans un objet QMap temporaire, et de copier uniquement les contacts n'existant pas encore dans `contacts`.

             if (contacts.isEmpty()) {
                 QMessageBox::information(this, tr("No contacts in file"),
                     tr("The file you are attempting to open contains no contacts."));
             } else {
                 QMap<QString, QString>::iterator i = contacts.begin();
                 nameLine->setText(i.key());
                 addressText->setText(i.value());
             }
         }

         updateInterface(NavigationMode);
     }

Pour afficher les contacts lus depuis le fichier, on doit d'abord valider les données obtenues afin de s'assurer que le fichier lu contient effectivement des entrées de carnet d'adresses. Si c'est le cas, on affiche le premier contact; sinon on informe l'utilisateur du problème par une QMessageBox. Enfin, on met à jour l'interface afin d'activer et de désactiver les boutons de façon appropriée.