L'interface ContentHandler fournit un ensemble de méthodes permettant de gérer différents événements relatifs à la structure d'un document XML, lors de son analyse.

L'analyse SAX produit des événements spécifiques à chaque fois qu'un objet particulier du document XML est rencontré.

Le document XML est parcouru de haut en bas, c'est à dire, que l'analyseur SAX :

  • atteint le début du document qui déclenche aussitôt la méthode startDocument(),
  • puis continue sur le début d'un élément qui provoque à sont tour l'appel de la méthode startElement(),
  • progresse jusqu'à un texte qui entraîne l'invocation de la méthode characters(),
  • découvre la fin d'un élément et déclenche la méthode endElement(),
  • continue de cette façon jusqu'à atteindre la fin du document, lequel actionne la méthode endDocument().

Cette interface est similaire à l'interface dépréciée DocumentHandler, à l'exception qu'elle est capable de gérer les espaces de noms et sur le compte-rendu des entités ignorées dasn des processeurs non-validants

Méthode
Description
void characters(char[] ch, int start, int length)
reçoit la notification de données textuelles.
void endDocument()
reçoit la notification de fin de document.
void endElement(String uri, String localName, String qName)
reçoit la notification de fin d'un élément.
void endPrefixMapping(String prefix)
reçoit la notification de fin de portée d'un préfixe et d'une adresse URI d'espace de noms.
void ignorableWhitespace(char[] ch, int start, int length)
reçoit la notification d'espaces blancs dans le contenu d'un élément.
void processingInstruction(String target, String data)
reçoit la notification d'instruction de traitement.
void setDocumentLocator(Locator locator)
reçoit un objet Locator fournissant l'emplacement d'un événement du document SAX.
void skippedEntity(String name)
reçoit la notification d'une entité ignorée.
void startDocument()
reçoit la notification de début d'un document.
void startElement(String uri, String localName, String qName, Attributes atts)
reçoit la notification du début d'un élément.
void startPrefixMapping(String prefix, String uri)
reçoit la notification de début de portée d'un préfixe et d'une adresse URI d'espace de noms.