Cours sur la programmation DOM en Python
Introduction
DOM, pour Document Object Model, vise à fournir un modèle d'un document semi-structuré, autrement dit d'un document XML. Il s'agit en particulier de définir des méthodes d'accès et de modification opérant sur un tel document.
DOM est défini par des recommandations du W3C, trois niveaux ont aujourd'hui été définis. Certaines parties de ces recommandations sont dédiées au traitement de documents XHTML ; nous nous concentrons ici sur le noyau de DOM fournissant des méthodes valables pour tout document XML.
En pratique, DOM permet de charger un document XML tout entier en mémoire et s'oppose sur ce point à SAX (qui permet de traiter un document XML en une passe, sans occupation mémoire). Au minimum, DOM utilise une zone mémoire de la fichier XML lu ; dans les faits, c'est souvent plus et cela pour se préparer à répondre de manière efficace à des interrogations complexes.
En Python, le programme minimal qui charge un document XML sous forme de DOM est le suivant :
from xml.dom.minidom import parse import sys xmlfilename = sys.argv[1] dom = parse(xmlfilename)
Le modèle DOM reflète la nature arborescente des documents XML : il nous permet d'accéder à la racine ou à des noeuds quelconques, d'obtenir les fils d'un noeud précis, ou encore ses frères. L'implémentation réelle du modèle présent en mémoire après le chargement du document XML est cachée dans un objet et peut varier avec le langage de programmation utilisé. Par contre les méthodes d'accès et de modification de l'arbre DOM sont standardisées par le W3C et sont donc les mêmes d'un langage à l'autre.
Pour terminer, précisons que chaque information présente dans le document d'origine se retrouve en mémoire comme un noeud de l'arbre DOM : les éléments, les attributs, les textes, les commentaires, etc. sont autant de noeuds accessibles dans l'arbre DOM.
Les noeuds du DOM
Nous venons de percevoir le rôle central des noeuds dans DOM, il convient de savoir les manipuler.
Informations sur un noeud
Étant donné un noeud de l'arbre DOM, nous pouvons obtenir son nom, sa valeur et son type.
nodeType | 1 (élément) | 2 (attribut) | 3 (texte) |
nodeName | le nom de la balise | le nom de l'attribut | #text |
nodeValue | non définie | la valeur de l'attribut | le texte du noeud |
Obtenir un noeud
À partir de l'objet DOM, il est possible d'obtenir :
- l'élément racine du document XML à l'aide de documentElement ;
- le noeud élément portant un nom particulier à l'aide de getElementsByTagName.
Si l'on possède déjà un noeud, il est alors possible d'en obtenir d'autres qui lui sont liés dans le document d'origine :
- childNodes : la liste des noeuds fils ;
- parentNode : le père ;
- firstChild : le premier fils ;
- lastChild : le dernier fils ;
- nextSibling : le frère droit ;
- previousSibling : le frère gauche.
À noter que le noeud demandé peut ne pas exister : la racine n'a pas de père, un fils ainé n'a pas de frère gauche, etc. Dans ces cas, en Python, on obtient la valeur None. Si un noeud n'a pas de fils, childNodes renvoie logiquement une liste vide.
Enfin les attributs d'un élément sont accessibles grâce à la méthode attributes (qui fournit donc un ensemble de noeuds de type 2).
Premiers exemples de programmes Python & DOM
Accéder à un fils textuel
from xml.dom.minidom import parse import sys xmlfilename = sys.argv[1] dom = parse(xmlfilename) titres = dom.getElementsByTagName("titre") premier = titres[0] texte = premier.childNodes[0] print texte.nodeValue
Obtenir des attributs
from xml.dom.minidom import parse import sys xmlfilename = sys.argv[1] dom = parse(xmlfilename) sites = dom.getElementsByTagName('site') for site in sites: attrs = site.attributes urlnode = attrs['url'] print urlnode.nodeValue
Lire un fichier plat
from xml.dom.minidom import parse import sys xmlfilename = sys.argv[1] dom = parse(xmlfilename) racine = dom.documentElement; fils = racine.childNodes print 'racine=',racine.nodeName for f in fils: if f.nodeType==1: print f.nodeName,'=',f.childNodes[0].nodeValue
Modifier le DOM
Un nouveau DOM
impl = getDOMImplementation() newdoc = impl.createDocument(None,"laracine",None) top_element = newdoc.documentElement
Définir un noeud ou un attribut
new_element = newdoc.createElement('nomelement') new_element.setAttribute('nomattribut','valeurattribut')
copie = noeud.cloneNode(True) copie.removeAttribute('nomattributasupprimer')
Placer un noeud dans la structure
top_element.appendChild(new_element)
Produire du XML
produire du XML à partir d'un noeud n : n.toxml.
PrettyPrint(newdoc)
Pour aller plus loin...
- Recommandations DOM du W3C ;
- tutoriel du W3 Schools ;
- récapitulatif synthétique de DOM par Benjamin Habegger (format PDF).