Introducció a XQuery vid

Introducció a XQuery

• XQuery és un llenguatge estàndard XML enfocat en la selecció i reorganització de dades, transformant estructures XML i retornant-les.
• Aquest llenguatge posa més èmfasi en les dades que en l'estil, a diferència de XSLT, tot i que les estructures generades han de pertànyer a un llenguatge de marcat.

Sintaxi i funcionament bàsic

• Per començar a utilitzar XQuery, es crea un arxiu amb extensió .xqy i es defineix un escenari de transformació en un editor com Oxygen.
• L'escenari ha de referenciar l'arxiu XML d'entrada, especificar el transformador a utilitzar, i indicar si es vol mostrar el resultat directament o desar-lo en un nou document.
• Es pot utilitzar sintaxi XPath lliurement dins d'XQuery, que per defecte genera una sortida en format XML amb la declaració XML inclosa automàticament.

Expressions Flower

• La sentència es basa en expressions Flower.
• Flower és un acrònim dels operadors principals: for, let, where, order i return.
  • for: crea bucles per iterar sobre els resultats d'una cerca.
  • order: ordena els resultats segons un criteri.
  • let: assigna valors a variables.
  • where: inclou condicions en el codi.
  • return: declara què s'ha de mostrar com a resultat de la transformació.

Exemple Pràctic: Transformació XML a XML

• S'itera sobre els elements Partida d'un document XML amb un bucle for.
• Cada Partida es guarda en una variable (per exemple, $partida).
• L'operador return determina què es mostrarà de cada iteració.
• Si no s'especifica un node arrel a la sortida, el resultat pot no ser un XML ben format.

Operador let i variables

• L'operador let permet guardar el nom i la data de cada partida en variables.
• La sintaxi és let $variable := valor.
• Per accedir a un valor dins de la variable, s'utilitza la sintaxi XPath.
• Dins de les etiquetes, quan s'utilitza la sintaxi XQuery es fan servir claus ({}) per separar-la de l'estructura de marcat.

Funció data()

• La funció data()extreu el valor d'un atribut o element, en comptes del node sencer.
• Això és útil quan només interessa el valor d'un atribut, com ara la data formatada.

Condicions amb where

• L'operador where permet filtrar els resultats basant-se en una condició.
• Per exemple, es poden mostrar només les partides que tenen un valor específic en un element determinat.

Transformació XML a HTML

• Quan es vol generar HTML amb XQuery, cal declarar un pròleg per especificar el format de sortida.
• El pròleg inclou la declaració del namespace per a HTML i l'opció de mètode de sortida html.
• Després del pròleg, es defineix l'estructura HTML amb les etiquetes html, head (incloent-hi el títol i l'enllaç al full d'estils CSS) i body.

Generació dinàmica de contingut HTML

• Dins de l'estructura HTML, es poden incloure blocs de codi XQuery per generar contingut dinàmic.
• Per exemple, es pot iterar sobre les partides i generar una taula HTML per a cada una.
• Es poden utilitzar variables per guardar fragments de codi HTML i reutilitzar-los en el bucle.

Comptadors i funcions addicionals

• XQuery permet utilitzar funcions com count() per comptar elements en el document XML.
• Aquestes funcions es poden combinar amb estructures HTML per mostrar informació addicional, com el nombre total de partides.
• Per accedir al número de la iteració, s'usa l'operador at en la declaració del bucle, de manera que es crecaria for $partida at $posició in $partides.