Carnet d'Adresses 6 - Sauvegarde et chargement

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.

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