Looking for xquery Answers? Try Ask4KnowledgeBase
Looking for xquery Keywords? Try Ask4Keywords

xqueryDémarrer avec xquery


Remarques

Cette section fournit une vue d'ensemble de ce qu'est xquery et des raisons pour lesquelles un développeur peut vouloir l'utiliser.

Il devrait également mentionner tous les grands sujets dans xquery, et établir un lien avec les sujets connexes. La documentation de xquery étant nouvelle, vous devrez peut-être créer des versions initiales de ces rubriques connexes.

Extraire des données XML

Pour adresser des données à partir d'une entrée XML, XQuery utilise XPath .
Cela facilite le filtrage des données et leur restructuration.

Compte tenu de l'entrée XML suivante

<?xml version="1.0" encoding="UTF-8"?>
<applications>
  <application>
    <id>MyApp</id>
    <name>My Application</name>
    <version>1.0</version>
  </application>
  <application>
    <id>SomeApp</id>
    <name>Some Application</name>
    <version>4.2</version>
  </application>
  <application>
    <id>TheOtherApp</id>
    <name>That one</name>
    <version>13.37</version>
  </application>
</applications>    
 

Le code XQuery suivant va extraire l'application dont l'ID est MyApp :

/applications/application[id='MyApp']
 

Il produit le document XML suivant:

<?xml version="1.0" encoding="UTF-8"?>
<application>
  <id>MyApp</id>
  <name>My Application</name>
  <version>1.0</version>
</application>
 

Et ce code extraira les applications dont la version est inférieure à 10, en les <oldApplications> dans une <oldApplications> :

    <oldApplications>{/applications/application[version < 10]}</oldApplications> 
 

Il contient le document XML suivant:

<?xml version="1.0" encoding="UTF-8"?>
<oldApplications>
  <application>
    <id>MyApp</id>
    <name>My Application</name>
    <version>1.0</version>
  </application>
  <application>
    <id>SomeApp</id>
    <name>Some Application</name>
    <version>4.2</version>
  </application>
</oldApplications>   
 

Installation ou configuration

Instructions détaillées sur la configuration ou l'installation de xquery.

Somme des valeurs

Vu le document XML suivant:

<?xml version="1.0" encoding="UTF-8"?>
<values>
  <value>1</value>
  <value>3</value>
  <value>5</value>
</values>
 

Nous pouvons produire un document XML décrivant la somme des valeurs avec le XQuery suivant:

<total>{sum(/values/value)}</total>
 

Ce qui se traduira par le document suivant:

<?xml version="1.0" encoding="UTF-8"?>
<total>9</total>
 

Écrire du XML statique

Les données XML peuvent être écrites telles quelles dans XQuery et seront trouvées dans la sortie.
Le code suivant peut être considéré comme XQuery valide:

<application>
  <id>MyApp</id>
  <name>My Application</name>
  <version>1.0</version>
</application>
 

Notez que votre code XQuery doit produire un document XML valide et que, par conséquent, il est limité à la sortie de toutes ses données dans une seule balise racine.

De plus, par défaut, la plupart des implémentations XQuery ajouteront l'en-tête XML si vous l'omettez. Par exemple, le code ci-dessus produirait ce résultat:

<?xml version="1.0" encoding="UTF-8"?>
<application>
  <id>MyApp</id>
  <name>My Application</name>
  <version>1.0</version>
</application>