QXmlStreamEntityResolver Class

Description détaillée

À utiliser pour indiquer à QXmlStreamReader comment développer les entités non declared in the internal-set of the DTD.

Considérations relatives à la sécurité

Cycles d'entités

Vous devez veiller à éviter que les entités ne forment des cycles, car QXmlStreamReader ne détecte et ne rejette les cycles que dans entities defined in the DTD, et non dans les entités dérivées d’une implémentation de l’interface QXmlStreamEntityResolver.

Il s’agit d’une choix de conception : QXmlStreamReader confie cette tâche à l’implémentation d’un QXmlStreamEntityResolver concret. Pour les mappages statiques, tels que les définitions d’entités XML pour les caractères, cela est garanti de manière triviale ; par conséquent, effectuer un suivi en arrière-plan ne ferait que ralentir le système pour tout le monde.

Les choses se compliquent lorsque vous lisez des définitions d’entités à partir d’une entrée externe, y compris des sources non fiables. Dans ce cas, votre implémentation doit s’assurer que les expansions qu’elle utilise en entrée ne contiennent pas de cycles. Il s’agit d’une opération graphique simple qui peut être implémentée en temps et en espace linéaires et qui peut être effectuée en amont au moment du chargement, de sorte qu’elle n’affecte pas les performances de ` resolveUndeclaredEntity()`.

Limite d’expansion des entités

Pour l'instant, les entités résolues par cette classe ne sont pas prises en compte dans le comptage d'QXmlStreamReader::entityExpansionLimit(). Cela pourrait changer dans les futures versions de Qt.

Pour l’instant, vous devez définir vous-même une limite maximale d’expansion si vous lisez des définitions d’entités à partir d’une source externe. Une fois la détection des cycles effectuée, le calcul du chemin le plus long est une opération simple sur les graphes qui peut être implémentée en temps et en espace linéaires et qui peut être effectuée à l’avance lors du chargement ; elle n’affecte donc pas non plus les performances de la fonction ` resolveUndeclaredEntity()`.