Ver el código de «Linguaxes de consulta e manipulación»

=Introdución a XQuery=
XQuery é unha linguaxe de consulta de datos en formato XML, non só para ficheiros, senón tamén para bases de datos. É a XML o que o SQL é ás bases de datos relacionais. 

Como linguaxe de consulta permite atopar e extraer elementos e atributos dende ficheiros ou BBDD XML. Un exemplo de consulta en XQuery podería ser a seguinte:

"Selecciona todos os rexistros cun prezo menor de 10€ na miña colección de CD almacenada nun documento XML chamado cd_catalog.xml".

XQuery 1.0 e [[Linguaxe_de_navegaci%C3%B3n_no_documento_XML|XPath]] 2.0 comparten o mesmo modelo de datos, funcións e operadores. De feito, XQuery converteuse nunha recomendación do W3C dende o ano 2007 e, por tanto, é compatible con outras tecnoloxías XML como os espazos de nome, XSLT, XPath, e XML Schema.

O uso de XQuery está amplamente estendido. Algunhas aplicacións concretas desta tecnoloxía son as seguintes:
*Extracción de información para usar nos [[Transmisi%C3%B3n_de_informaci%C3%B3n_mediante_linguaxes_de_marcas servizos| servizos web]].
*Xeración de informes, en especial, extractos de documentos a partir de orixinais.
*Transformación de XML en XHTML, conxuntamente con XSLT.
*Busca de información de interese nos documentos web.
=Selección de nodos=
XQuery emprega '''funcións''' para extraer datos dos documentos XML. Por exemplo, a función doc() úsase para abrir un ficheiro XML:
<source lang="XML">
doc("books.xml")
</source>
As '''expresións XPath''' úsanse para navegar polos elementos do documento XML. Por exemplo, o seguinte ficheiro contén datos sobre libros:
<source lang="XML">
<?xml version="1.0" encoding="ISO-8859-1"?>

<bookstore>

<book category="COOKING">
  <title lang="en">Everyday Italian</title>
  <author>Giada De Laurentiis</author>
  <year>2005</year>
  <price>30.00</price>
</book>

<book category="CHILDREN">
  <title lang="en">Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>

<book category="WEB">
  <title lang="en">XQuery Kick Start</title>
  <author>James McGovern</author>
  <author>Per Bothner</author>
  <author>Kurt Cagle</author>
  <author>James Linn</author>
  <author>Vaidyanathan Nagarajan</author>
  <year>2003</year>
  <price>49.99</price>
</book>

<book category="WEB">
  <title lang="en">Learning XML</title>
  <author>Erik T. Ray</author>
  <year>2003</year>
  <price>39.95</price>
</book>

</bookstore>
</source>

A seguinte expresión XPath úsase para seleccionar todos os elementos title:
<source lang="xml">
doc("books.xml")/bookstore/book/title
</source>
(/bookstore selecciona o elemento bookstore; /book selecciona todos os elementos book fillos do elemento bookstore e /title selecciona todos os elementos title fillos de cada elemento book)

A consulta anterior devolverá o seguinte:
<source lang="xml">
<title lang="en">Everyday Italian</title>
<title lang="en">Harry Potter</title>
<title lang="en">XQuery Kick Start</title>
<title lang="en">Learning XML</title>
</source>

XQuery usa '''predicados''' para limitar os resultados da consulta. No seguinte exemplo selecciónanse todos os elementos book baixo o elemento bookstore que teñen un prezo menor que 30:
<source lang="xml">
doc("books.xml")/bookstore/book[price<30]
</source>
O resultado da consulta XQuery anterior será o seguinte:
<source lang="xml">
<book category="CHILDREN">
  <title lang="en">Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>
</source>

=Expresións FLWOR=
Tamén se poden seleccionar nodos mediante expresións FLWOR. Por exemplo, a seguinte expresión XPath selecciona todos os elementos title baixo os elementos book que están baixo o elemento bookstore e que teñen un prezo maior que 30:
<source lang="xml">
doc("books.xml")/bookstore/book[price>30]/title
</source>

A seguinte expresión FLWOR fará exactamente o mesmo que a expresión XPath anterior:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book
where $x/price>30
return $x/title
</source>
O resultado será:
<source lang="xml">
<title lang="en">XQuery Kick Start</title>
<title lang="en">Learning XML</title>
</source>
As expresións FLWOR son máis potentes que as expresións XPath. Por exemplo, podemos ordenar o resultado:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book
where $x/price>30
order by $x/title
return $x/title
</source>

FLWOR é o acrónimo de FLWOR "For, Let, Where, Order by, Return":
*A cláusula '''for''' permite gardar todos os elemento book baixo o elemento bookstore nunha variable chamada $x.
*A cláusula '''where''' selecciona só os elementos book cun elemento prezo maior que 30.
*A cláusula '''order by''' especifica como se ten que ordenar o resultado. Neste caso ordenarase polo elemento title.
*A cláusula '''return''' especifica que se ten que devolver. Neste caso o resultado será o elemento title.

O resultado da expresión XQuery anterior será:
<source lang="xml">
<title lang="en">Learning XML</title>
<title lang="en">XQuery Kick Start</title>
</source>
==For==
A cláusula '''for''' permite almacenar nunha variable cada elemento devolto pola expresión '''in'''. É unha estrutura de programación repetitiva ou iterativa. Pode haber múltiples cláusulas for na mesma expresión FLWOR.

Para iterar un número específico de veces hai que usar a palabra reservada to:
<source lang="xml">
for $x in (1 to 5)
return <test>{$x}</test>
</source>
O resultado será o seguinte:
<source lang="xml">
<test>1</test>
<test>2</test>
<test>3</test>
<test>4</test>
<test>5</test>
</source>

A palabra reservada '''at''' úsase para almacenar o número de iteración:
<source lang="xml">
for $x at $i in doc("books.xml")/bookstore/book/title
return <book>{$i}. {data($x)}</book>
</source>

O resultado:
<source lang="xml">
<book>1. Everyday Italian</book>
<book>2. Harry Potter</book>
<book>3. XQuery Kick Start</book>
<book>4. Learning XML</book>
</source>

Tamén está permitido máis dunha expresión in na cláusula for. Neste caso úsanse comas para separar cada unha:
<source lang="xml">
for $x in (10,20), $y in (100,200)
return <test>x={$x} and y={$y}</test>
</source>
O resultado:
<source lang="xml">
<test>x=10 and y=100</test>
<test>x=10 and y=200</test>
<test>x=20 and y=100</test>
<test>x=20 and y=200</test>
</source>

==Let==
A cláusula '''let''' permite declarar variables e evita repetir a mesma expresión varias veces.
<source lang="xml">
let $x := (1 to 5)
return <test>{$x}</test>
</source>
O resultado:
<source lang="xml">
<test>1 2 3 4 5</test>
</source>

==Where==
A cláusula '''where''' úsase para especificar un ou máis criterios para o resultado:
<source lang="xml">
where $x/price>30 and $x/price<100
</source>

==Order by==
A cláusula '''order by''' úsase para especificar como se ordena o resultado. No seguinte exemplo ordenamos por categoría e título:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book
order by $x/@category, $x/title
return $x/title
</source>
O resultado:
<source lang="xml">
<title lang="en">Harry Potter</title>
<title lang="en">Everyday Italian</title>
<title lang="en">Learning XML</title>
<title lang="en">XQuery Kick Start</title>
</source>

==Return==
A cláusula '''return''' especifica que é o que se quere devolver:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book
return $x/title
</source>

O resultado:
<source lang="xml">
<title lang="en">Everyday Italian</title>
<title lang="en">Harry Potter</title>
<title lang="en">XQuery Kick Start</title>
<title lang="en">Learning XML</title>
</source>

=XQuery e HTML=
A seguinte expresión FLWOR de XQuery seleccionará todos os elementos title baixo elementos book que estean baixo elementos bookstore e devolverá os títulos ordenados alfabeticamente:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book/title
order by $x
return $x
</source>

Se quixéramos representalos mediante unha lista en HTML poderíamos engadir as etiquetas &lt;ul> e  &lt;li> tal e como se amosa no seguinte exemplo:
<source lang="xml">
<ul>
{
for $x in doc("books.xml")/bookstore/book/title
order by $x
return <li>{$x}</li>
}
</ul>
</source>
O resultado será o seguinte:
<source lang="html4strict">
<ul>
<li><title lang="en">Everyday Italian</title></li>
<li><title lang="en">Harry Potter</title></li>
<li><title lang="en">Learning XML</title></li>
<li><title lang="en">XQuery Kick Start</title></li>
</ul>
</source>

Se o que queremos é eliminar o elemento title e mostrar só os datos faríamos o seguinte:
<source lang="html4strict">
<ul>
{
for $x in doc("books.xml")/bookstore/book/title
order by $x
return <li>{data($x)}</li>
}
</ul>
</source>

E o resultado será unha lista HTML:
<source lang="html4strict">
<ul>
<li>Everyday Italian</li>
<li>Harry Potter</li>
<li>Learning XML</li>
<li>XQuery Kick Start</li>
</ul>
</source>
==Engadir atributos ao HTML==
Tamén é posible engadir atributos de elementos XML como atributos nunha lista HTML. No seguinte exemplo, úsase o atributo category como un atributo class da lista HTML:
<source lang="html4strict">
<html>
<body>

<h1>Bookstore</h1>

<ul>
{
for $x in doc("books.xml")/bookstore/book
order by $x/title
return <li class="{data($x/@category)}">{data($x/title)}</li>
}
</ul>

</body>
</html>
</source>
O resultado será o seguinte:
<source lang="html4strict">
<html>
<body>
<h1>Bookstore</h1>

<ul>
<li class="COOKING">Everyday Italian</li>
<li class="CHILDREN">Harry Potter</li>
<li class="WEB">Learning XML</li>
<li class="WEB">XQuery Kick Start</li>
</ul>

</body>
</html>
</source>

=Terminoloxía=
XQuery usa a [[Linguaxe_de_navegaci%C3%B3n_no_documento_XML#Nodos_XPath|terminoloxía de XPath]]. Por tanto, os conceptos de nodo fillo, ancestros, etc. son iguais que en XPath.

=Sintaxe=
==Regras sintácticas de XQuery==
As regras básicas de sintaxe son as seguintes:
*Distínguese entre maiúsculas de minúsculas.
*Os elementos, atributos e variables deben ser nomes XML válidos.
*As cadeas poden ir entre comiñas simples ou dobres.
*As variables están definidas mediante o símbolo $ seguida polo nome, ie: $bookstore
*Os comentarios están delimitados por (: e :), por exemplo: (: Comentario XQuery :)

==Expresións condicionais==
Pódense usar expresións condicionais do tipo "If-Then-Else". Por exemplo:
<source lang="xml">
for $x in doc("books.xml")/bookstore/book
return if ($x/@category="CHILDREN")
then <child>{data($x/title)}</child>
else <adult>{data($x/title)}</adult>
</source>
É obrigatorio usar parénteses na expresión if. A palabra reservada else é obrigatoria pero pode estar baleira. Isto indicarémolo mediante else ().

O resultado do exemplo de enriba será:
<source lang="xml">
<adult>Everyday Italian</adult>
<child>Harry Potter</child>
<adult>Learning XML</adult>
<adult>XQuery Kick Start</adult>
</source>
==Comparacións==
Hai dúas formas de comparar valores:
#'''Comparacións xerais''': =, !=, <, <=, >, >=
#'''Comparacións de valor''': eq, ne, lt, le, gt, ge

Vexamos a diferenza cun exemplo. A seguinte expresión devolve verdadeiro se algún atributo q ten un valor maior que 10:
<source lang="xml">
$bookstore//book/@q > 10
</source>

A seguinte expresión devolve verdadeiro se hai só un atributo q devolto pola expresión XPath e o seu valor e maior que 10. Se se devolve máis dun atributo q prodúcese un erro:
<source lang="xml">
$bookstore//book/@q gt 10
</source>
=Funcións=
XQuery 1.0, XPath 2.0, e XSLT 2.0 comparten a mesma biblioteca de funcións predefinidas (máis de 100). Hai funcións para manexar cadeas, números, datas e tempo, manipulación de nodos e secuencias, valores boolean, etc. Tamén é posible definir funcións propias que se axusten ás nosas necesidades.

O URI do espazo de nomes das funcións XQuery é http://www.w3.org/2005/02/xpath-functions. O prefixo por defecto é '''fn:'''.

Para chamar a unha función úsase o prefixo fn: por exemplo, fn:string(). Con todo, xa que fn: é o prefixo por defecto do espazo de nomes os nomes das funcións non precisan o prefixo cando se chaman..

Pódese [http://www.w3schools.com/xpath/xpath_functions.asp consultar a  referencia] completa das funcións predefinidas de XQuery.

Vexamos algúns exemplos:

'''Exemplo 1:'''
<source lang="xml">
<name>{uppercase($booktitle)}</name>
</source>

'''Exemplo 2:'''
<source lang="xml">
doc("books.xml")/bookstore/book[substring(title,1,5)='Harry']
</source>

'''Exemplo 3:'''
<source lang="xml">
let $name := (substring($booktitle,1,4))
</source>
==Funcións definidas polo usuario==
Para definir unha función empregamos a seguinte sintaxe:
<source lang="xml">
declare function prefix:function_name($parameter AS datatype)
AS returnDatatype
{
 ...código da función...
}
</source>
Cando se declara unha función hai que ter en conta o seguinte:
*Hai que usar a palabra reservada '''declare'''.
*O nome da función debe ter un prefixo.
*Os tipos de datos dos parámetros son os mesmos que os definidos nos esquemas XML.
*O corpo da función debe ir entre chaves.

Vexamos un exemplo:
<source lang="xml">
declare function local:minPrice($p as xs:decimal?,$d as xs:decimal?)
AS xs:decimal?
{
let $disc := ($p * $d) div 100
return ($p - $disc)
}
</source>
Pódese chamar á función anterior do seguinte xeito:
<source lang="xml">
<minPrice>{local:minPrice($book/price,$book/discount)}</minPrice>
</source>

== Ejemplos de ficheros XML ==

[[Archivo:bib.xml]]

=Referencias=
Os contidos deste apartado están baseados no material sobre XQuery do sitio web http://www.w3schools.com.