El API JAXP

• Escribir un Sencillo Fichero XML
• Crear el Fichero
• Escribir la Declaración
• Añadir un Comentario
• Definir el Elemento Raíz
• Añadir Atributos a un Elemento
• Añadir Elementos Anidados
• Añadir Texto al Estilo HTML
• Añadir un Elemento Vacío
• El Producto Terminado

Escribir un Sencillo Fichero XML

Empecemos escribiendo una sencilla versión del tipo de dato XML que podríamos usar para una representación de diapositivas. En este ejercicio, usaremos nuestro editor de texto para crear los datos y así familiarizarnos con el formato básico de un fichero XML.

 Crear el Fichero

Usando un editor de textos estándard, creamos un fichero llamado slideSample.xml.

Nota: aquí tienes una versión de: slideSample01.xml.

 Escribir la Declaración

Luego, escribimos la declaración, que identifica el documento como un documento XML. La declaración empieza con los caracteres "<?", que es el identificador estándard XML para una instrucción de procesador

<?xml version='1.0' encoding='us-ascii'?>

Esta línea identifica el documento como un documento XML que está conforme a la versión 1.0 de la especificación XML, y dice que usa el esquema de codificación de caracteres 8-bit US ASCII. Como no se ha especificado como un documento "standalone", el analizador asume que podría contener referencias a otros documentos.

 Añadir un Comentario

Los comentarios son ignorados por los analizadores XML. De echo nunca los veremos, a menos que activemos las selecciones especiales en el analizador.

<?xml version='1.0' encoding='us-ascii'?> 

<!-- A SAMPLE set of slides --> 

 Definir el Elemento Raíz

Después de la declaración, todo documento XML define exactamente un elemento, conocido como el elemento raíz. Cualquier otro elemento del fichero está contenido dentro de este elemento. El texto en negrita de abajo define el elemento raíz de este fichero, slideshow.

 
<?xml version='1.0' encoding='us-ascii'?> 

<!-- A SAMPLE set of slides --> 

<slideshow> 

</slideshow>

 Añadir Atributos a un Elemento

Una presentación de diapositivas tiene un número de ítems de datos asociados, ninguno de los cuales requiere una estructura. Por eso es natural definirlos como atributos del elemento slideshow. Añadimos el texto en negrita de abajo para configurar algunos atributos.

 
... 
<slideshow     
title="Sample Slide Show"     date="Date of publication"     author="Yours Truly"
    >

</slideshow>

Cuando creamos un nombre para una etiqueta o un atributo, podemos usar guiones ("-"), subrayados ("_"), dos puntos (":"), y puntos (".") además de caracteres y números.

Nota: Los dos puntos deben usarse con cuidado o incluso ser evitados, porque se usan para definir el espacio de nombres para un documento XML.

 Añadir Elementos Anidados

XML permite estructuras de árbol, lo que significa que un elemento puede contener otros elementos. Añadimos el texto en negrita de abajo para definir un elemento slide y un elmento title dentro de él.

     
...
<!-- TITLE SLIDE -->     
<slide title="Title of Talk"/>

    <!-- TITLE SLIDE -->
    <slide type="all">
        <title>Wake up to WonderWidgets!</title>
    </slide>

</slideshow>

Aquí también hemos añadido un atributo type a la diapositiva. La idea de este atributo es que está diapositiva podría ser remarcada para una audiencia más técnica o más ejecutiva con type="tech" o type="exec", o identificarla como adaptable para ambos con type="all".

Este ejemplo ilustra la diferencia entre las cosas que son más útiles al definirlas como elementos (el elemento title) y cosas que es mejor definirlas como atributos (el atributo type). El título es algo que verá la audiencia. Por eso es un elemento. Por otro lado, el tipo es algo que nunca se representará, por eso es un atributo. Otra forma de pensar en esta distinción es que un elemento es un contenedor, como una botella. El tipo es una característica del contenedor (es alto o bajo, ancho o estrecho). El título es una característica del contenido (agua, leche o te). Estas no son unas reglas muy rápidas pero nos pueden ayudar cuando diseñemos nuestras propias estructuras XML.

 Añadir Texto al Estilo HTML

Como XML nos permite definir cualquier etiqueta que queramos, tiene sentido definir un conjunto de etiquetas que se parezcan al HTML. El estándard XHTML hace exactamente esto. Por ahora, teclearemos el texto en negrita de abajo para definir un par de listas de entradas que usan etiquetas de estilo HTML <em> para enfatizar el texto.

      
...    
<!-- TITLE SLIDE -->     
    <slide type="all">         
        <title>Wake up to WonderWidgets!</title>     
    </slide>

    <!-- OVERVIEW -->
    <slide type="all">
        <title>Overview</title>
        <item>Why <em>WonderWidgets</em> are great</item>
        <item>Who <em>buys</em> WonderWidgets</item>
    </slide>
    
</slideshow>

Más adelante veremos que definir un elemento title crea un conflicto con el elemento XHTML que usa el mismo nombre. Discutiremos el mecanismo que produce el conflicto (el DTD) y varias posibles soluciones cuando cubramos la sección Analizar el DTD parametrizado.

 Añadir un Elemento Vacío

Una diferencia mayor entre HTML y XML, es que todo el XML debe estar bien formateado -- lo que significa que cada etiqueta debe tener una etiqueta de cierre o debe ser una etiqueta vacía. Ya estamos acostumbrados a las etiquetas de cierre. Añadimos el texto en negrita de abajo para definir una lista de ítems vacía.

      
...
    <!-- OVERVIEW -->   
    <slide type="all">         
        <title>Overview</title>         
        <item>Why 
        <em>WonderWidgets</em> are great</item>         
       <item/>         
       <item>Who 
       <em>buys</em> WonderWidgets</item>     
    </slide>     
</slideshow>

Observa que cualquier elemento puede ser un elemento vacío. Todos toman su etiqueta final con "/>" en lugar de ">". Podríamos hacer lo mismo introduciendo <item></item>, que es su equivalente.

 El Producto Terminado

Aqui tenemos la versión completa del fichero XML.

<?xml version='1.0' encoding='us-ascii'?>

<!--  A SAMPLE set of slides  -->

<slideshow 
    title="Sample Slide Show"
    date="Date of publication"
    author="Yours Truly"
    >

    <!-- TITLE SLIDE -->
    <slide type="all">
        <title>Wake up to WonderWidgets!</title>    
    </slide>

    <!-- OVERVIEW -->
    <slide type="all">
        <title>Overview</title>
        <item>Why <em>WonderWidgets</em> are great</item>
        <item/>
        <item>Who buys <em>WonderWidgets</em> </item>
    </slide>

</slideshow>

Ahora que hemos creado un fichero para trabajar, estamos listos para escribir un programa que use el analziador SAX. Lo haremos en la siguiente sección.