En esta página

Introducción a los espacios de nombres

Algunas partes de la documentación del módulo « Qt XML » dan por hecho que estás familiarizado con los espacios de nombres XML. A continuación te ofrecemos una breve introducción; si ya conoces este tema, pasa directamente a las «Convenciones de la documentación deQt XML ».

Los espacios de nombres son un concepto introducido en XML para permitir un diseño más modular. Gracias a ellos, el software de procesamiento de datos puede resolver fácilmente los conflictos de nomenclatura en los documentos XML.

Considera el siguiente ejemplo:

<document>
<book>
  <title>Practical XML</title>
  <author title="Ms" name="Eris Kallisti"/>
  <chapter>
    <title>A Namespace Called fnord</title>
  </chapter>
</book>
</document>

Aquí encontramos tres usos diferentes del nombre «title». Si deseas procesar este documento, te encontrarás con problemas, ya que cada uno de los títulos debe mostrarse de una manera diferente, aunque tengan el mismo nombre.

La solución sería disponer de algún medio para identificar la primera aparición de «title» como el título de un libro, es decir, utilizar el elemento «title» del espacio de nombres de un libro para distinguirlo, por ejemplo, del título de un capítulo, como se muestra a continuación:

<book:title>Practical XML</book:title>

«book», en este caso, es un prefijo que denota el espacio de nombres.

Antes de poder aplicar un espacio de nombres a los nombres de elementos o atributos, debemos declararlo.

Los espacios de nombres son URI, como http://www.example.com/fnord/book/. Esto no significa que los datos deban estar disponibles en esta dirección; el URI se utiliza simplemente para proporcionar un nombre único.

Los espacios de nombres se declaran de la misma forma que los atributos; en sentido estricto, son atributos. Para que, por ejemplo, http://www.example.com/fnord/ sea el espacio de nombres XML predeterminado del documento ( xmlns), escribimos

xmlns="http://example.com/fnord/"

Para distinguir el espacio de nombres http://www.example.com/fnord/book/ del predeterminado, debemos proporcionarle un prefijo:

xmlns:book="http://example.com/fnord/book/"

Un espacio de nombres declarado de esta forma puede aplicarse a los nombres de elementos y atributos anteponiéndole el prefijo adecuado y el delimitador «:». Ya lo hemos visto con el elemento book:title.

Los nombres de elementos sin prefijo pertenecen al espacio de nombres predeterminado. Esta regla no se aplica a los atributos: un atributo sin prefijo no pertenece en absoluto a ninguno de los espacios de nombres XML declarados. Los atributos siempre pertenecen al espacio de nombres «tradicional» del elemento en el que aparecen. Un espacio de nombres «tradicional» no es un espacio de nombres XML, sino que simplemente significa que todos los nombres de atributos que pertenecen a un mismo elemento deben ser diferentes. Más adelante veremos cómo asignar un espacio de nombres XML a un atributo.

Dado que los atributos sin prefijo no se encuentran en ningún espacio de nombres XML, no hay colisión entre el atributo «title» (que pertenece al elemento «author» ) y, por ejemplo, el elemento «title» dentro de un capítulo.

Aclaremos esto con un ejemplo:

<document xmlns:book = 'http://example.com/fnord/book/'
          xmlns      = 'http://example.com/fnord/' >
<book>
  <book:title>Practical XML</book:title>
  <book:author xmlns:fnord = 'http://example.com/fnord/'
               title="Ms"
               fnord:title="Goddess"
               name="Eris Kallisti"/>
  <chapter>
    <title>A Namespace Called fnord</title>
  </chapter>
</book>
</document>

Dentro del elemento «document», tenemos declarados dos espacios de nombres. El espacio de nombres predeterminado «http://www.example.com/fnord/» se aplica al elemento «book», al elemento «chapter», al elemento «title» correspondiente y, por supuesto, al propio «document ».

Los elementos `book:author ` y ` book:title ` pertenecen al espacio de nombres con el URI http://www.example.com/fnord/book/.

Los dos atributos de «book:author», «title» y «name», no tienen asignado ningún espacio de nombres XML. Solo forman parte del espacio de nombres «tradicional» del elemento «book:author», lo que significa que, por ejemplo, no se permiten dos atributos «title» en «book:author ».

En el ejemplo anterior, eludimos la última regla añadiendo un atributo «title» del espacio de nombres «http://www.example.com/fnord/» al elemento «book:author»: el atributo «fnord:title» procede del espacio de nombres con el prefijo «fnord» que se declara en el elemento «book:author ».

Es evidente que el espacio de nombres fnord tiene el mismo URI de espacio de nombres que el espacio de nombres predeterminado. Entonces, ¿por qué no utilizamos simplemente el espacio de nombres predeterminado que ya habíamos declarado? La respuesta es bastante compleja:

  • los atributos sin prefijo no pertenecen a ningún espacio de nombres XML, ni siquiera al espacio de nombres predeterminado;
  • además, omitir el prefijo provocaría un conflicto entre «title» y «title»;
  • escribirlo como xmlns:title declararía un nuevo espacio de nombres con el prefijo «title», en lugar de aplicar el espacio de nombres xmlns predeterminado.

Con las clases « Qt XML », se puede acceder a los elementos y atributos de dos maneras: bien haciendo referencia a sus nombres calificados, que consisten en el prefijo del espacio de nombres y el nombre «real» (o nombre local ), bien mediante la combinación del nombre local y el URI del espacio de nombres.

Puede encontrar más información sobre los espacios de nombres XML en http://www.w3.org/TR/REC-xml-names/.

Convenciones utilizadas en la documentación de Qt XML

Se utilizan los siguientes términos para distinguir las partes de los nombres en el contexto de los espacios de nombres:

  • El nombre calificado es el nombre tal y como aparece en el documento. (En el ejemplo anterior , «book:title» es un nombre calificado.)
  • Un prefijo de espacio de nombres en un nombre calificado es la parte situada a la izquierda del «:». (book es el prefijo de espacio de nombres en book:title.)
  • La parte local de un nombre (también denominada «nombre local») aparece a la derecha del «:». (Por lo tanto, «title» es la parte local de «book:title»).
  • El URI («Identificador Uniforme de Recursos») del espacio de nombres es un identificador único para un espacio de nombres. Tiene el aspecto de una URL (por ejemplo, http://www.example.com/fnord/ ), pero no requiere que los datos sean accesibles mediante el protocolo indicado en la dirección mencionada.

Los elementos sin «:» (como «chapter» en el ejemplo) no tienen prefijo de espacio de nombres. En este caso, la parte local y el nombre calificado son idénticos (es decir, «chapter»).

Véase también la aplicación «DOM Bookmarks».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.