Roberto Gómez Cárdenas Qué es DOM?

Transcripción

1 DOM y PHP Roberto Gómez Cárdenas rogomez@itesm.mx mx/rogomez Lámina 1 Qué es DOM? Document Object Model Especificación de W3C w3 Mecanismo para que desde cualquier lenguaje de programación se pueda manipular un documento XML o HTML Qué hace? Crea una estructura lógica para el documento (llamada árbol nodal ) Proporciona un método para leer y manipular el documento Lámina 2 DOM: PHP y XML 1

2 Lámina 3 DOM Es un modelo independiente de la plataforma y del lenguaje de programación. No esta escrito para ser usado desde d un lenguaje de programación en particular. Proporciona una interfaz (API) al programador para acceder de forma fácil, consistente y homogénea a los elementos, atributos y otros posibles componentes de un documento. Se escribió empleando un lenguaje de definición de interfaz (IDL). Para cada lenguaje de programación existe una traducción de los tipos IDL a tipos del lenguaje. Qué puedo hacer con DOM? Reconstrucción del documento completo a partir del modelo. Proporciona una representación estructurada orientada a objetos, de los elementos individuales y el contenido de una página, con métodos para recuperar y fijar las propiedades de dichos objetos. Proporciona métodos para agregar y eliminar dichos objetos permitiendo crear contenido dinámico. El acceso a cualquiera de las partes del documento. El W3C se encarga de la especificación de DOM. Lámina 4 DOM: PHP y XML 2

3 Lámina 5 Nivel 1 Niveles de especificación DOM Soporte para XML 1.0 y HTML 4.0 Nivel 2 Extiende el nivel 1 con namespaces, soporte para CSS, eventos de interfaz de usuario (ratón), de manipulación de árboles y mejora de los métodos de manipulación de árboles. Nivel 3 Soporte para Xpath, explorar un esquema combinado, más eventos de interfaz de usuario (teclado), Representación DOM DOM genera un árbol jerárquico en memoria del documento o información XML. Este árbol jerárquico de información en memoria permite que a través del parser sea manipulada la información. En el árbol de nodos, cada uno representa un elemento, un atributo, contenido o algún otro objeto. Lámina 6 DOM: PHP y XML 3

4 DOM Document Builder Factory Documento Objeto DOM XML Data Document Builder Objeto Objeto Objeto Objeto Lámina 7 Documentos DOM DOM trata un documento XML (o HTML) como una jerarquía de nodos Distintos nodos y cada uno tiene permitido solo ciertos hijos de ciertos tipos de nodo Existen algunos tipos de nodo que son hoja No pueden tener hijos Lámina 8 DOM: PHP y XML 4

5 Ejemplo DOM <TABLE> <TBODY> <TR> <TD>Shady Grove</TD> <TD>Aeolian</TD> </TR> <TR> <TD>Over the River, Charlie</TD> <TD>Dorian</TD> </TR> </TBODY> </TABLE> Lámina 9 Segundo ejemplo DOM Nodo raíz es <bookstore> Todos los otros nodos del documento se encuentran dentro de <bookstore> El nodo raíz tienen cuatro nodos <book> El primer nodo <book> cuenta con cuatro nodos: <title>, <author>, <year> y <price>, cada uno de los cuales contiene un nodo texto, Every Italian, Giada De Laurentiis, 2005, y Lámina 10 DOM: PHP y XML 5

6 Texto y nodos Un error común en el procesamiento de DOM es esperar que un nodo elemento contenga texto. Sin embargo, el texto de un nodo elemento se almacena en un nodo texto. Ejemplo <year> 2005 </year> El elemento nodo <year>, contiene un nodo con el valor no es el valor del elemento <year> Lámina 11 Elementos, nodos y texto Lámina 12 DOM: PHP y XML 6

7 Parser del documento XML Un parser DOM tiene una interfaz del siguiente estilo: nodoraiz = domparser (documento ) Lee todo el documento completo y devuelve un Document Object. Document, esto es, construye un árbol en memoria que contiene toda la estructura del documento leído. Lámina 13 DOM y PHP Desde PHP 5, la extensión de DOM se encuentra disponible como parte del núcleo de PHP. Para PHP 4 hay que usar DOM XML. Lámina 14 DOM: PHP y XML 7

8 El DOM en PHP Clases principales: DOMDocument: representa el nivel superior de un documento XML (pero no el elemento raíz) DOMException: representa un error producido en el documento XML DOMNode: representa un nodo en el documento XML DOMElement: representa un elemento (etiqueta) DOMAttr: representa un atributo DOMNodeList: representa una lista de nodos DOMNamedNodeMap: representa una lista de nodos que se pueden acceder por un índice o por un nombre (se emplea para representar los atributos) Lámina 15 Jerarquía de las clases DOMNode Exception DOMDocument DOMElement DOMAttr DOMException DOMNodeList DOMNamedNodeMap Lámina 16 DOM: PHP y XML 8

9 Métodos clases Lámina 17 Clase DOMDocument La clase esta diseñada para leer y escribir documentos XML implementando el API de DOM usando funciones PHP XML. La clase permite abrir un documento XML, parsearlo, y permite al desarrollador cambiar cualquier cosa en el documentos, añadir nodos, remover er atributos tos, clonar nodos, insertar hijos, etc. Para cargar un documento se usa el método load. Lámina 18 DOM: PHP y XML 9

10 Algunos métodos DOMDocument Método Descripción load Carga un documento (local o remoto). loadxml Carga un documento a partir de una cadena. save Guarda un documento en un archivo. savexml Guarda un documento en una cadena. schemavalidate Valida un documento contra su esquema. validate Valida un documento contra su DTD getelementsby TagName Busca por elementos con un determinado nombre de etiqueta Lámina 19 El archivo canciones.xml <?xml version="1.0"?> <canciones> <cancion genero="ranchera"> <titulo>no volvere </titulo> <cantante>pedro Infante </cantante> <album>exitos </album> </cancion> <cancion genero="jazz"> <titulo>east of the sun </titulo> <cantante>diana Krall</cantante> <album>live at Teatro Grand Rex</album> <cancion genero="altenativa"> <titulo>come away with me </titulo> <cantante>nora Jones</cantante> <album>community </album> </cancion> </canciones> </cancion> Lámina 20 DOM: PHP y XML 10

11 Lectura documento XML <?php $datos = new DOMDocument(); $datos->load("canciones.xml"); echo "<pre>\n"; echo "Contenido a nivel texto:\n"; echo htmlspecialchars($datos->textcontent); echo "Contenido XML\n"; echo htmlspecialchars($datos->savexml()); echo "</pre>";?> Lámina 21 Métodos y propiedades DOMNodeList Algunas propiedades o métodos devuelven una lista de nodos: childnodes, getelementsbytagname Propiedades: length: indica el número de nodos en la lista (colección) Métodos: item: permite un acceso aleatorio a nodos de la lista (desde 0 hasta length - 1) Lámina 22 DOM: PHP y XML 11

12 Ejemplo <?php $datos = new DOMDocument(); $datos->load("canciones.xml"); echo "<pre>\n"; echo "Contenido a nivel texto:\n"; echo htmlspecialchars($datos->textcontent); echo "Contenido XML\n"; echo htmlspecialchars($datos->savexml()); echo "</pre>"; echo "<html>"; echo "<body>"; $n=$datos->getelementsbytagname("cancion")->length; echo "Hay $n canciones en el archivo "; echo "</body>"; echo "</html>";?> Lámina 23 Métodos creación Método createtextnode createelement setattribute appendchild Descripción Crea una instancia de la clase DOMText. El nodo no El nodo no se mostrará en el documento a menos que sea insertado. Crea una nueva instancia de la clase DOMElement. El nodo no se mostrará en el documento a menos que sea insertado. Asigna un valor a un atributo. Si el atributo no existe, este es creado. Añade un hijo al final de una lista de hijos o crea una nueva lista. Lámina 24 DOM: PHP y XML 12

13 Propiedades DOMDocument Propiedad doctype documentelement documenturl textcontent validateonparse formatoutput Descripción Contiene el DOCTYPE El elemento raíz del documento La ubicación del documento Contenido textual del documento Indica si se tiene que validar el documento durante la carga Formatea la salida bonita con sangría y espacios en blanco extra Lámina 25 Sintaxis Creación elemento class DOMDocument { DOMElement createelement ( string name [, string value] ) } name: el nombre de la etiqueta del elemento value: el valor del elemento, por default un elemento vacío será creado Regresa una nueva instancia de clase DOMElement o FALSE si courrión algún error. Añadir un hijo class DOMNode { DOMNode appendchild ( DOMNode newnode ) } ewnode : el hijo a añadir El nodo añadido Lámina 26 DOM: PHP y XML 13

14 Sintaxis Asignación atributo class DOMElement { bool setattribute ( string name, string value ) } name: el nombre del atributo value: el valor del atributo Regresa TRUE en caso de éxito o FALSE en caso de falla. Creación texto nodo class DOMDocument { DOMText createtextnode ( string content ) } content: el contenido del texto Regresa el nuevo DOMText o FALSE si ocurrió algún error Lámina 27 Ejemplo creacion <?php $doc = new domdocument("1.0","iso "); $doc->formatoutput = 1; $raiz = $doc->createelement( >createelement('alumnos'); $rama = $doc->createelement('alumno'); $rama->setattribute('semestre', '6'); $hoja = $doc->createelement('nombre'); $hoja->appendchild($doc->createtextnode('ulises Garrido')); $rama->appendchild($hoja); appendchild($hoja); Lámina 28 $hoja = $doc->createelement('matricula'); $hoja->appendchild($doc->createtextnode('445566')); $rama->appendchild($hoja); : : : DOM: PHP y XML 14

15 Ejemplo creacion?> : : : $hoja = $doc->createelement('carrera'); $hoja->appendchild($doc->createtextnode('ise')); $rama->appendchild($hoja); $raiz->appendchild($rama); $doc->appendchild($raiz); echo $doc->savexml(); Lámina 29 Salida del ejemplo $ php creaalumno.php <?xml version="1.0" encoding="iso "?> <Alumnos> <Alumno Semestre="6"> <Nombre>Ulises Garrido</Nombre> <Matricula>445566</Matricula> <Carrera>ISE</Carrera> </Alumno> </Alumnos> $ Lámina 30 DOM: PHP y XML 15