L'interface UserDataHandler représente un gestionnaire d'événements sur des données XML.

Un objet UserDataHandler est chargé de gérer certaines opérations exécutées sur des noeuds, en l'occurrence l'adoption, le clonage, l'importation, le renommage et la suppression.

La méthode setUserData() d'un objet Node permet d'affecter un gestionnaire d'événements au noeud courant.

Lorsque un noeud est associé à un gestionnaire d'événements, l'application peut adopter un comportement spécifique en fonction de l'action produite sur ce noeud.

Il est nécessaire de créer une classe qui implémentera l'interface UserDataHanler et en particulier sa méthode handle() qui sera appelée dès que le noeud subira une des opérations précitées.

Champ
Description
static short NODE_ADOPTED
Le noeud est adopté en utilisant la méthode Document.adoptNode().
static short NODE_CLONED
Le noeud est cloné en utilisant la méthode Node.cloneNode().
static short NODE_DELETED
Le noeud est supprimé.
static short NODE_IMPORTED
Le noeud est importé en utilisant la méthode Document.importNode().
static short NODE_RENAMED
Le noeud est renommé en utilisant la méthode Node.renameNode().
Méthode
Description
void handle(
short operation, String cle, Object donnee, Node source, Node destination)
Cette méthode est appelée à chaque fois que le noeud pour lequel le gestionnaire courant est enregistré, est importé ou cloné.
  • operation : indique le type de l'opération (les champs statiques de cette interface) qui est exécutée sur le noeud.
  • cle : spécifie la clé pour laquelle le gestionnaire est appelé.
  • donnee : définit la donnée pour laquelle le gestionnaire est appelé.
  • source : fournit le noeud copié, adopté, importé, ou renommé. Il est nulle lorsque le noeud est supprimé.
  • destination : correspond au noeud nouvellement créé, s'il existe.