3. XQuery de base

XQuery est bâti sur des éléments XPath, par exemple

1. position dans un arbre
• ex: retourne tous les noeuds <card-propvalue> sous <c3mssoft-desc> ...

//c3msbrick//c3mssoft-desc//card-propvalue

1. opérations de comparaison
• ex: retourne seulement le fragment pour une id particulière

//c3msbrick//c3mssoft[@id="epbl"]

1. functions
• ex: qui retourne juste le contenu d'un noeud

//c3msbrick/title/text()

Voici un survol:

1. 1. for = iteration sur une liste de fragments xml et
2. 2. let = association du résultat d'une expression à une variable
3. 3. where = condition de sélection
4. 4. order = tri des résultats
5. 5. return = expression à retourner

A. "for"

for $variable in expression_recherche
RETURN

"for" associe à chaque $variable une valeur (fragment XML) trouvé pour l'expression XQuery (voir page 7)

Exemple:

for $t in //topic/title

B. let

• "let" permet de d'assigner une valeur à une variable
• Voici une expression avec un for simple:

for $t in document("catalog09.xml")//c3msbrick//c3mssoft-desc//card-propvalue

return $t

• Voici une expressions équivalente au niveau du résultat retourné
• pour chaque fragment $t trouvé on définit une variable $desc qui contient un sous-fragment.

for $t in document("catalog09.xml")//c3msbrick

let $desc := $t//c3mssoft-desc//card-propvalue

return $desc

• L'exemple suivant est plus utile, pour chaque élément $t trouvé dans la boucle "for" on compte le nombre de certains sous-éléments et on affiche les titres de t$ avec le compte:

for $t in document("catalog09.xml")//c3msbrick

let $n := count($t//c3mssoft)

return <result> {$t/title/text()} possède {$n} briques </result>

C. where

• permet de définir une condition de sélection
• une seule par requête (je pense ? - à vérifier )
• Dans l'exemple suivant on reprent l'exemple ci-dessus, mais on affiche seulement les cas où on est en présence d'au moins 2 <c3mssoft>

for $t in document("catalog09.xml")//c3msbrick

let $n := count($t//c3mssoft)

where ($n > 1)

return <result> {$t/title/text()} possède {$n} briques </result>

D. order

• permet de trier les résultats
• Voici un simple tri alphabétique des résultats:

for $t in //topic/title order by $t return $t

• Voici le même exemple avec un tri dans l'ordre croissant

for $t in document("catalog09.xml")//c3msbrick

let $n := count($t//c3mssoft)

where ($n > 1)

order by $n

return <result> {$t/title/text()} possède {$n} briques </result>

• Voici un exemple un peu plus informatif, on donne aussi les <titles> des <c3msbricks>:

for $t in document("catalog09.xml")//c3msbrick

let $brick_softs := $t//c3mssoft

let $n := count($brick_softs)

where ($n > 0)

order by $n

return <result> 

      For {$t/title/text()} we found {$n} softwares: 
         {$brick_softs//title} 

      </result>

E. return

• construit l'expression à retourner à chaque iteration
• Attention: Chaque iteration doit retourner un seul fragment XML (pas une collection)

Juste:

for $t in document("catalog09.xml")//c3msbrick

let $n := count($t//c3mssoft)

return <result> 

       {$t/title/text()} possède {$n} briques 

       </result>

Faux:

for $t in document("catalog09.xml")//c3msbrick

let $n := count($t//c3mssoft)

return $t/title/text() possède $n briques 

A. Version multi-fragment (collection)

• il faudrait encore la traiter pour laffichage

L'expression suivante de base

for $t in //c3msbrick/title

   return $t

retourne une liste (une collection)

1	<title class ="- topic/title " > TECFA Seed Catalog </ title >

2	<title class ="- topic/title " > Introduction </ title >

3	<title class ="- topic/title " > Conceptual and technical framework </ title >

4	<title class ="- topic/title " > The socio-constructivist approach </ title >

....

• Autrement dit, on reçoit une collection de fragments xml
• Il va falloir la traiter pour pouvoir l'afficher (normalement avec un programme)

B. Version un seul fragment

L'expression suivante:

<result> 

 { for $t in //topic/title/text()

 return <titre>{$t}</titre> }

</result>

donne:

<result  >

<titre > TECFA Seed Catalog </ titre >

<titre > Introduction </ titre >

<titre > Conceptual and technical framework </ titre >

<titre > The socio-constructivist approach </ titre > 

....

</result>

• notez qu'on a remplacé les balises "title" par "titre"
• toutes les les expression entre { ...} sont évaluées
• mais à l'intérieur des ces expression toutes les <balises> sont copiés "tels quels"

Voici le résultat:

<result  >

<title > List of C3MSBricks and associated Software </ title >

<brick > Gallery possède les 5 briques suivants:

<soft > PhotoShare </ soft >

<soft > Photoshare combined with PageSetter </ soft >

<soft > My_eGallery </ soft >

<soft > Coppermine </ soft >

<soft > Gallery </ soft >

</ brick >

<brick > User statistics possède les 5 briques suivants:

<soft > commArt </ soft >

<soft > pncUserPoints </ soft >

<soft > pncSimpleStats </ soft >

<soft > Statistics module </ soft >

<soft > NS-User_Points </ soft >

</ brick > 

.....

</result>