ENTRADA: XPathAPI en flash.
Que es XPath?
XPath es una manera simple para buscar en un documento XML.
Te permite trabajar con documentos XML utilizando nombres en lugar la engorrosa sintaxis de firstChild.childNodes...La clase XPathAPI nor permite simplificar las tareas de busqueda en documentos XML desde Flash, basandonos en nombres de nodos y valores de atributos.
Flash soporta solo una parte de las funcionalidades de XPath, pero suficiente como para ahorrarnos tiempo y dolores de cabeza.
Cómo utilizamos XPath?
Con XPath, nos ahorramos el tiempo de tener que descubrir con que nodos tenemos que trabajar para obtener los datos que queremos, pudiendo trabajar con los nodos como trabajaríamos con paths a documentos.
XPath estaba disponible en Mx2004 pero sin documentación. En Flash 8 existe docuementación, pero sin mucho detalle. Hay un link a livedocs con un pdf que tiene una lista de métodos y ejemplos.
Como utilizar XPath en flash
Hay dos cosas que tenemos que hacer para poder utilizar la clase XPathAPI.
Primero, importar la clase: import mx.xpath.XPathAPI;
Y lo siguiente, tener una instancia de la clase DataBinding (Ventana>Bibliotecas Comunes > Clases) en nuestro documento. Con arrastrar una instancia de la clase al escenario, y luego borrarla es suficiente.
Ya estamos listos para empezar a utilizar la clase.
Métodos de clase
La clase contiene los siguientes métodos:
-
XPathAPI.getEvalString()
- XPathAPI.selectNodeList()
- XPathAPI.selectSingleNode()
- XPathAPI.setNodeValue()
Veremos unos ejemplos de selectNodeList() y selectSingleNode().
XPathAPI.selectNodeList()
Este método devuelve los nodos de un nodo especifico.
Sintaxis:
XPathAPI.selectNodeList(node, path)
Veamos un ejemplo de docuemtnso XML:
-
<!--l version="1.0" encoding="utf-8" standalone="yes-->
-
-
imagen1
-
descripcion1
-
-
imagen2
-
descripcion2
-
-
imagen3
-
descripcion3
-
-
imagen4
-
descripcion4
-
-
imagen5
-
descripcion5
Si queremos conocer el valor de todos los nombres de producto, el path seria
/contenido/datos/nombreProducto y el nodo seria this.firstChild.
En este caso, utilizaríamos selectNodeList así:
XPathAPI.selectNodeList(this.firstChild, "/contenido/datos/nombreProducto");
Esto de devolvería un array con todos los títulos.
Ejemplo:
-
import mx.xpath.XPathAPI;
-
-
var productos_xml:XML = new XML();
-
productos_xml.ignoreWhite = true;
-
-
productos_xml.onLoad = function(cargado:Boolean){
-
if (cargado){
-
// Pedir el nombre de producto del siguietne path /contenido/datos/nombreProducto
-
var Productos_str:String = XPathAPI.selectSingleNode(this.childNodes[0], "/contenido/datos/nombreProducto");
-
var Descripcion_str:String = XPathAPI.selectSingleNode(this.childNodes[0], "/contenido/datos/descripcionProducto");
-
trace("Nombre: "+Productos_str);
-
trace("Descripcion: "+Descripcion_str);
-
}else{
-
trace("error al cargar el documento XML");
-
}
-
};
Este código nos mostraría lo siguiente en la ventana de depuración:
Cargada la imagen1
Cargada la imagen2
Cargada la imagen3
Cargada la imagen4
Cargada la imagen5
XPathAPI.selectSingleNode()
Este método se diferencia del anterior en que solo nos devuelve el valor de un solo nodo, en lugar de un array de nodos como con XPathAPI.selectNodeList.
Sintaxis:
XPathAPI.selectSingleNode(node, path)
Siguiendo el ejemplo anterior, si queremos conseguir el valor del primer node de titulo, el código seria:
-
import mx.xpath.XPathAPI;
-
-
var productos_xml:XML = new XML();
-
productos_xml.ignoreWhite = true;
-
-
productos_xml.onLoad = function(cargado:Boolean){
-
if (cargado){
-
// Pedir el nombre de producto del siguietne path /contenido/datos/nombreProducto
-
var Productos_str:String = XPathAPI.selectSingleNode(this.childNodes[0], "/contenido/datos/nombreProducto");
-
var Descripcion_str:String = XPathAPI.selectSingleNode(this.childNodes[0], "/contenido/datos/descripcionProducto");
-
trace("Nombre: "+Productos_str);
-
trace("Descripcion: "+Descripcion_str);
-
}else{
-
trace("error al cargar el documento XML");
-
}
-
};
El código generaría lo siguiente en la ventana de depuración:
Nombre: imagen1
Descripcion: descripcion1
Podemos utilizar las siguientes expresiones u operadores:
Path absoluto: /contenido/datos/nombreProducto
Ejemplo: var nodoNombre:String = XPathAPI.selectSingleNode(this.firstChild, "/contenido/datos/nombreProducto");
Path relativo : nombreProducto
Ejemplo: var nodoNombre:String = XPathAPI.selectSingleNode(this.firstChild, "nombreProducto");
Asterisco (*) :
"/contenido/*/nombreProducto – nos permite no conocer el nombre de un nodo
Ejemplo: var nodoNombre:String = XPathAPI.selectSingleNode(this.firstChild, "/*/*/nombreProducto");
Predicate expressions using =, AND, or OR :
/contenido/datos/nombreProducto[@fecha]='2006']
o:
/contenido/datos/nombreProducto[@fecha='2004' and @disponible='no']
Ejemplo:
var Productos_ar:Array= XpathAPI.selectNodeList(this.firstChild,"/contenido/datos/nombreProducto[@fecha]='2006']" );
July 2nd, 2006 at 2:32 pm
[…] Teniendo en cuenta algunos factores( AS3, Flash 9 y FLEX) condicionan un poco el uso futuro que se le pueda dar a XLEFF. Aun así, es una idea interesante y además nos introduce la clase XModel. Esta clase similar a Xpath, ambas mejoran las funcionalidades de la clase XML de flash (menos código y más fácil de leer). […]
November 6th, 2007 at 5:40 pm
Predicate expressions using “AND” or “OR” MUST be lowercase (and, or)
August 12th, 2008 at 1:32 pm
you cannot extract node value by using selectSingleNode, just like that… you have to use selectSingleNode then with the returned node use firstChild.nodeValue