====== XPath ======

{{tag> #FpInfor #Dam #Daw #Asix #DamMp04 #DawMp04 #AsixMp04 #DamMp04Uf02 #DawMp04Uf02 #AsixMp04Uf02 Xpath}}

XPath, [[http://www.w3.org/TR/xpath|recomanació del W3C]], és un llenguatge que 
permet navegar a través de dades XML. Desenvolupat pels comitès de creació 
d'XSL i XQuery, s'ha convertit en un component essencial d'aquests.

XPath no és un llenguatge XML, cosa que permet incloure'l en altres 
llenguatges XML sense preocupar-se si el resultat està ben format o no.

XPath utilitza un model de dades en arbre per als documents XML. A continuació 
es mostra un exemple de W3C.

Per al fitxer xml:

  <?xml version="1.0"?>
  <?xml-stylesheet type="text/xsl" href="dm-example.xsl"?>
  <catalog xmlns="http://www.example.com/catalog"
         xmlns:html="http://www.w3.org/1999/xhtml"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.example.com/catalog
                             dm-example.xsd"
         xml:lang="en"
         version="0.1">
   <!-- This example is for data model illustration only.
     It does not demonstrate good schema design. -->
      <tshirt code="T1534017" label=" Staind : Been Awhile "
        xlink:href="http://example.com/0,,1655091,00.html"
        sizes="M L XL">
        <title> Staind: Been Awhile Tee Black (1-sided) </title>
        <description>
          <html:p>
            Lyrics from the hit song 'It's Been Awhile'
            are shown in white, beneath the large
            'Flock &amp; Weld' Staind logo.
          </html:p>
        </description>
        <price> 25.00 </price>
      </tshirt>
      <album code="A1481344" label=" Staind : Its Been A While "
       formats="CD">
        <title> It's Been A While </title>
        <description xsi:nil="true" />
        <price currency="USD"> 10.99 </price>
        <artist> Staind </artist>
      </album>
   </catalog>

la representació gràfica del model de dades és el següent:

{{https://www.w3.org/TR/xpath-datamodel-31/dm-example-large.png?raw=true}}

XPath tracta els documents XML com un arbre de nodes. L'arrel, és el 
document i es representa amb el símbol ''/''. Els elements, els atributs, 
el contingut, els comentaris, les instruccions de procés i els 
espais de noms també representen nodes de l'arbre.

Els atributs no són considerats nodes fills, són propietats del node que 
els conté. Els nodes de dades no tenen nom.

Es pot navegar pels nodes d'un arbre XPath especificant un camí de 
manera anàloga a com es fa en els directoris dels sistemes operatius. 
Es poden expressar camins XPath de dues formes:

- **Camins absoluts**. Sempre comencen en l'arrel de l'arbre. 


   /catalog/tshirt/title  

retorna


   <title> Staind: Been Awhile Tee Black (1-sided) </title>


- **Camins relatius**. Parteixen des del node en el qual estem situats. 
Es mostren exemples d'utilització més endavant. 

En XPath, una expressió és un possible camí. Si s'especifica una 
expressió no vàlida, és a dir, que no correspon amb un camí dins d'un 
arbre XPath, no es retorna cap resultat. Per exemple:

   /catalog/tshirt/size  

no retorna resultat:

{{:xpathexpressionnoresult.png?800|}}

  En general, els exemples d'expressions inclosos en aquest text faran 
  referència al document XML mostrat a l'inici de la secció. Per poder 
  comprovar els exemples, es pot utilitzar Pycharm. En Pycharm es pot 
  avaluar una expressió XPath per un document XML si es té el plugin 
  "XPathView+XSLT" instal·lat. Per avaluar una expressió cal teclejar 
  "Ctrl+Shift+A" des del document XML i seleccionar "Evaluate XPath 
  Expression".

{{:ctrl_shift_a_evaluatexpathexpression.png?800|}}

Per obtenir valors d'atributs es pot especificar el símbol ''@'' davant del
nom des de l'element que el conté.

   /catalog/tshirt/@code  

retorna ''code="T1534017"''.

En les expressions XPath es poden fer servir comodins:

- ''*'' Indica tots els elements d'un determinat nivell.

  /catalog/tshirt/* 

retorna 

   <title> Staind: Been Awhile Tee Black (1-sided) </title>
     <description>
       <html:p>
         Lyrics from the hit song 'It's Been Awhile'
         are shown in white, beneath the large
         'Flock &amp; Weld' Staind logo.
       </html:p>
     </description>
  <price> 25.00 </price>

- ''.'' Indica el node actual. Es veu un exemple més endavant. 

- ''..'' Indica el pare del node en el qual estem. Es veu un exemple més 
endavant.

- <nowiki>//</nowiki> Indica qualsevol cosa des del node en el qual estem. Pot
ser un sol element o un arbre de nodes. No és recomanable utilitzar-lo 
sovint per motius d'eficiència.

   //price

retorna tots els elements ''<price>'' del fitxer independentment d'on pengin, 
és a dir: 

   <price> 25.00 </price>
   <price currency="USD"> 10.99 </price>

<nowiki>//</nowiki> es pot posar en qualsevol lloc dins de l'expressió, indicant que pot 
haver-hi qualsevol cosa enmig a partir del lloc on apareixen. L'expressió 
següent seria equivalent a l'anterior.

   /catalog//price

Una expressió XPath pot retornar un o més resultats. Per indicar un 
resultat específic d'un conjunt es pot fer servir un nombre envoltat per 
''[]'' per indicar quin és el que es vol aconseguir. Els nodes s'ordenen 
d'esquerra a dreta i comencen per l'índex 1.

Per exemple, si afegim un altre album al final del fitxer d'exemple:

   <album code="A1481345" label=" Rosalia : Malamente "
       formats="CD">
     <title> Malamente </title>
     <description xsi:nil="true" />
     <price currency="USD"> 10.99 </price>
     <artist> Rosalia </artist>
   </album>

l'expressió

   /catalog/album[2] 

retornaria només l'àlbum afegit. 

Per obtenir el contingut de l'element, s'utilitza la funció ''text()'' des 
de l'element que el conté.

   /catalog/album[1]/title/text() 

retorna ''It's Been A While''.

A una expressió XPath se li pot afegir **condicions** per obtenir els nodes 
que compleixin aquestes. La selecció de nodes es fa especificant un 
predicat XPath dins de ''[]''. El predicat XPath s'especifica amb **camins 
relatius** des del node amb la condició.

   //description[./html:p]

indica els elements ''<description>'' que tinguin un element ''<html:p>'' fill. 
Retorna:

   <description>
       <html:p>
         Lyrics from the hit song 'It's Been Awhile'
         are shown in white, beneath the large
         'Flock &amp; Weld' Staind logo.
       </html:p>
   </description>

i l'expressió

   //description[../artist]

indica els elements ''<description>'' que tinguin al mateix nivell un element 
''<artist>''. Retorna:

   <description xsi:nil="true" />
   <description xsi:nil="true" />

També es pot fer servir condicions per comprovar si un node té un valor 
determinat. 

   /catalog/album[price=" 10.99 "]

permet obtenir els albums amb preu ''" 10.99 "''. Retorna:


   <album code="A1481344" label=" Staind : Its Been A While "
       formats="CD">
     <title> It's Been A While </title>
     <description xsi:nil="true" />
     <price currency="USD"> 10.99 </price>
     <artist> Staind </artist>
   </album>
   <album code="A1481345" label=" Rosalia : Malamente "
       formats="CD">
     <title> Malamente </title>
     <description xsi:nil="true" />
     <price currency="USD"> 10.99 </price>
     <artist> Rosalia </artist>
   </album>

Les condicions es poden posar en qualsevol nivell del camí i pot 
haver-hi tantes com es vulgui.

   /catalog/tshirt[./price=" 25.00 "]/title

indica l'element ''<title>'' dels elements ''<tshirt>'' amb un fill ''<price>'' 
igual a ''" 25.00 "''. Noteu que s'inclouen els espais. Retorna 

   <title> Staind: Been Awhile Tee Black (1-sided) </title>

També es poden posar condicions per als atributs.

   //description[@xsi:nil="true"]

Retorna:

   <description xsi:nil="true" />
   <description xsi:nil="true" />

Les expressions amb condicions sobre atributs i sobre elements es poden
barrejar especificant-les una al costat de l'altra.

   /catalog/tshirt[./price=" 25.00 "][@code="T1534017"]/title

Retorna:

   <title> Staind: Been Awhile Tee Black (1-sided) </title>

XPath proporciona *funcions* per manipular els resultats obtinguts.
Aquestes permeten: 

- Manipular conjunts de nodes.

   count(//description) 

compta el nombre d'elements ''<description>'' en el document. Després d'afegir un
àlbum el resultat seria ''3''.

- Treballar amb cadenes de caràcters.

   concat("title:",/catalog/album/title[1]/text())

retorna

   "title: It's Been A While "

i

   /catalog/tshirt[starts-with(title," S")]

retorna els elements ''<tshirt>'' amb ''<title>'' que comencen per ''" S"'':

   <tshirt code="T1534017" label=" Staind : Been Awhile "
        xlink:href="http://example.com/0,,1655091,00.html"
        sizes="M L XL">
     <title> Staind: Been Awhile Tee Black (1-sided) </title>
     <description>
       <html:p>
         Lyrics from the hit song 'It's Been Awhile'
         are shown in white, beneath the large
         'Flock &amp; Weld' Staind logo.
       </html:p>
     </description>
     <price> 25.00 </price>
   </tshirt>

- Fer operacions numèriques.

   sum(//price)

indica la suma del contingut dels elements ''<price>''. Retorna ''46.98''.

- Fer operacions booleanes. La *funció not()* es fa servir per negar 
condicions.

   /catalog/album[not(./description=" ")]/title

indica l'element ''<title>'' dels elements ''<album>'' amb un fill 
''<description>'' que no estigui buit. Retorna

   <title> It's Been A While </title>
   <title> Malamente </title>

Per veure un llistat complet de funcions que es poden fer servir 
consultar l'[[http://www.w3.org/TR/xpath-functions|especificació XPath]].