/* Copiamos el contenido del fichero de la Query
      * en una variable interna
      */
     string sQuery = String.Empty;

     /* Creamos el flujo */
     StreamReader sr = new StreamReader(query);
     /* Leemos el contenido y lo almacenamos */
     sQuery = sr.ReadToEnd();
     /* Cerramos el flujo */
     sr.Close();

El siguiente paso será compilar la query que acabamos de leer para ver si su sintaxis es correcta. Para ello creamos un objeto de la clase XQueryExpression, pasándole como parámetro la variable que almacena el contenido del fichero de la Query:

/* Compilamos la Query */
XQueryExpression expr = new XQueryExpression(sQuery);

Por último, ejecutamos la query y mostramos lo resultados en un fichero Xml. Debemos importar otro paquete (System.Diagnostics) para poder abrir el fichero Xml con los resultados:

using System;
using Microsoft.Xml.XQuery;
using System.IO;
using System.Diagnostics;				

/* Ejecutamos la query y mostramos los resultados */
	Console.WriteLine("Ejecutando consulta XQuery...");
	StreamWriter sw = new StreamWriter("resultados.xml",false,System.Text.Encoding.UTF8);
	sw.WriteLine("<?xml version='1.0'?>" + (expr.Execute(xqNav)).ToXml());
	sw.Close();
	/* Abrimos el fichero con los resultados */
	Process.Start("explorer.exe", "resultados.xml");
	}
	catch (Exception ex)
	{
		Console.WriteLine("Se ha producido un error: " + ex.Message);
		Console.Read();
	}
}
}
}

Con esto nuestro programa quedaría finalizado, aunque si queremos atrapar las posibles excepciones que se puedan producir y no termine de manera anormal nuestro programa, recomiendo englobar todas las instrucciones dentro de un try catch. A continuación se muestra el código completo del programa:

using System;
using Microsoft.Xml.XQuery;
using System.IO;
using System.Diagnostics;

namespace execQuery
{

	class Class1
	{
		[STAThread]
		static void Main(string[] args)
		{
			try
			{
				Console.WriteLine("Control de ejecuci�n de consultas XQuery ");
				Console.WriteLine("---------------------------------------- ");
				Console.WriteLine("");
				Console.Write("Fichero Xml: ");
				string fileName = Console.ReadLine();
				string alias =  "aliasXml";  
				Console.Write("Fichero Query: ");     
				string query = Console.ReadLine();
    
				/* Creamos la colecci�n */
				XQueryNavigatorCollection xqNav = new XQueryNavigatorCollection();  
                      
				/* A�adimos el archivo Xml a la colecci�n.
				 * El fichero Xml ser� referenciado en la query por el alias
				 */ 
				xqNav.AddNavigator(fileName, alias );                                   

				/* Copiamos el contenido del fichero de la Query
				 * en una variable interna
				 */
				string sQuery = String.Empty;

				/* Creamos el flujo */
				StreamReader sr = new StreamReader(query);
				/* Leemos el contenido y lo almacenamos */
				sQuery = sr.ReadToEnd();
				/* Cerramos el flujo */
				sr.Close();
			
				/* Compilamos la Query */
				XQueryExpression expr = new XQueryExpression(sQuery);

				/* Ejecutamos la query y mostramos los resultados */
				Console.WriteLine("Ejecutando consulta XQuery...");
				StreamWriter sw = new StreamWriter("resultados.xml",
					false,
					System.Text.Encoding.UTF8);
				sw.WriteLine("<?xml version='1.0'?>" + (expr.Execute(xqNav)).ToXml());
				sw.Close();
				/* Abrimos el fichero con los resultados */
				Process.Start("explorer.exe", "resultados.xml");
			}
			catch (Exception ex)
			{
				Console.WriteLine("Se ha producido un error: " + ex.Message);
				Console.Read();
			}
		}
	}
}

Vamos a compilar nuestro programa. Pinchamos en el menú Bulid à Build execQuery

Figura 8

En la ventana Output nos aparecerá un detalle de la compilación de nuestro programa. En el caso de que no se produzcan errores, la pantalla deberá aparecer con la siguiente información:

Figura 9 

En caso contrario nos indicará los errores que se han producido, los corregiremos y volveremos a ejecutar el paso anterior.

El fichero Xml.

Para poder ejecutar nuestro programa nos falta diseñar el fichero Xml y alguna que otra query para comprobar que nuestro programa funciona correctamente. El fichero Xml almacenará información sobre los vuelos que se realizan al cabo de un día en un aeropuerto. El fichero se llamará aeropuerto.xml y tendrá la siguiente información:

Un poco de XQuery.

Vamos a ver una pequeña introducción sobre el uso de XQuery básico, puesto que es un lenguaje muy extenso. Para conocer más a fondo este lenguaje, podemos leer documentación sobre XQuery en la página http://www.w3.org/TR/xquery/.

Vamos a ver las expresiones básicas para poder realizar consultas sobre nuestro fichero Xml:

Expresiones FLWR:

Una expresión de XQuery puede ser una expresión de XPath simple,pero los usuarios necesitan consultas más complejas para poder obtener una serie de resultados que XPath no permite.

Las consultas XQuery se forman a partir de cuatro palabras clave: FOR, LET, WHERE y RETURN. En las palabras clave de XQuery no se distinguen mayúsculasde minúsculas:

• FOR:

            Se emplea para recorrer todos los datos mediante una o varias variables asociadas con expresiones. 
            Las expresiones pueden ser referencias de ruta u otras expresiones XML legitimas.
            La siguiente instrucción recorre todos los nodos lineaDetalle del documento:
                         FOR $b IN document(“aliasXml”)/aeropuerto/lineadetalle

• LET:

            También puede utilizar la cláusula LET para enlazar variables. Sin embargo, a diferencia de la cláusula FOR,
            no itera. Por tanto, enlaza una variable con un valor individual de la expresión.

            La siguiente instrucción almacena en la variable $a los valoresde la lineaDetalle

                        LET $a := document("aliasXml")/aeropuerto/lineadetalle

• WHERE:

           Es similar a la cláusula WHERE de SQL. Filtra los datos y determina cuales cumplen la condición.
           La siguiente mostraría los nodos cuya compañía sea IBERIA
                       FOR $b IN document(“aliasXml”)/aeropuerto/lineadetalle
                       WHERE $b/@compania = “IBERIA"

• RETURN:

          Genera el resultado de la expresión FLWR y pueden ser valores o un patrón de nodos. Adicionalmente puede calificarse más mediante constructores de elementos, ordenación, cálculos o comparaciones. Un constructor de elementos es un elemento XML que se representa así mismo y permite generar nuevos elementos desde dentro de la consulta
          Para mostrar el resultado de la instrucción anterior en un nuevo fichero XML podríamos utilizar la siguiente query

                 <resultados>
                     {
                               FOR $b IN document(“aliasXml”)/aeropuerto/lineadetalle
                               WHERE $b/@compania = “IBERIA”
                               RETURN
                               <resul>
                                       { $b/hora_salida }
                                       { $b/destino }
                               </resul>
                     }
                     </resultados>

Las expresiones FLWR se procesan en un orden determinado. Primero se procesan las cláusulas FOR o LET, a continuación se procesan las cláusulas WHERE y, después, las clausulas RETURN.

Para profundizar en el lenguaje de consulta Xquery os recomiendo estas direcciones:

• http://www.w3.org/TR/xquery/

• http://www.xquery.com/

Creación de las Queries para nuestra aplicación.

La extensión de los ficheros que contienen instrucciones de XQuery es nombrequery.XQU.

Una vez visto una visión global sobre Xquery, vamos a realizar 3 consultas para procesar en nuestro programa.

1. Mostrar toda la información de los vuelos del fichero:

<resultados>
{
     FOR $b IN document("aliasXml")/aeropuerto/lineadetalle
     RETURN
     <resul>
         { $b/@compania }
         { $b/@nvuelo }
         { $b/@matricula
         { $b/@pasajeros }
         { $b/hora_salida }
         { $b/destino }
     </resul>
}
</resultados>
 
 
Lo guardamos en el directorio donde se encuentra el ejecutable (Debug/bin), con el nombre 1.xqu

Resultados

2. Mostrar la hora de salida y el destino de los vuelos que tengan un nº de pasajeros mayor que 100 y menor que 200:

<resultados>
{
    
    
    
    
     FOR $b IN document("aliasXml")/aeropuerto/lineadetalle
         
         
         
         
          WHERE $b/@pasajeros > "100" AND $b/@pasajeros < "200"
    
    
    
    
     RETURN
          <resul>
        
        
        
        
         { $b/hora_salida }
                  { $b/destino }
    
    
    
    
     </resul>
}
</resultados>

Lo guardamos en el directorio donde se encuentra el ejecutable (Debug/bin), con el nombre 2.xqu.

Resultado:

3. Mostrar el nº de aviones, media de pasajeros entre los aviones, nº máximo y mínimo de pasajeros de todos los vuelos:

<resultados>
{
    
    
    
    
     LET $a := document("aliasXml")/aeropuerto/lineadetalle
     
     
     
     
                             RETURN
    
    
    
    
     <countpas>
               
               
               
               
                { count($a/@pasajeros) }
    
    
    
    
     </countpas>
         
         
         
         
          <avgpas>
       
       
       
       
        { avg($a/@pasajeros) }
          </avgpas>
          <maxpas>
                { max($a/@pasajeros) }
          </maxpas>
          <minpas>
                { min($a/@pasajeros) }
          </minpas>
}
</resultados>

Lo guardamos en el directorio donde se encuentra el ejecutable (Debug/bin), con el nombre 3.xqu.

Resultados:

Prueba del proyecto.

Una vez creadas las Queries es hora de probar si nuestra aplicación funciona correctamente. Es imprescindible que las queries y el fichero XML estén en el directorio bin de nuestro proyecto. Pulsamos F5 (Debug à Start) desde Visual Studio .NET y nuestra aplicación arrancará, mostrando la siguiente ventana:

Figura 10

Introducimos el nombre del fichero XML y pulsamos intro

Figura 11

El nombre de la query que queremos procesar y pulsamos intro

Figura 12

A continuación nos aparecerá un fichero XML con los resultados la query. En el caso de producirse algún error, la aplicación nos informará con un mensaje por pantalla.

Conclusión:

Espero que este pequeño artículo haya valido al lector para comprender lo poderoso que puede llegar a ser este lenguaje de consulta de datos y para que se haya familiarizado con su estructura y su uso junto con Visual Studio .NET.

Bibliografía.

Presentando XQuery en sociedad Por Mariano Minoli

MSDN de Microsoft.

Fichero con el c�digo de ejemplo: luis_XQuery.zip - 74.8 KB