Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

Recipes Example

Files:

The recipes example shows how to use QtXmlPatterns to query XML data loaded from a file.

Introduction

In this case, the XML data represents a cookbook, cookbook.xml, which contains <cookbook> as its document element, which in turn contains a sequence of <recipe> elements. This XML data is searched using queries stored in XQuery files (*.xq).

The User Interface

The UI for this example was created using Qt Designer:

The UI consists of three group boxes arranged vertically. The top one contains a text viewer that displays the XML text from the cookbook file. The middle group box contains a combo box for choosing the XQuery to run and a text viewer for displaying the text of the selected XQuery. The .xq files in the file list above are shown in the combo box menu. Choosing an XQuery loads, parses, and runs the selected XQuery. The query result is shown in the bottom group box's text viewer.

Running your own XQueries

You can write your own XQuery files and run them in the example program. The file xmlpatterns/recipes/recipes.qrc is the resource file for this example. It is used in main.cpp (Q_INIT_RESOURCE(recipes);). It lists the XQuery files (.xq) that can be selected in the combobox.

 <!DOCTYPE RCC><RCC version="1.0">
 <qresource>
     <file>forms/querywidget.ui</file>
     <file>files/cookbook.xml</file>
     <file>files/allRecipes.xq</file>
     <file>files/liquidIngredientsInSoup.xq</file>
     <file>files/mushroomSoup.xq</file>
     <file>files/preparationLessThan30.xq</file>
     <file>files/preparationTimes.xq</file>
 </qresource>
 </RCC>

To add your own queries to the example's combobox, store your .xq files in the examples/xmlpatterns/recipes/files directory and add them to recipes.qrc as shown above.

Code Walk-Through

The example's main() function creates the standard instance of QApplication. Then it creates an instance of the UI class, shows it, and starts the Qt event loop:

 int main(int argc, char* argv[])
 {
     Q_INIT_RESOURCE(recipes);
     QApplication app(argc, argv);
     QueryMainWindow* const queryWindow = new QueryMainWindow;
     queryWindow->show();
     return app.exec();
 }

The UI Class: QueryMainWindow

The example's UI is a conventional Qt GUI application inheriting QMainWindow and the class generated by Qt Designer:

 class QueryMainWindow : public QMainWindow,
                         private Ui::QueryWidget
 {
     Q_OBJECT

   public:
     QueryMainWindow();

   public slots:
     void displayQuery(int index);

   private:
     QComboBox* ui_defaultQueries;

     void evaluate(const QString &str);
     void loadInputFile();
 };

The constructor finds the window's combo box child widget and connects its currentIndexChanged() signal to the window's displayQuery() slot. It then calls loadInputFile() to load cookbook.xml and display its contents in the top group box's text viewer . Finally, it finds the XQuery files (.xq) and adds each one to the combo box menu.

 QueryMainWindow::QueryMainWindow() : ui_defaultQueries(0)
 {
     setupUi(this);

     new XmlSyntaxHighlighter(qFindChild<QTextEdit*>(this, "inputTextEdit")->document());
     new XmlSyntaxHighlighter(qFindChild<QTextEdit*>(this, "outputTextEdit")->document());

     ui_defaultQueries = qFindChild<QComboBox*>(this, "defaultQueries");
     QMetaObject::connectSlotsByName(this);
     connect(ui_defaultQueries, SIGNAL(currentIndexChanged(int)), SLOT(displayQuery(int)));

     loadInputFile();
     const QStringList queries(QDir(":/files/", "*.xq").entryList());
     int len = queries.count();
     for(int i = 0; i < len; ++i)
         ui_defaultQueries->addItem(queries.at(i));
 }

The work is done in the displayQuery() slot and the evaluate() function it calls. displayQuery() loads and displays the selected query file and passes the XQuery text to evaluate().

 void QueryMainWindow::displayQuery(int index)
 {
     QFile queryFile(QString(":files/") + ui_defaultQueries->itemText(index));
     queryFile.open(QIODevice::ReadOnly);
     const QString query(QString::fromLatin1(queryFile.readAll()));
     qFindChild<QTextEdit*>(this, "queryTextEdit")->setPlainText(query);

     evaluate(query);
 }

evaluate() demonstrates the standard QtXmlPatterns usage pattern. First, an instance of QXmlQuery is created (query). The query's bindVariable() function is then called to bind the cookbook.xml file to the XQuery variable inputDocument. After the variable is bound, setQuery() is called to pass the XQuery text to the query.

Note: setQuery() must be called after bindVariable().

Passing the XQuery to setQuery() causes QtXmlPatterns to parse the XQuery. QXmlQuery::isValid() is called to ensure that the XQuery was correctly parsed.

 void QueryMainWindow::evaluate(const QString &str)
 {
     QFile sourceDocument;
     sourceDocument.setFileName(":/files/cookbook.xml");
     sourceDocument.open(QIODevice::ReadOnly);

     QByteArray outArray;
     QBuffer buffer(&outArray);
     buffer.open(QIODevice::ReadWrite);

     QXmlQuery query;
     query.bindVariable("inputDocument", &sourceDocument);
     query.setQuery(str);
     if (!query.isValid())
         return;

     QXmlFormatter formatter(query, &buffer);
     if (!query.evaluateTo(&formatter))
         return;

     buffer.close();
     qFindChild<QTextEdit*>(this, "outputTextEdit")->setPlainText(QString::fromUtf8(outArray.constData()));

 }

If the XQuery is valid, an instance of QXmlFormatter is created to format the query result as XML into a QBuffer. To evaluate the XQuery, an overload of evaluateTo() is called that takes a QAbstractXmlReceiver for its output (QXmlFormatter inherits QAbstractXmlReceiver). Finally, the formatted XML result is displayed in the UI's bottom text view.

Note: Each XQuery .xq file must declare the $inputDocument variable to represent the cookbook.xml document:

 (: All ingredients for Mushroom Soup. :)
 declare variable $inputDocument external;

 doc($inputDocument)/cookbook/recipe[@xml:id = "MushroomSoup"]/ingredient/
 <p>{@name, @quantity}</p>

Note: If you add add your own query.xq files, you must declare the $inputDocument and use it as shown above.

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 68
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. La rubrique PyQt/PySide a besoin de vous ! 0
Page suivante

Le blog Digia au hasard

Logo

Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article de Digia Qt traduit par Thibaut Cuvelier

Le blog Digia est l'endroit privilégié pour la communication sur l'édition commerciale de Qt, où des réponses publiques sont apportées aux questions les plus posées au support. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.5
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web